IBM Support

PH62685: IBM MQ Z/OS: CSQU541E RC=00000004 WITH CSQUZAP ARRAYDB2 FUNCTION

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Message CSQU541E is incorrectly issued if using the ARRAYDB2
    function of utility CSQUZAP with an ARRAY(LH) NUMBER greater
    than 64, an ARRAY(STRUCTURE) NUMBER greater than 64, or an
    ARRAY(QMGR) NUMBER greater than 32.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
    *                 Release 2 Modification 0,                    *
    *                 Release 3 Modification 0, and                *
    *                 Release 4 Modification 0.                    *
    ****************************************************************
    * PROBLEM DESCRIPTION: CSQUZAP DB2ARRAY would fail and issue   *
    *                      message CSQU541E when using a NUMBER    *
    *                      value above 64 for ARRAY(LH) and        *
    *                      ARRAY(STRUCTURE) and a NUMBER value     *
    *                      above 32 for ARRAY(QMGR).               *
    ****************************************************************
    CSQUZAP would incorrectly validate the value of NUMBER by
    checking it does not exceed the length of the array in bytes,
    however NUMBER represents a bit in the array not a byte, so
    the length of the array should be calculated in bits not bytes.
    

Problem conclusion

  • CSQUZAP has been corrected to calculate the length of the array
    in bits. The user will now correctly receive a CSQU104E message
    when the value of NUMBER exceeds the max allowable value.
    Message CSQU541E is no longer incorrectly issued.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH62685

  • Reported component name

    IBM MQ Z/OS V9

  • Reported component ID

    5655MQ900

  • Reported release

    200

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2024-08-09

  • Closed date

    2025-02-06

  • Last modified date

    2025-03-04

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

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

    UI99907 UI99908 UI99909

Modules/Macros

  • CSQ5AZAP CSQ5PLNZ CSQ5Z920 CSQ5Z930 CSQ5Z940 CSQU5ZAP CSQUZPAR
    

Fix information

  • Fixed component name

    IBM MQ Z/OS V9

  • Fixed component ID

    5655MQ900

Applicable component levels

  • R200 PSY UI99909

       UP25/02/18 P F502

  • R300 PSY UI99908

       UP25/02/18 P F502

  • R400 PSY UI99907

       UP25/02/18 P F502

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":"BU048","label":"IBM Software"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"200","Line of Business":{"code":"LOB77","label":"Automation Platform"}}]

Document Information

Modified date:
04 March 2025