Cisco Cisco Workload Automation 6.3 User Guide
38
Working with the z/OS Agent
z/OS Job Number
z/OS Job Number
The
Job Activity
pane and the
Job Details
dialog will display JES job numbers in the
External ID
column or field.
For USS programs and shell scripts, the process ID is shown in this
External ID
column.
Runtime Arguments
You can pass runtime arguments (parameters) to USS shell scripts and programs, as well as extended console
commands.
commands.
Runtime arguments for
Z
/OS jobs are only used for parameter substitution.
Parameter Substitution
Parameter substitution fundamentally works as string replacement utilizing a ‘compare to’ string and a ‘replacement
string’ separated by an equal sign (‘=’). When the ‘compare to’ string is found, it is replaced by the ‘replacement string’.
You can add or delete parameters from a given JCL command statement.
string’ separated by an equal sign (‘=’). When the ‘compare to’ string is found, it is replaced by the ‘replacement string’.
You can add or delete parameters from a given JCL command statement.
Parameter substitution now works by stripping off the comments and creating a logical line of a JCL statement that may
have spanned severeal physical lines through use of continuation. The substitution is then applied against the logical line
allowing for more flexible and specifice substitution. The line is the re-broken into physical lines, following all the JCL
syntax rules, and comments are re-inserted as it is written out oto the modified JCL file.
have spanned severeal physical lines through use of continuation. The substitution is then applied against the logical line
allowing for more flexible and specifice substitution. The line is the re-broken into physical lines, following all the JCL
syntax rules, and comments are re-inserted as it is written out oto the modified JCL file.
Original JCL Line(s)
//sysut2 DD DSN=BOBW.RESTART.CNTL,
//
DISP=(NEW,CATLG,DELETE),
//
UNIT=SYSDA,VOL=SER=DB1410,
//
DCB=(RECFM=FB,LRECL=80,BLKSIZE=6640,DSORG=PO),
//
SPACE=(CYC,(45,15,90),RLSE)
Logical Line for Substitution
//SYSUT2DD
DSN=BOBW.RESTART.CNTL,DISP=(NEW,CATLG,DELETE),UNIT=SYSDA,VOL=SER=DB1410,DCB=(RECFM=FB,LRECL=80,BLKSIZE=
6640,DSORG=PO),SPACE=(CYL,(45,15,90),RLSE)
Modified JCL Line(s)
//SYSUT2DD
DSN=BOBW.RESTART.CNTL,DISP=(NEW,CATLG,DELETE),UNIT=SYSDA,
// VOL=SER=DB1410,DCB=(RECFM=FB,LRECL=80,BLKSIZE=6640,DSORG=PO),
// SPACE=(CYL,(45,15,90),RLSE)
By creating the logical line, the user can be very specific about where to substitute a particular parameter. If the same
parameters are on mulitple steps, enough of the logical line can be included in the ‘compare to’ part of the substitution
to make it unique to only one step, if that is needed.
parameters are on mulitple steps, enough of the logical line can be included in the ‘compare to’ part of the substitution
to make it unique to only one step, if that is needed.
The rules for parameter substitution are fairly straight forward:
Any equal signs on the left side (compart to) of the assignment must be escaped (\=).
MSGCLASS\=H=MSGCLASS=A