PM97157: PCF COMMAND 'CREATE SUBSCRIPTION' RETURNS MQRCC=3312 ON DISTRIBUTED AND MQRC=2085 ON Z/OS QUEUE MANAGER.

APAR status

• Closed as documentation error.

Error description

• Application issues PCF command 'Create Subscription' to a
  distributed queue and a mainframe queue manager. If the
  topic doesn't exist, MQRCCF 3312 is returned from the
  distributed queue manager and MQRC 2085 from the mainframe
  queue manager.
  
  z/OS does not return PCF MQRCCF codes. This APAR is raised
  to investigate how to resolve this issue.
  

Local fix

• Code the applications to expect the two return codes
  In this case MQRCCF=3312 and MQRC=2085.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of WebSphere MQ Version 7          *
  *                 Release 0 Modification 1 and                 *
  *                 Release 1 Modification 0.                    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  In z/OS, PCF commands return reason code
  MQRC_UNKNOWN_OBJECT_NAME (2085) instead of
  MQRCCF_UNKNOWN_OBJECT_NAME (3312) used in Unix, Linux or
  Windows.
  

Problem conclusion

• =========== DOC changes to Administration Reference ===========
  Apply the following updates to page "How the definitions
  are shown" in MQ V710 and V701 Infocenter topic "pc10610_"
  located on the following path:
  
  > WebSphere MQ
  >> Reference
  >>> Administration reference
  >>>> Programmable command formats reference
  >>>>> Definitions of PCFs
  >>>>>> How the definitions are shown
  
  Add the following as first paragraph in section "Error codes":
  "
  In z/OS, PCF commands can return MQRC reason codes instead of
  MQRCCF codes used in UNIX, Linux or Windows.
  "
  In section "Error codes applicable to all commands", do the
  following updates:
  
  Correct reason code  MQRC_UNKNOWN_OBJECT_NAME (2067, X'813')
  change to MQRC_SELECTOR_ERROR (2067, X'813').
  
  Add the following reason code after the last code in the
  list:
  "
  MQRCCF_UNKNOWN_OBJECT_NAME
    Unknown object name.
  "
  

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:

Fix information

Applicable component levels