PH26516: MQ Z/OS: 5C6 ABEND IN CSQ1LOGP WITH RC 00F10101

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Using CSQ1LOGP to format archive log data sets, ends with 5c6
  RC=00F10101. The problem happen if there are more then one
  archive logs used within the log print utility.
  
  
  CSQ1LOGP does not correctly detect the end of an archive log
  where residual data (e.g. from a reused scratch tape) follows
  the end of log marker.
  
  The 5C6 abend is occurring because some additional integrity
  checks invalid RBA in the log data (due to the residual data).
  

Local fix

• View the CSQ1LOGP data for each archive log by processing
  only one log file instead of a concatenation of several log
  files in one job.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
  *                 Release 0 Modification 0, Release 1          *
  *                 Modification 0 and Release 2 Modification 0. *
  ****************************************************************
  * PROBLEM DESCRIPTION: When using CSQ1LOGP to format multiple  *
  *                      archive log datasets, the processing    *
  *                      doesn't correctly handle truncated logs *
  *                      with residual data past the point of    *
  *                      truncation. Depending on the nature of  *
  *                      the residual data, various CSQ1 error   *
  *                      messages can be reported.               *
  ****************************************************************
  If an ARCHIVE LOG command is issued, the current active log is
  truncated and an archive log command record is appended to the
  archived log. When using CSQ1LOGP to process truncated archive
  logs, if the archive log has residual data beyond the archive
  log command record, then it will be processed normally, which
  can have varying consequences depending on the specific contents
  of the data.
  

Problem conclusion

• The code has been changed to correctly process truncated archive
  logs, and will no longer process residual data beyond the point
  of truncation.
  
  The IBM MQ for z/OS Version 9.0.x and Version 9.1.x Knowledge
  Center are updated:
  IBM MQ 9.0.x/9.1.x
    IBM MQ
      Reference
        Administration reference
          Using the IBM MQ utilities on z/OS
            The log print utility (CSQ1LOGP) on z/OS
  ( https://www.ibm.com/support/knowledgecenter/en/SSFKSJ_9.0.0/
                            com.ibm.mq.ref.adm.doc/q088970_.htm )
  ( https://www.ibm.com/support/knowledgecenter/en/SSFKSJ_9.1.0/
                            com.ibm.mq.ref.adm.doc/q088970_.htm )
  
  The first enumerated bullet point under "Usage notes" has been
  changed from:
  "
  If your queue manager is in a queue-sharing group, you can
  specify the log range required by either LRSNSTART (optionally
  with LRSNEND) or RBASTART (optionally with RBAEND). You cannot
  mix LRSN and RBA specifications.
  If you need to coordinate the log information from the different
  queue managers in the queue-sharing group, use LRSN
  specifications.
  "
  to:
  "
  If your queue manager is in a queue-sharing group, you can
  specify the log range required by either LRSNSTART (optionally
  with LRSNEND) or RBASTART (optionally with RBAEND). You cannot
  mix LRSN and RBA specifications.
  If you need to coordinate the log information from the different
  queue managers in the queue-sharing group, use LRSN
  specifications. Note that processing logs simultaneously from
  different queue managers in a queue sharing group is not
  supported.
  "
  

Temporary fix

Comments

• ×**** PE21/09/22 FIX IN ERROR. SEE APAR PH40821  FOR DESCRIPTION
  

APAR Information

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

  PI93704

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

  UI70975 UI70976 UI72881

Modules/Macros

• CSQJRS03
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R000 PSY UI79530

     UP22/03/11 P F203

• R100 PSY UI79529

     UP22/03/11 P F203

• R200 PSY UI72881

     UP21/01/28 P F101

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.