A fix is available
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 number
PH20037
-
Reported component name
IBM MQ Z/OS V9
-
Reported component ID
5655MQ900
-
Reported release
100
-
Status
CLOSED PER
-
PE
NoPE
-
HIPER
NoHIPER
-
Special Attention
NoSpecatt / Xsystem
-
Submitted date
2019-12-06
-
Closed date
2020-10-13
-
Last modified date
2021-01-04
-
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
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.
[{"Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"100"}]
Document Information
Modified date:
27 March 2021