IBM Support

PH59894: CSQU145I SCOPY STATEMENT FAILED

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

APAR status

  • Closed as program error.

Error description

  • CSQUTIL SCOPY failed with these messages:
    
    CSQU145I  SCOPY statement failed
    CSQU143I  1 SCOPY statements attempted
    CSQU144I  0  statements executed successfully
    CSQU147I CSQUTIL Utility terminated, return code=8
    
    No abend happened.
    
    The problem is an incorrect conversion from a page number into
    an RBA when getting a record from the page set in CSQUIRH8. The
    problem results in the incorrect page being returned for page
    numbers greater than 0x000FFFFF. The problem affects both the
    CSQUTIL SCOPY and CSQUZAP CHKISQE functions.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
    *                 Release 2 Modification 0 and Release 3       *
    *                 Modification 0.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: The CSQUTIL SCOPY function reads        *
    *                      messages from a page set to copy them   *
    *                      into an output data set. This requires  *
    *                      converting a page number into an RBA. A *
    *                      bug in this calculation results in the  *
    *                      RBA being calculated incorrectly for    *
    *                      page numbers greater than 0x000FFFFF.   *
    *                      This results in the SCOPY operation     *
    *                      failing and message CSQU145I being      *
    *                      issued and the CSQUTIL job step ending  *
    *                      with RC=0008.                           *
    ****************************************************************
    The logic which converts a page number into an RBA uses a 32-bit
    multiplication instruction. This results in RBA greater than
    0xFFFFFFFF being truncated. This RBA corresponds to pages with a
    page number greater than 0x00FFFFFF. The incorrect RBA
    calculation will result in the wrong page being read from the
    page set. This will likely result in the CSQUTIL SCOPY operation
    failing, but could also result in the wrong message being copied
    to the output data set.
    

Problem conclusion

  • The CSQUTIL SCOPY code which converts a page number into an RBA
    has been corrected.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH59894

  • Reported component name

    IBM MQ Z/OS V9

  • Reported component ID

    5655MQ900

  • Reported release

    200

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2024-02-19

  • Closed date

    2024-03-26

  • Last modified date

    2024-03-26

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

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

    UI96235 UI96236

Modules/Macros

  • CSQUIRH8
    

Fix information

  • Fixed component name

    IBM MQ Z/OS V9

  • Fixed component ID

    5655MQ900

Applicable component levels

[{"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":"LOB67","label":"IT Automation \u0026 App Modernization"}}]

Document Information

Modified date:
04 April 2024