n/a

Alias used for the task to be inserted within the workflow; specifically, the value of ops_exec_workflow_vertex.name.

N

Task Name

Name of the task to be inserted within the workflow.
 
Example: <task sysId="true">a8756a120a00010357097d05fa5c558e</task>

Y

n/a

Vertex ID of the task to be inserted within the workflow.
 
Each task within a Workflow must have a unique Vertex ID to distinguish it from other tasks, if any, of the same name.

Y

vertexX

n/a

x-coordinate of the task to be inserted within the workflow.

Default is 0.

N

vertexY

n/a

y-coordinate of the task to be inserted within the workflow.

Default is 0.

N

n/a

Dependency condition between the source and target tasks of this edge (connector).
 
Example: <condition type="Exit Code">123</condition>

Valid values:

• Success

• Failure

• Success/Failure

• Exit Code; Format: Numeric. Use commas to list a series of exit codes; use hyphens to specify a range. Example: 1,5, 22-30

• Step Conditions; Format: Step:Procedure:Program:Condition codes. Example: *:*:*:JCLERR

• Variable

Default is Success.
 
For example:
 
   <condition>Success</condition>
   <condition>Failure</condition>
   <condition>Success/Failure</condition>
   <condition>1,5,22-30</condition>
   <condition>*:*:*:JCLERR</condition>
   <condition>S1:PROC1:PGM1:U016</condition>
   <condition type="Exit Code">1,5,22-30</condition>
   <condition type="Step Condition">*:*:*:JCLERR</condition>
   <condition type="Step Condition">*:*:*:S0C4</condition>
   <condition type="Step Condition">S1:PROC1:PGM1:U016</condition>
   <variableCondition>
           <firstValue>${_varToLowerCase('variableName')}</firstValue>
           <operator>=</operator>
           <secondValue>${var2}</secondValue>
   </variableCondition>

Step Condition is valid for z/OS tasks only.
 
Success/Failure and Failure are not valid for Workflow, Timer, and Manual tasks.
 

Y

n/a

If straightEdge is false; x and y coordinates of the Edge angles.

For example:
 

Y

n/a

Vertex ID of the source task.
 
Example: <sourceId taskName="Sleep 10"taskAlias="Sleep 10-alias">20</sourceId>

Y

n/a

Specification for whether the edge is straight or bent.

Boolean; Valid values: true/false. Default is true.

N

n/a

Vertex ID of the target task.
 
Example: <targetID taskName="Sleep 10"taskAlias="Sleep 10-alias">20</targetId>

Y

First Value

First Value of the condition evaluation.

Default is an empty/blank string.

N

operator

Operator

Operator of the condition evaluation.

Valid values:

• As String = , As Value 1.

• As String != , As Value 2.

• As String > , As Value 3.

• As String >= , As Value 4.

• As String <, As Value 5.

• As String <= , As Value 6.

• As String regex , As Value 7.

• As String contains , As Value 8.

Default is =(1).

N

Second Value

Second Value of the condition evaluation.

Default is an empty/blank string.

N

Program

Program name to match.

A blank value or an asterisk ( * ) will match any program name. Generic matching characters asterisk ( * ) and question mark ( ? ) match zero or more characters and one character, respectively.

N

Procedure

Procedure step name to match.

A blank value or an asterisk ( * ) will match any procedure step name. Generic matching characters asterisk ( * ) and question mark ( ? ) match zero or more characters and one character, respectively.

N

Action

Action to take and the task status to set if the Step Condition matches.

Valid values:

• As String = Continue/Success, As Value = 1

• As String = Continue/Failed, As Value = 2

• As String = Halt/Failed, As Value = 3

• As String = Askoper, As Value = 4

Default is Continue/Success (1).

N

Condition Codes

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 ( - ) separating the lower and upper bounds of the range. The z/OS job step return code range is 0-4095. ABEND codes are specified directly as either a user ABEND or a system ABEND. The ABEND code must be specified verbatim including leading zeroes.

Y

Step

Job step name to match.

A blank value or an asterisk ( * ) will match any job step name. Generic matching characters asterisk ( * ) and question mark ( ? ) match zero or more characters and one character, respectively.

N

Evaluation Order

Order for step condition evaluation.

Step conditions with a lower order are evaluated before step conditions with a higher order.

N

n/a

sys_id used within the Controller to identify this Step Condition.

N

Task

Name of a task. In combination with the vertexId, 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.

N

Agent

If 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.

N

agentVar

Agent Cluster

If 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.

N

agentClusterVar

Agent Cluster Variable

Name of a variable that will be resolved at run time to the name of the Agent Cluster to use.

N

agentCluster

Agent Variable

Name of a variable that will be resolved at run time to the name of the Agent to use.

N

agent

Description

Description of this System Operation Step Action.

N

Command

If operation is Run Task Instance Command; Type of task instance command to run.

Valid values:

• As String = Cancel, As Value = 1

• As String = Force Finish, As Value = 2

• As String = Force Finish (Halt), As Value = 3

• As String = Force Finish/Cancel, As Value = 4

• As String = Force Finish/Cancel (Halt), As Value = 5

• As String = Skip, As Value = 6

• As String = Hold, As Value = 7

• As String = Release, As Value = 8

• As String = Release Recursive, As Value = 9

• As String = Clear All Dependencies, As Value = 10

• As String = Clear Exclusive, As Value = 11

• As String = Clear Predecessors, As Value = 12

• As String = Clear Resources, As Value = 13

• As String = Unskip, As Value = 14

• As String = Clear Timewait, As Value = 15

• As String = Re-run, As Value = 16

Default value is Cancel (1).

N

Instance Criteria

If operation is Run Task Instance Command; Additional criteria for selecting a specific task instance if multiple task instances have matching names.

Valid values:

• As String = Oldest Active Instance, As Value = 1

• As String = Newest Active Instance, As Value = 2

• As String = Oldest Instance, As Value = 3

• As String = Newest Instance, As Value = 4

Default is Oldest Active Instance (1).

• An Active task instance is an instance that is not in any of these statuses: Skipped, Finished, Success.

• An Unskip command can use only the Newest Instance and Oldest Instance criteria; an active instance cannot be unskipped.

N

Instance ID

If execLookupOption is Instance Id; ID of task instance to run the command against.

N

Instance Lookup Option

If operation is Run Task Instance Command; Specification for how to search for the task instance to run a command against.

Valid values:

• As String = Instance Name, As Value = 1

• As String = Instance Name/Task, As Value = 2

• As String = Instance Id, As Value = 3

• As String = Task, As Value = 4

Default is Instance Name (1).

N

Instance Name

If execLookupOption is Instance Name; Name of the task instance to run the command against.

N

Workflow Instance Name

If operation is Run Task Instance Command; Name of the parent workflow task instance that contains the task on which to perform the specified action.