Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Condition

Connector Format

Description

Success

Solid black line

Run the successor task if the predecessor task goes to Success.

Failure

Dotted black line

Run the successor task if the predecessor task goes to Failure.

Success/Failure

Dotted black line

Run the successor task if the predecessor task goes to Success or Failure.

VariableDotted black line

Run the successor task if the variable condition specified in the variable window is met. 

Note

For workflow edge variable conditions that use functions to evaluate STDOUT, STDERR, FILE, or JOBLOG output, you must enable Wait For Output when setting up Automatic Output Retrieval.
Furthermore, the evaluation of workflow edge variable conditions happens prior to performing Set Variable Actions on task instance Success and Failed statuses, therefore, evaluation will not take these updates into consideration.

Anchor
Exit Codes
Exit Codes
Exit Code(s)

Dotted black line

Run the successor task if the predecessor task returns one of the specified exit code(s). Format: Numeric. Use commas to list a series of exit codes; use hyphens to specify a range. Example: 1,5, 22-30.

Step Conditions

Dotted gray line

For predecessor z/OS tasks only: Run the successor task if the running predecessor z/OS task has a step end matching the specified Step Condition(s).

...

Step 1

Hover your mouse over the connection to view the currently selected condition. If you want to change the condition, right-click the connection to display a Connector Actions menu.

Step 2

Select Conditions. The Conditions dialog displays.
 
Image RemovedImage Added

Step 3

Specify a condition (as supported for each task type).

Step 4

If you selected Step Condition(s) for a connection to a predecessor z/OS task, click the View/Edit... button to display a Step Conditions dialog that lets you define the step conditions.
 
Image RemovedImage Added
 
Using the field descriptions below as a guide, complete the fields and click OK.

Step 5

Click OK on the Conditions dialog.

Step 6

To see the condition that is specified for a connection, hover your cursor over the connector (see Connector Graphics for All Condition Types, below).

...

Field Name

Description

Anchor
Step
Step
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.

Anchor
Procedure
Procedure
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.

Anchor
Program
Program
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.

Anchor
Condition Codes
Condition Codes
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 (-) 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.
 
For example: 1,6-4095,Sxxx,Unnnn,JCLERR

Variable Conditions

Variable Conditions are available for all task types. Variable Conditions support Variables and Functions.

 At runtime, the First Value and Second Value will be resolved and evaluated based on the Operator specified. If the First Value and/or Second Value stay unresolved, the edge will be skipped automatically, without further evaluation.

Specifying a Variable Condition

To specify a dependency condition for a connection between a predecessor and successor task:

Step 1

Hover your mouse over the connection to view the currently selected condition. If you want to change the condition, right-click the connection to display a Connector Actions menu.

Step 2

Select Conditions. The Conditions dialog displays.
 
Image Added

Step 3

Specify a condition (as supported for each task type).

Step 4

If you selected Step Condition(s) for a connection to a predecessor z/OS task, click the View/Edit... button to display a Step Conditions dialog that lets you define the step conditions.
 
Image Added
 
Using the field descriptions below as a guide, complete the fields and click OK.

Step 5

Click OK on the Conditions dialog.

Step 6

To see the condition that is specified for a connection, hover your cursor over the connector (see Connector Graphics for All Condition Types, below).

Anchor
Connector Graphics for All Condition Types
Connector Graphics for All Condition Types
Connector Graphics for All Condition Types

...