A fix is available
APAR status
Closed as program error.
Error description
Rational Developer for System z V7.5.1: Valid JCL not handled properly when JCL uses IKJEFT01 and TSO SUBMIT method is used to submit the JCL. The following is an example of this problem that occurs when putting the following JCL into a local file (not a remote dataset member) and submitting it to a system that is set up to use TSO SUBMIT. //MIKEDED1 JOB NOTIFY=&SYSUID,USER=&SYSUID //* Just an example of using the IKJEFT01 (TSO) utility //STEP1 EXEC PGM=IKJEFT01 //SYSTSPRT DD SYSOUT=* //SYSUDUMP DD SYSOUT=* //* //SYSTSIN DD * TIME LISTDS ('MIKEDED.JMON.JMCONFIG' 'MIKEDED.JMON.JCL' + 'MIKEDED.JMON.LOAD' 'MIKEDED.JMON.OUT') + STATUS HISTORY LABEL TIME /* The TIME commands get executed but the LISTDS command does not. The key to this problem is that the LISTDS command is continued (via the + character), and its total length is greater than 80 characters. The problem occurs because the LISTDS command passes through IKJEFT01 twice. Note: The TSO SUBMIT method uses the IKJEFT01 program. The first time through IKJEFT01 concatenates the continuation lines. The resulting command is too long to be accepted by the second invocation. This problem only occurs if the JCL is in a local file, or if it is submitted from an LPEX session which was modified but not saved. This problem does not occur if the JCL is in an unmodified remote dataset member. Another case which is not handled properly is if the following line is added to the above JCL: //*----------------------- With the above line added, the JCL looks like: //MIKEDED1 JOB NOTIFY=&SYSUID,USER=&SYSUID //* Just an example of using the IKJEFT01 (TSO) utility //*----------------------- //STEP1 EXEC PGM=IKJEFT01 //SYSTSPRT DD SYSOUT=* //SYSUDUMP DD SYSOUT=* //* //SYSTSIN DD * TIME LISTDS ('MIKEDED.JMON.JMCONFIG' 'MIKEDED.JMON.JCL' + 'MIKEDED.JMON.LOAD' 'MIKEDED.JMON.OUT') + STATUS HISTORY LABEL TIME /* and the following errors from the JOB output: 1 //MIKEDED1 JOB NOTIFY=&SYSUID,USER=&SYSUID JOB00167 //* JUST AN EXAMPLE OF USING THE IKJEFT01 (TSO) UTILITY //*----------------------//STEP1 EXEC PGM=IKJEFT01 IEFC653I SUBSTITUTION JCL - NOTIFY=YWILSON,USER=YWILSON 2 //SYSTSPRT DD SYSOUT=* 3 //SYSUDUMP DD SYSOUT=* //* 4 //SYSTSIN DD * STMT NO. MESSAGE 2 IEFC019I MISPLACED DD STATEMENT 3 IEFC019I MISPLACED DD STATEMENT 4 IEFC019I MISPLACED DD STATEMENT 4 IEFC607I JOB HAS NO STEPS Note that the comment line added and the STEP1 line are incorrectly concatenated. This occurs when the last character in the comment is a hyphen (-).
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: Users who submit IKJEFT01 jobs to a system * * on which Job Monitor has been configured * * SUBMITMETHOD=TSO. * **************************************************************** * PROBLEM DESCRIPTION: JCL which invokes the IKJEFT01 utility * * may not be handled correctly. * * Specifically, TSO commands that are * * continued using + or - are * * concatenated, thus exceeding 80 * * characters in length. * **************************************************************** * RECOMMENDATION: * **************************************************************** If the Job Monitor FEJJMON has been configured with SUBMITMETHOD=TSO then Job Monitor will itself use the IKJEFT01 utility to submit the job. Thus the continued TSO command lines are concatenated.
Problem conclusion
The TSO SUBMIT sample JCL (FEJTSO) has been modified to create a temporary dataset for the TSO commands rather than submit them instream. This also solves the problem of incidental uppercasing of the commands.
Temporary fix
Comments
ž**** PE11/03/11 FIX IN ERROR. SEE APAR PM34650 FOR DESCRIPTION
APAR Information
APAR number
PK86912
Reported component name
RD/Z HOST
Reported component ID
5724T0723
Reported release
750
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2009-05-19
Closed date
2010-12-14
Last modified date
2011-03-11
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK63212
Modules/Macros
FEJTSO
Fix information
Fixed component name
RD/Z HOST
Fixed component ID
5724T0723
Applicable component levels
R750 PSY UK63212
UP11/01/15 N 1000
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":"SSJK49","label":"IBM Developer for z Systems"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.5","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":"7.5","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
27 October 2020