Cisco Cisco Workload Automation 6.3 User Guide
39
Working with the z/OS Agent
JCL Restart Capability
If there are any spaces, commas or single quotes (ticks) on the left side of the assignment statement (before the first
un-escaped=sign), then it must be enclosed in single qotes (ticks) with any single quotes within the statement escaped
(/’).
un-escaped=sign), then it must be enclosed in single qotes (ticks) with any single quotes within the statement escaped
(/’).
‘MSGLEVEL\=(1,1),’=’MSGLEVEL=(1,1),RESTART=,’
If there are any spaces, commas or single quotes on the right side (replacement text) of the first un-escaped equal sign,
it must be enclosed in single quotes with any single quotes within the replacement text escaped (\’).
it must be enclosed in single quotes with any single quotes within the replacement text escaped (\’).
‘MSGLEVEL\=(1,1),’=’MSGLEVEL=(1,1),BLAH=\’JUST A LONG COMMENT FOR NO PARTICULAR REASONBUT TO BE
LONG\’,’
If the text string on the left of the first un-escaped equal sign is found, it will be replaced by the text string on the right
side of the first un-escaped equal sign. Parameters can be removed by specifying nothing after the first un-escaped
equal sign.
side of the first un-escaped equal sign. Parameters can be removed by specifying nothing after the first un-escaped
equal sign.
So, in the last example above,
MSGLEVEL=(1,1),
Will become:
MSGLEVEL=(1,1),BLAH=' JUST A LONG COMMENT FOR NO PARTICULAR REASON BUT TO BE LONG ',
Warning:
If you cut and paste text from the mainframe, you must replace the mainframe NOT sign with the '^'
(uppercase 6 on most keyboards). The mainframe NOT sign appears in the text, but is treated as a DELETE character
and modifies the string before it is sent to the agent.
and modifies the string before it is sent to the agent.
Note:
You must match the case of the existing JCL, the case of the substitution strings is not modified or ignored for the
purpose of the compares or substitutions.
Note:
If any parameter substitutions fail to apply at least once in the target JCL, parameter substitution will fail and the
job will not be run. Do not put in parameter substitution lines that will not apply to the target JCL.
JCL Restart Capability
This new functionality and methodology provides a basic job restart capability for the
z/OS Agent. There were three distinct development pieces that comprise this functionality:
z/OS Agent. There were three distinct development pieces that comprise this functionality:
Recognition and special handling of "RESTART=" parameter in the parameter substitution logic.
A re-write of the parameter substitution logic to make it more robust and provide the special handling of the
"RESTART=" parameter.
"RESTART=" parameter.
A new
tagent.ini parameter - mvs.modjcl - that allows the customer to designate where to store the modified JCL
if they want it preserved after job submission.
RESTART=handling
For any JCL job that is defined in CWA you can now 'pre-specify' the "RESTART=" job parameter at the location in the
JCL where it will need to be specified if a restart is required. If nothing is specified after the "=" sign (other than a comma
(,)), then the parameter substitution logic will ignore the line for substitution purposes. If there are no other parameter
substitution lines specified, then the original JCL will be used to submit the job. If there are other parameter substitutions
(additional substitution lines) specified, then they will be applied and the modified JCL will be submitted.
JCL where it will need to be specified if a restart is required. If nothing is specified after the "=" sign (other than a comma
(,)), then the parameter substitution logic will ignore the line for substitution purposes. If there are no other parameter
substitution lines specified, then the original JCL will be used to submit the job. If there are other parameter substitutions
(additional substitution lines) specified, then they will be applied and the modified JCL will be submitted.
Note:
Do not put other parameter substitutions on the same substitution line as the "RESTART=" as the entire substitution
will be ignored if the "RESTART=" does not have a valid restart target. Multiple substitution lines can target the same
line of JCL, so you can add other lines to perform any other substitutions needed for the same line.
line of JCL, so you can add other lines to perform any other substitutions needed for the same line.