IBM Support

PI81618: MQ: RFH2 header is not removed when using PROPCTL(COMPAT) for a shared queue on a CFSTRUCT that has the OFFLOAD(DB2) option.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Message headers are sometimes present depending on OFFLOAD for
    CFSTRUCT. When a message arrives onto a mainframe queue manager
    from the distributed platform, a header is occasionally present
    depending on the CFSTRUCT associated with the queue and its
    OFFLOAD option.
    If the CFSTRUCT OFFLOAD option is set to SMDS, there is no RFH2
    header when the message is gotten. If CFSTRUCT OFFLOAD is set
    to DB2, a header becomes present, even when no header is sent.
    Problem still persisted after APAR PI60489 was applied to the
    environment as it did not solve the flattening/unflattening of
    the RFH2 header for messages on a shared queue using CFSTRUCT
    OFFLOAD(DB2).
    CSQIMGES is passing an incorrect address to CSQMHDRS for the
    start of the message data when the message is stored in a CF
    structure with OFFLOAD(DB2).
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
    *                 Release 0 Modification 0.                    *
    ****************************************************************
    * PROBLEM DESCRIPTION: Message may contain additional          *
    *                      MQRFH2 header once put to a             *
    *                      shared queue using a CFSTRUCT           *
    *                      defined with OFFLOAD(DB2).              *
    ****************************************************************
    When putting a message containing message properties to a shared
    queue defined with a CFSTRUCT that is configured with
    OFFLOAD(DB2), the message properties may be flattened into an
    MQRFH2 header that prefixes the message data.
    
    When the same message is put to a shared queue defined with a
    CFSTRUCT that is configured with OFFLOAD(SMDS) then no
    additional MQRFH2 header is present.
    

Problem conclusion

  • Processing has been amended so that no additional MQRFH2 header
    is added to the message data unless it is necessary or has been
    explicitly requested by use of the PROPCTL queue attribute or
    MQGMO_PROPERTIES_* options.
    

Temporary fix

Comments

  • ×**** PE18/05/16 FIX IN ERROR. SEE APAR PI98008  FOR DESCRIPTION
    

APAR Information

  • APAR number

    PI81618

  • Reported component name

    MQ Z/OS V9

  • Reported component ID

    5655MQ900

  • Reported release

    000

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-05-15

  • Closed date

    2017-11-21

  • Last modified date

    2018-06-14

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

    PI77522

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

    UI52056

Modules/Macros

  • CSQMPOM
    

Fix information

  • Fixed component name

    MQ Z/OS V9

  • Fixed component ID

    5655MQ900

Applicable component levels

  • R000 PSY UI52056

       UP17/12/16 P F712

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.

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
14 June 2018