Creating Step Actions
Overview
You can specify actions to take on z/OS tasks in a Workflow based on step condition codes returned for any of the steps in that z/OS task.
Note
Currently, the only step action that you can take on z/OS tasks in a workflow is a System Operation.
Step actions can be defined only at the Workflow level. They apply to one, more, or all z/OS tasks in that immediate Workflow; they do not apply to any z/OS tasks in sub-workflows. (Every task in a Workflow has a unique Vertex ID, which is how you can tell one task from another if the Workflow has more than one of the exact same task.)
When you create a step action for a task in the Workflow, you specify the name of the task in the Task field. If there is more than one of those tasks in the Workflow, the Vertex Id drop-down list shows the Vertex Id for all tasks. So you can apply the step action to all tasks of that name in the Workflow or just the task with that Vertex Id.
In the Workflow Editor, when you right-click a task, there's a View/Edit Run Criteria selection for every task. For z/OS tasks, there's also a View/Edit z/OS Step Actions selection.
Every z/OS task is comprised of one or more steps. Each step in a z/OS task ends in a step condition code. System Operation step actions optionally let you send system notifications based on the outcome of each step action with options for None, Operation Failure, Operation Success/Failure, and Operation Success.
Creating a Step Action
Step 1 |
From the Automation Center navigation pane, select Tasks > Workflow Tasks. The Workflow Tasks list displays. |
---|---|
Step 2 |
Select the Workflow for which you want to create one or more step actions. The Workflow Task Details for that Workflow displays. |
Step 3 |
Click the Step Actions tab. The System Operation Step Actions list displays. |
Step 4 |
Click |
Step 5 |
Using the field descriptions, below, as a guide, complete the fields as needed. |
Step 6 |
Click the button to save the record and return to the Step Actions list. |
Step 7 |
If appropriate, repeat these steps for any additional step actions you want to add. |
System Operation Step Action Field Descriptions
The following table describes the fields and buttons in the System Operation Step Action Details.
Field Name |
Description |
---|---|
Step Action Criteria |
This section contains criteria for performing the step action. |
Task |
Name of a task. In combination with the Vertex Id, it specifies a specific task within the Workflow to which the step action applies; if no task is specified, the step action applies to all z/OS tasks within the Workflow. |
Vertex Id |
Numerical ID of the task that identifies it uniquely from other tasks of the same type in the Workflow. In combination with the Task, it specifies a specific task within the Workflow to which the step action applies.
|
Step |
Job step name to match. A blank value or an asterisk ( |
Procedure |
Procedure step name to match. A blank value or an asterisk ( |
Program |
Program name to match. A blank value or an asterisk ( |
Condition Codes |
Conditions codes are integer return codes from the program or ABEND codes. Integer return codes are specified as a comma-separated list of integer values or ranges. Ranges are specified with a dash ( |
Description |
Description of this System Operation Step Action. |
Step Action Details |
This section contains assorted detailed information about the step action. |
System Operation |
Specific system operation to perform.
Note For the Suspend Agent and Resume Agent operations, the user must have the following Agent permissions:
For the Suspend Agent Cluster, Resume Agent Cluster, Suspend Agent Cluster Membership, and Resume Agent Cluster Membership operations, the user must have the following Agent Cluster permissions:
|
System Notification |
Status of the specified system operation that will trigger a system notification.
Note The Controller must be configured for system notifications in order for system notifications to be triggered. |
Agent |
If System Operation is Suspend Agent, Resume Agent, Suspend Cluster Membership, Resume Cluster Membership, or Set Agent Task Execution Limit; Agent for which the system operation is to be performed. |
Agent Variable |
If System Operation is Suspend Agent, Resume Agent, Suspend Cluster Membership, Resume Cluster Membership, or Set Agent Task Execution Limit; Indication of whether the Agent field is a reference field for selecting a specific Agent (unchecked) or a text field for specifying the Agent as a variable (checked). |
Agent Cluster |
If System Operation is Suspend Agent Cluster, Resume Agent Cluster, Suspend Cluster Membership, Resume Cluster Membership, or Set Cluster Task Execution Limit; Agent Cluster for which the system operation is to be performed. |
Agent Cluster Variable |
If System Operation is Suspend Agent Cluster, Resume Agent Cluster, Suspend Cluster Membership, Resume Cluster Membership, or Set Cluster Task Execution Limit; Indication of whether the Agent Cluster field is a reference field for selecting a specific Agent Cluster (unchecked) or a text field for specifying the Agent Cluster as a variable (checked). |
Task Execution Limit |
If System Operation is Set Agent Task Execution Limit or Set Cluster Task Execution Limit; Specification for whether a Limited or Unlimited number of task instances can be run concurrently on the specified Agent / Agent Cluster. (Default is Unlimited.) |
Virtual Resource |
If System Operation is Set Virtual Resource Limit; Virtual resource for which a virtual resource limit is to be set. Note If the Strict Business Service Membership Read Constraints Universal Controller system property is true, the drop-down list displays only Virtual Resources for which the user has explicit Read permission. |
Virtual Resource Variable |
If System Operation is Set Virtual Resource Limit; Indication of whether the Virtual Resource field is a reference field for selecting a specific Virtual Resource (unchecked) or a text field for specifying the Virtual Resource as a variable (checked). |
Limit |
If System Operation is Set Agent Task Execution Limit or Set Cluster Task Execution Limit, and Task Execution Limit is Limited; Number of tasks that can be run concurrently by the specified Agent / Agent Cluster. |
Command |
If System Operation is Run Task Instance Command; Type of task instance command to run.
|
|