PH44859: MQ MESSAGES HEADER FORMAT CHANGED AFTER CICS UPGRADE TO 5.6 WHICH APPLICATION CANNOT PROCESS.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The Function field of the MQCIH is different at CICS TS 5.6.
  The processing in CICS TS 5.6 area of the MQ Bridge,  is
  returning different information in the MQCIH header that is sent
  back in the reply message to the client.
  
  The customer was seeing that in CICS TS 5.4, this field was
  returned as 4 bytes of binary zeroes.  In CICS TS 5.6, this
  field is showing as being 4 characters containing '0E02'.
  
  This area of CICS TS 5.6 was changed by RTC item 155443 which
  was taken to have the MQ bridge correctly capture EIBFN for some
  errors.  This APAR will correct DFHMQBP0 processing to put the
  EIBFN for a security_error and program_not_available.
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: MQCIH contains EIBFN of X'0E02' for a   *
  *                      successful call.                        *
  ****************************************************************
  The reply message that the CICS-MQ bridge returns to an
  application contains an MQCIH structure.
  The field within the MQCIH, mqcih_function contains the value
  x'0E02', which is the CICS EIBFN for a LINK.
  The IBM MQ documentation states that response fields are set by
  the CICS bridge in the reply message that the bridge sends to
  the application. Error information is returned in the
  ReturnCode, Function, CompCode, Reason and AbendCode fields, but
  not all of them are set in all cases.
  mqcih_function should only be set for MQCRC_SECURITY_ERROR and
  MQCRC_PROGRAM_NOT_AVAILABLE.
  In this case the application call was successful so
  mqcih_function should be blank.
  

Problem conclusion

• DFHMQBP0 has been changed to only set the CICS EIBFN into the
  mqcih_function field when the call suffers a NOTAUTH or
  PGMIDERR.
  

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:

  UI80117

Modules/Macros

• DFHMQBID DFHMQCM@ DFHMQP0@ DFHMQP1@ DFHMQP3@ DFHMQR0@
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R300 PSY UI80117

     UP22/04/22 P F204

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.