IBM Support

PM98559: CSQ5PQSG VERIFY QSG DOES NOT CHECK LHQC CONSISTENCY

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • If DB2 and CF entries get out of step, for instance when a list
    header is reused incorrectly, CSQ5PQSG does not have any
    function to detect this.
    Message CSQE137E is issued in the master joblog.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of WebSphere MQ for z/OS Version 7 *
    *                 Release 0 Modification 1 and Release 1       *
    *                 Modification 0.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: The queue manager issues message        *
    *                      CSQE137E and abends with 5C6-00C51053,  *
    *                      reporting an inconsistency between the  *
    *                      CF and DB2. CSQ5PQSG however completes  *
    *                      without errors.                         *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    CSQ5PQSG does not check the contents of the list headers in the
    CF structures, thus this mismatch is not detected.
    

Problem conclusion

  • CSQ5PQSG was changed to connect to the CF structures and compare
    the list header content to the values in DB2, detecting
    mismatches and reporting them.
    
    
    The Info Center section:
      WebSphere MQ
        > Reference
       > Messages
         > Messages and reason codes for z/OS
        > Messages for WebSphere MQ for z/OS
    
    will be updated with the following additional messages:
    
    
    CSQU680E: DB2 and CF structure out of sync for list header
              list-header-number in structure struc-name
    
    Explanation:
    "
    The row for the shared queue in DB2 represents a different
    queue than the one found in the CF structure for list header
    list-header-number in structure struc-name.
    This is inconsistent and will cause the queue manager to abend
    with 5C6-00C51053 and issue message CSQE137E.
    Messages CSQU681I and CSQU682I are also issued, providing
    further details.
    "
    
    System action:
    "
    The mismatch is reported and the utility continues processing.
    "
    
    System programmer response:
    "
    Collect the items listed in Coupling facility problem
    determination and in DB2 manager problem determination and
    contact your IBM support center.
    "
    
    
    CSQU681I: DB2 entry for list header list-header-number in
              structure struc-name: queue-name
    
    Explanation:
    "
    This message is issued with message CSQU680E. Queue-name
    is the name of the queue that was found in DB2 for list
    header list-header-number in structure struc-name.
    "
    
    System action:
    "
    The mismatch is reported and the utility continues processing.
    "
    
    System programmer response:
    "
    See message CSQU680E.
    "
    
    
    CSQU682I: CF entry for list header list-header-number in
              structure struc-name: queue-name
    
    Explanation:
    "
    This message is issued with message CSQU680E. Queue-name
    is the name of the queue that was found in the CF for list
    header list-header-number in structure struc-name.
    "
    
    System action:
    "
    The mismatch is reported and the utility continues processing.
    "
    
    System programmer response:
    "
    See message CSQU680E.
    "
    
    
    CSQU683E: Missing CF entry for list header list-header-number
              in structure struc-name
    
    Explanation:
    "
    The DB2 entry for list header list-header-number in structure
    struc-name indicated that a current copy is available in
    the CF, though none was found.
    This is inconsistent and can cause return code 2085 for
    applications trying to use this queue.
    "
    
    System action:
    "
    The mismatch is reported and the utility continues processing.
    "
    
    System programmer response:
    "
    Starting or restarting one of the queue managers in the QSG will
    resolve the problem.
    If the problem persists, collect the items listed in Coupling
    facility problem determination and in DB2 manager problem
    determination and contact your IBM support center.
    "
    
    
    CSQU684I: Structure struc-name has not yet been allocated by a
              queue manager
    
    Explanation:
    "
    The CF structure struc-name is not allocated. This happens when
    the first IXLCONN to the structure is issued, which should only
    be done by a queue manager in the QSG.
    "
    
    System action:
    "
    The utility continues processing.
    "
    
    
    CSQU685I: Structure struc-name connected
    
    Explanation:
    "
    The utility has successfully connected to CF structure
    struc-name.
    "
    
    System action:
    "
    The utility continues processing.
    "
    
    
    CSQU686E: Structure struc-name connection failed, IXLCONN
              RC=return-code reason=reason
    
    Explanation:
    "
    The utility failed to connect to CF structure struc-name.
    "
    
    System action:
    "
    The utility skips any further queues for this structure and
    continues processing.
    "
    
    System programmer response:
    "
    Examine the return and reason codes to determine why the
    IXLCONN connect failed.
    "
    
    
    CSQU687I: Structure struc-name disconnected
    
    Explanation:
    "
    The utility has disconnected from CF structure struc-name.
    "
    
    System action:
    "
    The utility continues processing.
    "
    
    
    CSQU688E: Missing DB2 entry for list header list-header-number
              in structure struc-name
    
    Explanation:
    "
    The CF entry for list header list-header-number in structure
    struc-name indicated that a current copy is available in
    DB2, though none was found.
    This is an inconsistency and can cause a problem if a new
    queue is defined for the same list header.
    "
    
    System action:
    "
    The mismatch is reported and the utility continues processing.
    "
    
    System programmer response:
    "
    Collect the items listed in Coupling facility problem
    determination and in DB2 manager problem determination and
    contact your IBM support center.
    "
    
    
    CSQU689E: Unexpected return code for structure struc-name,
              IXLLSTE RC=return-code reason=reason
    
    Explanation:
    "
    The utility failed to read a list entry from the CF structure
    struc-name.
    "
    
    System action:
    "
    The utility skips any further queues for this structure and
    continues processing.
    "
    
    System programmer response:
    "
    Examine the return and reason codes to determine why the
    IXLLSTE read failed.
    "
    
    010Y
    012Y
    013Y
    014Y
    100Y
    102Y
    103Y
    104Y
    105Y
    CSQFSTXC
    CSQFSTXE
    CSQFSTXF
    CSQFSTXK
    CSQFSTXU
    CSQ5AUTL
    CSQ5B701
    CSQ5B710
    CSQ5PVER
    

Temporary fix

Comments

APAR Information

  • APAR number

    PM98559

  • Reported component name

    WMQ Z/OS V7

  • Reported component ID

    5655R3600

  • Reported release

    010

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2013-10-07

  • Closed date

    2013-12-30

  • Last modified date

    2014-03-03

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

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

    UI13903 UI13904 UI13905 UI13906 UI13907 UI13908 UI13909 UI13910
    UI13911

Modules/Macros

  • CSQFSTXC CSQFSTXE CSQFSTXF CSQFSTXK CSQFSTXU
    CSQ5AUTL CSQ5B701 CSQ5B710 CSQ5PVER
    

Fix information

  • Fixed component name

    WMQ Z/OS V7

  • Fixed component ID

    5655R3600

Applicable component levels

  • R010 PSY UI13903

       UP14/02/05 P F402

  • R012 PSY UI13904

       UP14/02/05 P F402

  • R013 PSY UI13905

       UP14/02/05 P F402

  • R014 PSY UI13906

       UP14/02/05 P F402

  • R100 PSY UI13907

       UP14/02/05 P F402

  • R102 PSY UI13908

       UP14/02/05 P F402

  • R103 PSY UI13909

       UP14/02/05 P F402

  • R104 PSY UI13910

       UP14/02/05 P F402

  • R105 PSY UI13911

       UP14/02/05 P F402

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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
03 March 2014