PH20037: MQ Z/OS: ABENDS878-10 WHEN A CSQUTIL JOB RUNS WITH INPUT CONTAINING A LARGE LRECL VALUE, FOR INSTANCE IN Z/OSMF

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• In the reported case, an ABEND878-00000010 occurred when
  CSQUTIL JCL was submitted using z/OSMF Workflow.
  
  Reason code 10 means there is not enough virtual private area
  storage available to satisfy the request.
  
  The storage shortage was in Subpool 0 SP0 KEY8 below the line.
  The failing getmain was from module CSQUSPL.
  
  The problem occurred when the SYSIN or CMD DD had an LRECL of
  1024.  The job ran fine with an LRECL of 80.
  
  The problem can be recreated outside of z/OSMF by submitting a
  job to the INTRDR:
  
  //STEPONE1 EXEC PGM=IEBGENER
  //SYSPRINT DD SYSOUT=D
  //SYSIN DD DUMMY
  //SYSUT2 DD SYSOUT=(,INTRDR)
  //SYSUT1 DD DISP=SHR,DSN=<dataset>
  
  where <dataset> has an LRECL of 1024 and contains the JCL
  to execute the CSQUTIL utility.
  

Local fix

• If the job is being submitted using z/OSMF:
  On the workflow screen named 'Review JCL', there is an 'Edit
  JCL' button and beside that there is a field named 'Maximum
  record length', which defaults to 1024.  Change this value to
  80.
  
  Or, you can change the default LRECL for your workflow using
  the Workflow Editor. On the Step 'Type' tab there is a 'Max
  LRECL' field which you can set to 80.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All Users of IBM MQ for z/OS Version 9       *
  *                 Release 1 Modification 0 and Release 2       *
  *                 Modification 0                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: CSQUTIL abends with S878-10, when the   *
  *                      LRECL of the CSQUTIL SYSIN is not 80.   *
  ****************************************************************
  As documented in the Knowledge Center, the SYSIN data set
  for CSQUTIL must have a record length of 80. When invoking
  CSQUTIL where the input record length exceeds 80, an unintended
  loop in processing may occur which eventually results in the
  task terminating with a S878 abend.
  
  https://www.ibm.com/support/knowledgecenter/SSFKSJ_9.1.0/com.
  ibm.mq.ref.adm.doc/q088730_.htm
  

Problem conclusion

• Processing has been amended to ensure that CSQUTIL verifies
  the SYSIN record length is valid and will now terminate
  execution with a CSQU020E error message if it is not.
  (The input LRECL may be either 80 or 0, with 0 representing
  the LRECL not being set).
  
  ========== DOC Change for V910 Knowledge Center ===============
  
  The page "com.ibm.mq.ref.doc/csq_u.htm" in the Knowledge Center
  for V910 will be updated:
  
  Home
  > IBM MQ 9.1.x
    > IBM MQ
      > Reference
        > Messages
          > IBM MQ for z/OS messages, completion, and reason codes
            > Messages for IBM MQ for z/OS
              > Utilities messages (CSQU...)
  
  The following modification is made to the CSQU020E entry:
  
  System programmer response
  
  Examine the error message that was sent to the job log to
  determine the reason for the error. Check that the data set was
  correctly specified. Ensure that the data set record length is
  valid.
  
  ========== DOC Change for V920 Knowledge Center ===============
  
  The page "com.ibm.mq.ref.doc/csq_u.htm" in the Knowledge Center
  for V920 will be updated:
  
  Home
  > IBM MQ 9.2.x
    > IBM MQ
      > Reference
        > Messages
          > IBM MQ for z/OS messages, completion, and reason codes
            > Messages for IBM MQ for z/OS
              > Utilities messages (CSQU...)
  
  The following modification is made to the CSQU020E entry:
  
  System programmer response
  
  Examine the error message that was sent to the job log to
  determine the reason for the error. Check that the data set was
  correctly specified. Ensure that the data set record length is
  valid.
  

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:

  UI72038 UI72039

Modules/Macros

• CSQUTIL
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R100 PSY UI72038

     UP20/12/07 P F012

• R200 PSY UI72039

     UP20/12/04 P F012

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.