PH41151: CSQUTIL SDEFS INCORRECTLY CREATES DEFINE QALIAS COMMAND WITH TARGTYPE(QMGR)

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• CSQUTIL SDEFS incorrectly creates DEFINE QALIAS command with
  TARGTYPE(QMGR) for queue alias created when very old
  version/release of MQ was in use.
  
  The queue alias object has a target type (mqao.sTargType) of
  queue (0000) in the page set zero.
  
  This is an old, now unused value for the target type. For a
  zero value, issuing a display command for the queue will update
  the in-memory copy of the object to have a target type of
  queue, but the zero value on page set zero will persist.
  
  The zero value results in CSQUTIL SDEFS processing incorrectly
  indexing an array of valid target types. The result of this is
  that it will create a MAKEDEF with TARGTYPE(QMGR).
  

Local fix

• Update the queue alias object on page set zero by alter each
  queue alias which has this problem. It is enough to alter a
  character in the description.
  
  Another option is using the MAKEDEF output from a DISPLAY
  QALIAS(*) ALL command, since that will always contain the
  correct value for TARGTYPE.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
  *                 Release 1 Modification 0 and Release 2       *
  *                 Modification 0.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: The CSQUTIL SDEFS utility incorrectly   *
  *                      creates the DEFINE QALIAS with TARGTYPE *
  *                      (QMGR) for old queue alias which have   *
  *                      a target type of 0 in the page set      *
  *                      zero.                                   *
  ****************************************************************
  The code that handles the CSQUTIL SDEFS processing incorrectly
  indexed an array of valid target types, creating an incorrect
  output of TARGTYPE(QMGR).
  

Problem conclusion

• The code has been changed to handle a target type of 0 and
  create an output of TARGTYPE(QUEUE).
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UI78105 UI78106

Modules/Macros

• CSQUDEFS
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R100 PSY UI78106

     UP21/12/11 P F112

• R200 PSY UI78105

     UP21/12/11 P F112

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.