OA65357: START COMMAND WILL BE TRUNCATED IF THE JOB-LEVEL KEYWORDS EXCEED 41 CHARACTERS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When issuing a START with job-level keywords exceeding 41 bytes
  in length(ex: BYTES,LINES), the resulting JOB statement that is
  created will be truncated.  This leads to a missing closing
  parenthesis and an IEE122I: Start Command JCL error.
  
  ANALYSIS:
  IEESB801 copies the JOB statement created to represent the START
  command from an internal control block just before calling the
  converter.  The MVC instruction used to move this data was using
  an incorrect ending point to compute the maximum length the
  keywords can be.  The keyword portion should be able to reach 56
  bytes in length but the MVC causes them to be incorrectly
  truncated when they exceed 41 bytes.
  
  KNOWN IMPACT:
  START command will fail with the following messages:
  
  IEFC622I:unbalanced parentheses on the job statement
  IEE122I: start command JCL error
  
  VERIFICATION STEPS:
  1)Verify that the job-level keywords being specified on the
  START command exceed 41 bytes in length.  Job-level keywords
  that can be specified on start include the following:
  ADDRSPC  BYTES  CARDS    COND
  JESLOG   LINES  MSGCLASS
  MSGLEVEL NOTIFY PAGES
  PERFORM  PRTY   REGION   TIME
  
  2) When the start fails, look for messages IEFC622I and IEE122I
  
  ADDITIONAL SYMPTOMS:
  JCL error
  START command failure
  BYTES=
  LINES=
  

Local fix

• BYPASS/CIRCUMVENTION:
  Code the parameters on the JOB statement in the started task
  rather than overriding with the start command.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All HBB77C0 and above installations.                         *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * When issuing a START command,                                *
  * MSGIEE122I can be erroneously issued.                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When issuing a START command with JOB statement keyword
  parameters to modify the JOB statement for the started task,
  the resulting JOB statement may be truncated.  This can occur
  when the length of the JOB statement keywords to be overridden
  exceeds 41 bytes. This can result in various syntax errors.
  The START command will fail with the following message:
    IEE122I START COMMAND JCL ERROR
  
  In the reported scenario, MSGIEFC622I was also issued to
  describe the syntax error:
    IEFC622I UNBALANCED PARENTHESES ON THE JOB STATEMENT
  However, other messages can be issued depending on how the
  JOB statement was constructed.
  

Problem conclusion

• START processing is corrected to copy the entire internally
  constructed JOB statement.
  

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:

  UJ93930 UJ93931 UJ93932

Modules/Macros

• IEESB801
  

Fix information

• Fixed component name

  INITIATOR/TERM

• Fixed component ID

  5752SC1B6

Applicable component levels

• R7D0 PSY UJ93932

     UP23/11/01 P F310

• R7E0 PSY UJ93930

     UP23/11/01 P F310

• R7C0 PSY UJ93931

     UP23/11/01 P F310

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.