IBM Support

PK86912: Rational Developer for System z V7.5.0: Valid JCL not handled properly when JCL uses IKJEFT01 and TSO SUBMIT method is used

A fix is available

Subscribe

You can track all active APARs for this component.

 

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