A fix is available
APAR status
Closed as program error.
Error description
An 0C4 Abend Reason Code 11 occurs in modul EQQGSAUT offset X'224' at level UK18053. The failure occurs on a SELECT JCLPREP call to EQQYCOM, when working the SELECT JCLPREP returns a list of promptable variables found in the JCL (being validated). In the case of the JCL in question SELECT JCLPREP has a problem with it that appears to be related to the number of records. The 0C4 abend occurs, at offset x'21E' in module EQQGSAUT on a CLC instruction which references register 7. The message: EQQG004E SUBTASK GS EXECUTOR 01 ABENDED, IT IS RESTARTED AT CLEANUP is issued in combination with a symptom dump with the following output: xx.xx.xx xxxxxxxx IEA995I SYMPTOM DUMP OUTPUT 729 729 SYSTEM COMPLETION CODE=0C4 REASON CODE=00000011 729 TIME=xx.xx.xx SEQ=xxxx CPU=xxx ASID=xxxx 729 PSW AT TIME OF ERROR 078D0000 8013DBD4 ILC 6 INTC 11 729 ACTIVE LOAD MODULE ADDRESS=00106AC8 OFFSET=0003710C 729 NAME=EQQJHJSX 729 DATA AT PSW 0013DBCE - 97B14770 B234D501 700097DD
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All TWS for z/OS users. * * FUNCTION=GS/AR. * **************************************************************** * PROBLEM DESCRIPTION: When a Variable substitution failure * * occurs in a JCL bigger than the * * maximum JS record definition, the * * JCL is incorrectly stored truncated * * leading to a corruption in JS VSAM. * * This can happen as a consequence * * of different scenarios with * * different symptoms: * * * * During a SELECT JCLPREP of a JCL * * too long respect to the JS definition * * and defined with wrong variables to * * be substituted, a 0C4 abend occurs in * * module EQQGSAUT at offset X'224'. * * In this first scenario the JS * * subresources are protected * * through the AUTHDEF statement. * * * * A similar abend, ABEND0C4 at EQQJHGJS * * X'354', is a different symptom of the * * same problem. The problem scenario * * involves a JCL too big to be saved * * into the JS and the use of some * * variables in error. In this last * * case the automatic recovery is * * activated (Recovery(YES) in the * * controller parameters). * * * **************************************************************** * RECOMMENDATION: APPLY THE PTF FIXING THIS APAR * **************************************************************** SELECT JCLPREP of a JCL with variables to be substitued and too long respect to the JS definition, causes 0C4 abend in module EQQGSAUT at offset X'224'. A similar abend, ABEND0C4 at EQQJHGJS X'354' in AR task, is a different symptom of the same problem when automatic recovery is activated.
Problem conclusion
The main problem is caused by a corrupted JCL stored in the JS file. The JCL is defined with variables to be substituted during the process. The stored JCL results truncated, JCL lines number in header does not match the real JCL size and garbage is appended to the end. This problem is caused by an incorrect storing done in JS by EQQJHGET module when a variable substitution error occurs and at the same time JCL size exceed maximum allowed by JS VSAM record definition. The abend in the apar description is not directly caused by the simple storing process of the JCL in the JS but by the following usage of the corrupted JCL. In particular, if JS subresources (JS.ADNAME, JS.JOBNAME, JS.WSNAME...) are protected, a 0C4 abend occurs in EQQGSAUT when check on JS authorization is performed. In a different case, when the Automatic Recovery (AR) is activated, the AR task abends because the JCL stored in JS is "corrupted". THE FOLLOWING TWS for z/OS PUBLICATIONs WILL BE UPDATED: +--------------------------------------------------------------+ | | |TITLE: IBM Tivoli Workload Scheduler for z/OS, | | Programming Interfaces SH19-4545-01 | | | |CHAPTER 1 : The Program Interface. | | | |Paragraph : JCL Preparation using PIF. | | | |Section : Simulating Variable Substitution. | | | |Change the last bullet as follows: | | | |"JCL is returned even if errors were found, but for the case | | when the JCL exceeds the JS size." | +--------------------------------------------------------------+ +--------------------------------------------------------------+ | | |TITLE: IBM Tivoli Workload Scheduler for z/OS, | | Programming Interfaces SC32-1266-02 | | | |CHAPTER 1 : The Program Interface. | | | |Paragraph : JCL Preparation using PIF. | | | |Section : Simulating Variable Substitution. | | | |Change the last bullet as follows: | | | |"JCL is returned even if errors were found, but for the case | | when the JCL exceeds the JS size." | +--------------------------------------------------------------+ +--------------------------------------------------------------+ | | |TITLE: IBM Tivoli Workload Scheduler for z/OS, | | Programming Interfaces SC32-1266-03 | | | |CHAPTER 1 : The Program Interface. | | | |Paragraph : JCL Preparation using PIF. | | | |Section : Simulating Variable Substitution. | | | |Change the last bullet as follows: | | | |"JCL is returned even if errors were found, but for the case | | when the JCL exceeds the JS size." | +--------------------------------------------------------------+ 102Y 202Y 302Y EQQJHGET EQQRJCLX
Temporary fix
Comments
APAR Information
APAR number
PK57435
Reported component name
TIV WRKLD SCHD
Reported component ID
5697WSZ01
Reported release
202
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2007-12-03
Closed date
2007-12-20
Last modified date
2008-02-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK32522 UK32523 UK32524
Modules/Macros
EQQJHGET EQQRJCLX
| SH19454501 | SC32126602 | SC32126603 |
Fix information
Fixed component name
TIV WRKLD SCHD
Fixed component ID
5697WSZ01
Applicable component levels
R102 PSY UK32522
UP08/01/24 P F801
R202 PSY UK32523
UP08/01/24 P F801
R302 PSY UK32524
UP08/01/24 P F801
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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSRULV","label":"IBM Workload Scheduler for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"202","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"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":"202","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 February 2008