PH46479: MQ Z/OS: THE QLOAD UTILITY CSQUDMSG LOST A MESSAGE WHEN THERE WAS A FAILURE WRITING TO AN OUTPUT DATA SET

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Utility program CSQUDMSG was used to copy messages from an MQ
  queue to a dataset. The messages on the queue were large, and
  there were about 50,000 messages.
  
  The job failed with a B37-04 abend while processing records.
  The data set failed to allocate another extent as the next
  extent would have taken the data set over the maximum 65,535
  tracks.
  
  The job ran a few times, and the utility lost the last message
  it was attempting to process each time.
  
  CSQUDMSG is the z/OS equivalent of dmpmqmsg.  It has an alias
  of QLOAD.  Sample JCL is CSQ4QLOD.
  
  Additional symptoms and keywords:
  ABENDB37 04
  

Local fix

• If the lost message is persistent, locate and replay it using
  CSQ1LOGP.  See
  https://www.ibm.com/docs/en/ibm-mq/9.1?topic=zos-log-print-utili
  ty-csq1logp.
  
  To avoid the problem, limit the number of messages processed at
  a time with the -r option, the message range option. See
  https://www.ibm.com/docs/en/ibm-mq/9.1?topic=reference-dmpmqmsg-
  queue-load-unload
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
  *                 Release 1 Modification 0, Release 2          *
  *                 Modification 0 and Release 3 Modification 0. *
  ****************************************************************
  * PROBLEM DESCRIPTION: An error occurs when offloading         *
  *                      messages from an input queue to         *
  *                      an output file using the QLOAD          *
  *                      utility. In this scenario, it is        *
  *                      possible for duplicate messages to      *
  *                      exist between the partially written     *
  *                      output file and the input queue.        *
  ****************************************************************
  The code which implements transactional behaviour for the
  QLOAD utility does not handle the rollback of transactions
  partly written to output files.
  

Problem conclusion

• The code has been changed to handle the rollback of partially
  written transactions from output files in the case of an error
  when writing to an output file.
  

Temporary fix

Comments

APAR Information

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

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

  UI93048 UI93049 UI93050

Modules/Macros

• CMQUDFNC CMQUDLOD
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R100 PSY UI93050

     UP23/08/19 P F308

• R200 PSY UI93049

     UP23/08/19 P F308

• R300 PSY UI93048

     UP23/08/19 P F308

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.