Before You Begin
The z/OS task allow you to run a platform-specific application on a z/OS machine. To run a z/OS task, you must first complete the following tasks:
- Install Universal Agent for z/OS on a z/OS machine.
- Launch the Agent. When the Agent connects with the Universal Controller, it automatically creates an Agent resource definition in the database.
- Optionally, customize the Agent heartbeat and log levels, as described in z/OS Agent Details Field Descriptions.
Built-In Variables
The following built-in variables can be used in a z/OS task to pass data where appropriate:
Creating a z/OS Task
Step 1 | From the Automation Center navigation pane, select Tasks > z/OS Tasks. The z/OS Tasks list displays a list of all currently defined z/OS tasks. |
---|---|
Step 2 | Enter/select Details for a new z/OS task, using the field descriptions below as a guide.
|
Step 3 | Click a Save button. The task is added to the database, and all buttons and tabs in the Task Details are enabled. |
Note
To open an existing record on the list, either:
- Click a record in the list to display its record Details below the list. (To clear record Details below the list, click the New button that displays above and below the Details.)
- Clicking the Details icon next to a record name in the list, or right-click a record in the list and then click Open in the Action menu that displays, to display a pop-up version of the record Details.
- Right-click a record in the a list, or open a record and right-click in the record Details, and then click Open In Tab in the Action menu that displays, to display the record Details under a new tab on the record list page (see Record Details as Tabs).
z/OS Task Details
The following z/OS Task Details is for an existing Linux/Unix task.
Depending on the values that you enter / select for these fields, and whether or not the z/OS task has ever been launched, more (or less) fields may display. See the field descriptions, below, for a description of all fields that may display in the z/OS Task Details.
z/OS Task Details Field Descriptions
The following table describes the fields, buttons, and tabs that display in the z/OS Task Details.
Field Name | Description |
---|---|
General | This section contains general information about the task. |
Name | Unable to render {include} The included page could not be found. |
Version | Unable to render {include} The included page could not be found. |
Description | Unable to render {include} The included page could not be found. |
Member of Business Services | Unable to render {include} The included page could not be found. |
Resolve Name Immediately | Unable to render {include} The included page could not be found. |
Time Zone Preference | Unable to render {include} The included page could not be found. |
Hold on Start | Unable to render {include} The included page could not be found. |
Hold Reason | Unable to render {include} The included page could not be found. |
Virtual Resource Priority | Unable to render {include} The included page could not be found. |
Hold Resources on Failure | Unable to render {include} The included page could not be found. |
Agent Details | This section contains assorted detailed information about the Agent / Agent Cluster selected for this task. |
Agent | Unable to render {include} The included page could not be found. |
Agent Variable | Unable to render {include} The included page could not be found. |
Credentials | Unable to render {include} The included page could not be found. |
Credentials Variable | Unable to render {include} The included page could not be found. |
z/OS Details | This section contains assorted detailed information about the task. |
JCL Location | Unable to render {include} The included page could not be found. |
Use JCL Override Library | Allows the task to work with a JCL override library on the target system. If this option is selected, the Agent will check the JCL override path (specified in Creating and Running a z/OS Task#JCL Override Location) before submitting the job from Creating and Running a z/OS Task#JCL Location. |
JCL Override Location | Required if Creating and Running a z/OS Task#Use JCL Override Library is selected; Specifies the file and member name potentially containing an override JCL script. |
Delete Override JCL | Optional if Creating and Running a z/OS Task#Use JCL Override Library is selected; Allows the task to define criteria that will control the automated clean-up of the override JCL. If this option is not selected, the Controller and Agent will take no action to delete the override JCL from the target system. |
Override Instance Count for Deletion | Required if Creating and Running a z/OS Task#Delete Override JCL is selected; Specifies the number of successful override instances that must occur before the override JCL library member is deleted. Note Manual resubmissions of a task instance do not increment the tracked number of successful override instances that go towards satisfying the deletion criteria. |
Last Override Deletion | If Creating and Running a z/OS Task#Delete Override JCL is selected; system-supplied. Displays after the specified override JCL member is deleted. The date and time the last override JCL deletion occurred. |
Number of Override Instances | If Creating and Running a z/OS Task#Delete Override JCL is selected; Read only; system-supplied. Indicates the number of successful override instances that have occurred for this task. This number is checked against the deletion criteria to determine when the override JCL member should be deleted. Note This number is automatically reset to 0 by the system if a task instance does not submit from override JCL (that is, no override member was found). |
New Jobname | Unable to render {include} The included page could not be found. |
New Jobclass | Unable to render {include} The included page could not be found. |
New Msgclass | Unable to render {include} The included page could not be found. |
Procedure Library | Unable to render {include} The included page could not be found. |
Schedule ID | Unable to render {include} The included page could not be found. |
Parameters | Unable to render {include} The included page could not be found. |
Result Processing Details | This section contains assorted detailed information about result processing for this task. |
Exit Code Processing | Unable to render {include} The included page could not be found. Note If Step Conditions has been selected for Exit Code Processing, and you then select a different option, a confirmation pop-up displays to warn that any defined Step Conditions will be removed. |
Output Type | Unable to render {include} The included page could not be found. |
Scan Output For | Unable to render {include} The included page could not be found. |
Output File (for Creating and Running a z/OS Task#Exit Code Processing) | Unable to render {include} The included page could not be found. |
Exit Codes | Unable to render {include} The included page could not be found. |
Automatic Output Retrieval | Unable to render {include} The included page could not be found. |
Wait For Output | Unable to render {include} The included page could not be found. |
Failure Only | Unable to render {include} The included page could not be found. |
Start Line | Unable to render {include} The included page could not be found. |
Number of Lines | Unable to render {include} The included page could not be found. |
Scan Text | Unable to render {include} The included page could not be found. |
Output File (for Creating and Running a z/OS Task#Automatic Output Retrieval) | Unable to render {include} The included page could not be found. |
Retry Options | This section contains specifications for retrying the task. |
Auto-Restart Option | Unable to render {include} The included page could not be found. Note If Use Restart Criteria has been selected for Auto-Restart Option, and you then select a different option, a confirmation pop-up displays to warn that any defined Restart Criteria will be removed. |
Maximum Retries | Unable to render {include} The included page could not be found. |
Retry Indefinitely | Unable to render {include} The included page could not be found. |
Retry Interval (Seconds) | Unable to render {include} The included page could not be found. |
Suppress Intermediate Failures | Unable to render {include} The included page could not be found. |
Wait / Delay Options | This section contains specifications for waiting to start and/or delaying on start the task. |
Wait To Start | Unable to render {include} The included page could not be found. |
Wait Time | Unable to render {include} The included page could not be found. |
Wait Day Constraint | Unable to render {include} The included page could not be found. |
Wait Duration | Unable to render {include} The included page could not be found. |
Wait Duration In Seconds | Unable to render {include} The included page could not be found. |
Delay On Start | Unable to render {include} The included page could not be found. |
Delay Duration | Unable to render {include} The included page could not be found. |
Delay Duration In Seconds | Unable to render {include} The included page could not be found. |
Workflow Only | Unable to render {include} The included page could not be found. |
Time Options | This section contains time-related specifications for the task. |
Late Start | Unable to render {include} The included page could not be found. |
Late Start Type | Unable to render {include} The included page could not be found. |
Late Start Time | Unable to render {include} The included page could not be found. |
Late Start Day Constraint | Unable to render {include} The included page could not be found. |
Late Start Nth Amount | Unable to render {include} The included page could not be found. |
Late Start Duration | Unable to render {include} The included page could not be found. |
Late Finish | Unable to render {include} The included page could not be found. |
Late Finish Type | Unable to render {include} The included page could not be found. |
Late Finish Offset Type | Unable to render {include} The included page could not be found. |
Late Finish Percentage Offset ( + ) | Unable to render {include} The included page could not be found. |
Late Finish Duration Offset ( + ) | Unable to render {include} The included page could not be found. |
Late Finish Duration Offset Unit | Unable to render {include} The included page could not be found. |
Late Finish Time | Unable to render {include} The included page could not be found. |
Late Finish Day Constraint | Unable to render {include} The included page could not be found. |
Late Finish Nth Amount | Unable to render {include} The included page could not be found. |
Late Finish Duration | Unable to render {include} The included page could not be found. |
Early Finish | Unable to render {include} The included page could not be found. |
Early Finish Type | Unable to render {include} The included page could not be found. |
Early Finish Offset Type | Unable to render {include} The included page could not be found. |
Early Finish Percentage Offset ( - ) | Unable to render {include} The included page could not be found. |
Early Finish Duration Offset ( - ) | Unable to render {include} The included page could not be found. |
Early Finish Duration Offset Unit | Unable to render {include} The included page could not be found. |
Early Finish Time | Unable to render {include} The included page could not be found. |
Early Finish Day Constraint | Unable to render {include} The included page could not be found. |
Early Finish Nth Amount | Unable to render {include} The included page could not be found. |
Early Finish Duration | Unable to render {include} The included page could not be found. |
User Estimated Duration | Unable to render {include} The included page could not be found. |
Critical Path Options | This section contains Critical Path-related specifications for the task. |
CP Duration | Unable to render {include} The included page could not be found. |
CP Duration (Resolved) | Unable to render {include} The included page could not be found. |
CP Duration Unit | Unable to render {include} The included page could not be found. |
Workflow Execution Options | This section contains Execution Restriction specifications for the task if it is within a Workflow. |
Execution Restriction | Unable to render {include} The included page could not be found. |
Restriction Period | Unable to render {include} The included page could not be found. |
Before Date | Unable to render {include} The included page could not be found. |
Before Time | Unable to render {include} The included page could not be found. |
After Date | Unable to render {include} The included page could not be found. |
After Time | Unable to render {include} The included page could not be found. |
Date List | Unable to render {include} The included page could not be found. |
Statistics | This section contains time-related statistics for task instances of the task. |
First Execution | Unable to render {include} The included page could not be found. |
Last Execution | Unable to render {include} The included page could not be found. |
Last Instance Duration | Unable to render {include} The included page could not be found. |
Lowest Instance Time | Unable to render {include} The included page could not be found. |
Average Instance Time | Unable to render {include} The included page could not be found. |
Highest Instance Time | Unable to render {include} The included page could not be found. |
Number of Instances | Unable to render {include} The included page could not be found. |
Metadata | This section contains Metadata information about this record. |
UUID | Universally Unique Identifier of this record. |
Updated By | Name of the user that last updated this record. |
Updated | Date and time that this record was last updated. |
Created By | Name of the user that created this record. |
Created | Date and time that this record was created. |
Buttons | This section identifies the buttons displayed above and below the Task Details that let you perform various actions. |
Save | Saves a new task record in the Controller database. |
Save & New | Saves a new record in the Controller database and redisplays empty Details so that you can create another new record. |
Save & View | Saves a new record in the Controller database and continues to display that record. |
New | Displays empty (except for default values) Details for creating a new task. |
Update | Unable to render {include} The included page could not be found. |
Launch Task | Unable to render {include} The included page could not be found. |
View Parents | Unable to render {include} The included page could not be found. |
Copy | Creates a copy of this task, which you are prompted to rename. |
Delete | Unable to render {include} The included page could not be found. Note You cannot delete a task if it is either:
|
Refresh | Refreshes any dynamic data displayed in the Details. |
Close | For pop-up view only; closes the pop-up view of this task. |
Tabs | This section identifies the tabs across the top of the Task Details that provide access to additional information about the task. |
Step Conditions | Unable to render {include} The included page could not be found. |
Restart Criteria | Displays a list of all restart criteria defined for this task. |
Variables | Unable to render {include} The included page could not be found. |
Actions | Unable to render {include} The included page could not be found. |
Virtual Resources | Unable to render {include} The included page could not be found. |
Mutually Exclusive | Unable to render {include} The included page could not be found. |
Instances | Lists all instances of the task. |
Triggers | Unable to render {include} The included page could not be found. |
Notes | Unable to render {include} The included page could not be found. |
Versions | Unable to render {include} The included page could not be found. |
Viewing a z/OS Task Instance
When a z/OS task is launched, the Controller creates a task instance record of that task.
A task instance contains detailed information about a single execution of that task.
You can access a task instance from:
- Instances tab on the Creating and Running a z/OS Task#z/OS Task Details for that task
- Activity Monitor
- Task Instances list
z/OS Task Instance Details
The following z/OS Task Instance Details contains information on the successful completion of a z/OS task.
z/OS Task Instance Details Field Descriptions
The following table describes the fields, buttons, and tabs that display in z/OS Task Instance Details.
Field Name | Description |
---|---|
General | This section contains general information about the task instance. |
Instance Name | Name of this task instance. |
Instance Number | Unable to render {include} The included page could not be found. |
Description | Unable to render {include} The included page could not be found. |
Member of Business Services | Unable to render {include} The included page could not be found. |
Task | Unable to render {include} The included page could not be found. |
Source Version | Unable to render {include} The included page could not be found. |
Launch Source | Unable to render {include} The included page could not be found. |
Source Instance | Unable to render {include} The included page could not be found. |
Invoked by | Unable to render {include} The included page could not be found. |
Execution User | Unable to render {include} The included page could not be found. |
Calendar | Unable to render {include} The included page could not be found. |
Time Zone Preference | Unable to render {include} The included page could not be found. |
Virtual Resource Priority | Unable to render {include} The included page could not be found. |
Hold Resources on Failure | Unable to render {include} The included page could not be found. |
Status | This section contains information about the current status of the task instance. |
Status | Unable to render {include} The included page could not be found. |
Exit Code | Unable to render {include} The included page could not be found. |
Status Description | Unable to render {include} The included page could not be found. |
Operational Memo | Unable to render {include} The included page could not be found. |
Evaluation Time | Unable to render {include} The included page could not be found. |
Critical | Unable to render {include} The included page could not be found. |
Wait Until Time | Unable to render {include} The included page could not be found. |
Queued Time | Unable to render {include} The included page could not be found. |
Trigger Time | Unable to render {include} The included page could not be found. |
Launch Time | Unable to render {include} The included page could not be found. |
Start Time | Unable to render {include} The included page could not be found. |
End Time | Unable to render {include} The included page could not be found. |
Duration | Unable to render {include} The included page could not be found. |
CPU Time | Unable to render {include} The included page could not be found. |
Job ID | Job identifier of the job executed by the task instance. |
Job Name | Name of the job executed by the task instance. |
Agent Details | This section contains assorted detailed information about the Agent / Agent Cluster selected for this task. |
Agent | Unable to render {include} The included page could not be found. |
Agent Variable | Unable to render {include} The included page could not be found. |
Credentials | Unable to render {include} The included page could not be found. |
Credentials Variable | Unable to render {include} The included page could not be found. |
z/OS Details | This section contains assorted detailed information about the task instance. |
JCL Location | Unable to render {include} The included page could not be found. |
Use JCL Override Library | Allows the task to work with a JCL override library on the target system. If this option is selected, the Agent will check the JCL override path (specified in Creating and Running a z/OS Task#JCL Override Location) before submitting the job from Creating and Running a z/OS Task#JCL Location. |
JCL Override Location | If Creating and Running a z/OS Task#Use JCL Override Library is selected; Required. Specifies the file and member name potentially containing an override JCL script. |
Delete Override JCL | If Creating and Running a z/OS Task#Use JCL Override Library is selected; Optional. Allows the task to define criteria that will control the automated clean-up of the override JCL. If this option is not selected, the Controller and Agent will take no action to delete the override JCL from the target system. |
Submitted JCL Location | System-supplied; actual path that was used for job submission. |
Override Instance Count for Deletion | If Creating and Running a z/OS Task#Delete Override JCL is selected; Required. Specifies the number of successful override instances that must occur before the override JCL library member is deleted. Note Manual resubmissions of a task instance do not increment the tracked number of successful override instances that go towards satisfying the deletion criteria. |
Number of Override Instances | If Creating and Running a z/OS Task#Delete Override JCL is selected; Read only; system-supplied. Indicates the number of successful override instances that have occurred for this task. This number is checked against the deletion criteria to determine when the override JCL member should be deleted. Note This number is automatically reset to 0 by the system if a task instance does not submit from override JCL (that is, no override member was found). |
New Jobname | Unable to render {include} The included page could not be found. |
New Jobclass | Unable to render {include} The included page could not be found. |
New Msgclass | Unable to render {include} The included page could not be found. |
Procedure Library | Unable to render {include} The included page could not be found. |
JCL Changes Confirmed | If Creating and Running a z/OS Task#Status = Confirmation Required; indicates that JCL changes have been confirmed. You cannot rerun a job if this field is not selected. |
Schedule ID | Unable to render {include} The included page could not be found. |
Parameters | Unable to render {include} The included page could not be found. |
Result Processing Details | This section contains assorted detailed information about result processing for this task. |
Exit Code Processing | Unable to render {include} The included page could not be found. Note If Step Conditions has been selected for Exit Code Processing, and you then select a different option, a confirmation pop-up displays to warn that any defined Step Conditions will be removed. |
Output Type | Unable to render {include} The included page could not be found. |
Scan Output For | Unable to render {include} The included page could not be found. |
Output File (for Creating and Running a z/OS Task#Exit Code Processing) | Unable to render {include} The included page could not be found. |
Exit Codes | Unable to render {include} The included page could not be found. |
Automatic Output Retrieval | Unable to render {include} The included page could not be found. |
Wait For Output | Unable to render {include} The included page could not be found. |
Failure Only | Unable to render {include} The included page could not be found. |
Start Line | Unable to render {include} The included page could not be found. |
Number of Lines | Unable to render {include} The included page could not be found. |
Scan Text | Unable to render {include} The included page could not be found. |
Output File (for Creating and Running a z/OS Task#Automatic Output Retrieval) | Unable to render {include} The included page could not be found. |
Retry Options | This section contains specifications for retrying the task. |
Auto-Restart Option | Unable to render {include} The included page could not be found. Note If Use Restart Criteria has been selected for Auto-Restart Option, and you then select a different option, a confirmation pop-up displays to warn that any defined Restart Criteria will be removed. |
Maximum Retries | Unable to render {include} The included page could not be found. |
Retry Indefinitely | Unable to render {include} The included page could not be found. |
Retry Interval (Seconds) | Unable to render {include} The included page could not be found. |
Current Retry Count | Unable to render {include} The included page could not be found. |
Suppress Intermediate Failures | Unable to render {include} The included page could not be found. |
Next Retry Time | Unable to render {include} The included page could not be found. |
Wait / Delay Options | This section contains specifications for waiting to start and/or delaying on start the task. |
Wait To Start | Unable to render {include} The included page could not be found. |
Wait Time | Unable to render {include} The included page could not be found. |
Wait Day Constraint | Unable to render {include} The included page could not be found. |
Wait Duration | Unable to render {include} The included page could not be found. |
Wait Duration In Seconds | Unable to render {include} The included page could not be found. |
Delay On Start | Unable to render {include} The included page could not be found. |
Delay Duration | Unable to render {include} The included page could not be found. |
Delay Duration In Seconds | Unable to render {include} The included page could not be found. |
Time Options | This section contains time-related specifications for the task instance. |
Late Start | Unable to render {include} The included page could not be found. |
Started Late | Unable to render {include} The included page could not be found. |
Late Start Type | Unable to render {include} The included page could not be found. |
Late Start Time | Unable to render {include} The included page could not be found. |
Late Start Day Constraint | Unable to render {include} The included page could not be found. |
Late Start Nth Amount | Unable to render {include} The included page could not be found. |
Late Start Duration | Unable to render {include} The included page could not be found. |
Computed Late Start Time | Unable to render {include} The included page could not be found. |
Late Finish | Unable to render {include} The included page could not be found. |
Finished Late | Unable to render {include} The included page could not be found. |
Late Finish Type | Unable to render {include} The included page could not be found. |
Late Finish Offset Type | Unable to render {include} The included page could not be found. |
Late Finish Percentage Offset ( + ) | Unable to render {include} The included page could not be found. |
Late Finish Duration Offset ( + ) | Unable to render {include} The included page could not be found. |
Late Finish Duration Offset Unit | Unable to render {include} The included page could not be found. |
Late Finish Time | Unable to render {include} The included page could not be found. |
Late Finish Day Constraint | Unable to render {include} The included page could not be found. |
Late Finish Nth Amount | Unable to render {include} The included page could not be found. |
Late Finish Duration | Unable to render {include} The included page could not be found. |
Computed Late Finish Time | Unable to render {include} The included page could not be found. |
Early Finish | Unable to render {include} The included page could not be found. |
Finished Early | Unable to render {include} The included page could not be found. |
Early Finish Type | Unable to render {include} The included page could not be found. |
Early Finish Offset Type | Unable to render {include} The included page could not be found. |
Early Finish Percentage Offset ( - ) | Unable to render {include} The included page could not be found. |
Early Finish Duration Offset ( - ) | Unable to render {include} The included page could not be found. |
Early Finish Duration Offset Unit | Unable to render {include} The included page could not be found. |
Early Finish Time | Unable to render {include} The included page could not be found. |
Early Finish Day Constraint | Unable to render {include} The included page could not be found. |
Early Finish Nth Amount | Unable to render {include} The included page could not be found. |
Early Finish Duration | Unable to render {include} The included page could not be found. |
Projected Late | Unable to render {include} The included page could not be found. |
Critical Path Options | This section contains Critical Path-related specifications for the task. |
CP Duration | Unable to render {include} The included page could not be found. |
CP Duration (Resolved) | Unable to render {include} The included page could not be found. |
CP Duration Unit | Unable to render {include} The included page could not be found. |
Workflow Execution Options | This section contains Execution Restriction specifications for the task if it is within a Workflow. |
Execution Restriction | Unable to render {include} The included page could not be found. |
Restriction Period | Unable to render {include} The included page could not be found. |
Before Date | Unable to render {include} The included page could not be found. |
Before Time | Unable to render {include} The included page could not be found. |
After Date | Unable to render {include} The included page could not be found. |
After Time | Unable to render {include} The included page could not be found. |
Date List | Unable to render {include} The included page could not be found. |
Statistics | This section contains time-related statistics for the task instance. |
User Estimated End Time | Unable to render {include} The included page could not be found. |
Lowest Estimated End Time | Unable to render {include} The included page could not be found. |
Average Estimated End Time | Unable to render {include} The included page could not be found. |
Highest Estimated End Time | Unable to render {include} The included page could not be found. |
Projected End Time | System-supplied; projected end time of the task instance, calculated by the Controller based on the projected end time of its predecessor (or the maximum projected end time of all its predecessors, if more than one path exists to that task instance) plus its estimated critical path duration. |
Metadata | This section contains Metadata information about this record. |
UUID | Universally Unique Identifier of this record. |
Updated By | Name of the user that last updated this record. |
Updated | Date and time that this record was last updated. |
Created By | Name of the user that created this record. |
Created | Date and time that this record was created. |
Status History | History of all statuses that the task instance has gone through. |
Buttons | This section identifies the buttons displayed above and below the Task Instance Details that let you perform various actions. |
Update | Unable to render {include} The included page could not be found. |
Force Finish | Unable to render {include} The included page could not be found. |
Hold | Unable to render {include} The included page could not be found. |
Skip | Unable to render {include} The included page could not be found. |
Re-run | Unable to render {include} The included page could not be found. |
View Parent | Unable to render {include} The included page could not be found. |
Retrieve Output | Unable to render {include} The included page could not be found. |
Delete | Unable to render {include} The included page could not be found. |
Refresh | Refreshes any dynamic data displayed in the Details. |
Close | For pop-up view only; closes the pop-up view of this task instance. |
Tabs | This section identifies the tabs across the top of the z/OS Task Instance Details that provide access to additional information about the task instance. |
Step Conditions | Unable to render {include} The included page could not be found. |
Restart Criteria | Displays a list of all restart criteria defined for this task. |
Restartable Job Steps | (See Re-running a z/OS Task.) |
Confirm JCL Changes | (See Re-running a z/OS Task.) |
Virtual Resources | Unable to render {include} The included page could not be found. |
Exclusive Requests | Unable to render {include} The included page could not be found. |
Output | Unable to render {include} The included page could not be found. |
Notes | Unable to render {include} The included page could not be found. |
Running a z/OS Task
You can run a z/OS task:
- Manually, by clicking the Launch Task or Launch Task with Variables button in the z/OS tasks list or z/OS Task Details Action menu.
- As part of a Workflow.
- Specify triggers that run the task automatically based on times or events.
Monitoring Task Execution
You can monitor all system activity from the Activity Monitor and can view activity history from the History list.