Task Properties: z/OS Task
Property |
UI Field Name |
Description |
Specifications |
Required |
---|---|---|---|---|
|
Auto-Restart Option |
Allows the z/OS job to be resubmitted with controlled step selection. |
Default is – None – (0). |
N |
|
Delete Override JCL] |
If |
Boolean; Valid values: true/false. Default is false. |
N |
|
Output File |
If |
|
N |
|
Exit Code Processing |
Specification for how the Controller should determine whether the executed command failed or completed successfully. |
Valid values: Default is Success Exitcode Range (1). |
N |
|
Exit Codes |
If |
Format: Numeric. Use commas to list a series of exit codes; use hyphens to specify a range. Example: 1,5, 22-30. |
Y |
|
Scan Output For |
If |
The Controller will process this field as a regular expression. |
Y |
|
JCL Location |
File and member name containing the JCL script. |
When you are using the JCL_LIBRARY feature, you can substitute the name of the library with a string starting with "&", that names the library specified in the uags.conf file with the JCL_library definitions. |
N |
|
New Jobclass |
New Jobclass to replace the one in the JCL member, allowing you to override the value in your JCL without having to modify the JCL. |
|
N |
|
New Jobname |
Job name that will replace the one in the JCL member, allowing you to override the value in your JCL without having to modify the JCL. |
This value should be validated before the job is launched to avoid JES start failures. Syntax:
|
N |
|
New Msgclass |
New MSGCLASS to replace the one in the JCL member. This allows you to override the value in your JCL from the Controller without having to modify the JCL. |
|
N |
|
Failure Only |
If |
Boolean; Valid values: true/false. Default is false. |
N |
|
Output File |
If |
|
Y |
|
Number of Lines |
If |
Integer; Default is the value of the Retrieve Output Default Maximum Lines Universal Controller system property. |
N |
|
Starting Line |
If |
Integer; Default is 1. |
N |
|
Scan Text |
If |
The Controller will process this field as a regular expression. |
N |
|
Automatic Output Retrieval |
Specification for whether you want the Controller to automatically retrieve any output from the job and attach it to the task instance record. |
Valid values: Default is NONE (1). Note If |
N |
|
Output Type |
If |
Valid values: Default is STDOUT (1). |
Y |
|
Override Instance Count for Deletion |
If |
Integer. Default is 1. |
Y |
|
JCL Override Location |
If |
The Agent will check this location for JCL before looking in the standard |
N |
|
Parameters |
Any arguments needed by the program to execute properly. |
Variables are supported. |
N |
|
Procedure Library |
Allows you to define a JES2 PROCLIB control statement in the job JCL. For example, a PROCLIB value of PROC01 will result in the following JES2 control statement generated in the job JCL: /*JESPARM PROCLIB=PROC001 The PROCLIB value must refer to a ddname defined in the JES2 procedure. Refer to IBM MVS JCL Reference for more information regarding the JES2 PROCLIB control statement. |
|
N |
|
Retry Indefinitely |
Specification for whether or not the Controller should continue trying indefinitely to run this task. If |
Boolean; Valid values: true/false. Default is false. |
N |
|
Retry Interval |
Number of seconds between each retry. |
Integer; Default is 60. |
N |
|
Maximum Retries |
Maximum number of times that the Controller should retry this task after it has started and gone to a failed state. |
Integer; Default is 0. |
N |
|
Suppress Intermediate Failures |
Specification for whether or not the following will be suppressed until all scheduled retry attempts have been made:
|
Boolean; Valid values: true/false. Default is false. |
N |
|
Schedule ID |
CA7 Schedule ID; for CA7 toleration only (see Special Processing on z/OS Tasks#CA7/CA11 Toleration). |
|
N |
|
Use JCL Override Library |
Specification for whether or not to allow the task to work with a JCL override library on the target system. |
Boolean; Valid values: true/false. Default is false. |
N |
|
Wait For Output |
If |
Boolean; Valid values: true/false. Default is false. |
N |