Passing Parameters to the CA Workload Automation Restart Option U11RMS Run Handler Program via the SYSIN statement

book

Article ID: 51016

calendar_today

Updated On:

Products

CA-11

Issue/Introduction

Passing Parameters to U11RMS Run Handler Program via the SYSIN statement.

 

Environment

Release:
Component: 11

Resolution

Parameters for the U11RMS run handler program can be specified in either of the following ways:

  • PARM on the EXEC statement (EXEC PGM=U11RMS,PARM='...')
  • Through a SYSIN data set
  • Both (combination of PARM and SYSIN)

If both methods are used, the SYSIN parameters are appended to the ones specified on the EXEC statement. The result is a continuous series of parameters that U11RMS uses to control processing for the job. SYSIN parameters cannot override the positional parameters such as processing code or starting/ending steps specified as parameters on the EXEC statement. Parameters specified on the EXEC statement can continue to multiple lines according to JCL coding rules.

Continuation for parms specified via SYSIN can be done in the following ways:

  • A parameter ending with a comma and a space indicates additional parameters follow on the next line.

  • A nonblank character in column 72 indicates that the current parameter is continued starting in column 1 of the next line.

An asterisk in column 1 indicates a comment line unless a nonblank character was found in column 72 of the previous line.

If the //SYSIN DD * is present, it must include parms values to be specified for the U11RMS. Possible errors that can result with improper use if the SYSIN are U0012 abend in the U11RMS step along with the U11-019 message.

Possible causes associated with the U11-019 are as follows:

U11-019 SYSIN ERROR: x

Where x can be one of the following:

  • READ NON-COMMENT SYSIN CARD AFTER ENDING CARD
  • UNEXPECTED NON-BLANK CHARACTER BEFORE COLUMN 16
  • RECEIVED MORE DATA THAN FITS IN BUFFER (xxxx AFTER THIS CARD)
  • FIRST SYSIN CARD HAD BLANK IN FIRST COLUMN
  • NO SYSIN CARD FOUND WITH NON-COMMA END