Versions Compared

Key

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

...

Step 1

From the Automation Center navigation pane, select Tasks > z/OS Tasks. The z/OS Tasks list displays.

Step 2

Select the task for which you want to create one or more Restart Criteria. The z/OS Task Details for that task displays.
 

Step 3

In the Auto-Restart Option field, select Use Restart Criteria from the drop-down list and then click the  button.

Anchor
Restart Criteria list
Restart Criteria list
Step 4

Click the Restart Criteria tab. The Restart Criteria list displays.
 

Anchor
Restart Criteria Details
Restart Criteria Details
Step 5

Click . Restart Criteria Details displays.
 

Step 6

Using the field descriptions provided below as a guide, complete the fields as needed.

Step 7

Click the  button to save the record and return to the Restart Criteria list 63561004.

Step 8

If appropriate, repeat these steps for any additional Restart Criteria that you want to add.

...

The following table describes the fields and buttons in the Restart Criteria Details 63561004.
 

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

Anchor
Auto-Restart Option
Auto-Restart Option
Auto-Restart Option

Method of step selection to perform for the restart. See Restart Criteria Logic 63561004, below, for an explanation of the options.

Anchor
Directives List
Directives List
Directives List

(See Restart Criteria Details - Directives 63561004, below.)

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 Restart Criteria Details that let you perform various actions.

Save

Saves a new 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.

Update

Include Page
IL:Update button
IL:Update button

Delete

Include Page
IL:Delete button
IL:Delete button

Refresh

Refreshes any dynamic data displayed in the Details.

Close

For pop-up view only; closes the pop-up view of this record.

...

Note
titleNote

The Controller searches Restart Criteria definitions based on their order in the Restart Criteria list 63561004; the definition at the top of the list is searched first. To change the order of the definitions in the list, drag and drop them to any location.

...

Restart From First Job Step

All restartable job steps, from first to last, will be selected for restart.

Restart From Matching Job Step

All restartable job steps, from the step that matched the Restart Criteria to the last job step, will be selected for restart.

Restart Using Directives

Job steps will be selected for restart based on the directives specified in the Restart Criteria directive table.

Anchor
Restart Criteria Details - Directives
Restart Criteria Details - Directives

Restart Criteria Details - Directives

The following table describes the fields and button in the Directives section of the Restart Criteria Details 63561004.

Field Name

Description

Directive

Specifies a directive for step selection.
 
Options:

  • Start - Directive used to specify the starting step in a range of steps selected for restart. The directive table can contain zero or one Start directives. If a start directive is not specified, the first job step will be used as the starting step.
  • Skip - Directive used to specify a step that should be skipped. Skipped steps will not be restarted. The directive table can contain zero or more Skip directives.
  • End - Directive used to specify the ending step in a range of steps that will be selected for restart. The directive table can contain zero or one End directives. If an end directive is not specified, the last job step will be used as the ending job step.

Step

The directive step optionally specifies:

  1. A relative step number. Relative step numbers begin with + or -, followed by some number of steps to offset from the step matched by the Restart Criteria. A value of -0 or +0 indicated that the directive is referring to the job step that matched the Restart Criteria.
     
    Relative step numbers are mutually exclusive with the Procedure field.
     
    If a relative step number is specified, no matching is performed. The directive will apply to an explicit offset from the job step that matched the Restart Criteria definition.
  2. The 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.

Procedure

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

Add button

Adds the directive defined by the fields above to the directive table.

...