Do actions options

The following table lists the Do actions:

Take into consideration that some options might not appear in your properties pane, if they were not specified in the User View you applied. Use Control-M rules if the parameter rules were not specified by the Site Standard.

Do action

Description

Control-M rules

Notify

The Notify parameter specifies a notification to be sent a specific destination when the specified On Statement/Code criteria are satisfied.

For Destination parameters, see Destination parameters.

Set to OK

The Set to Ok parameter assigns the completion status of OK to a Job, regardless of its actual completion status.

 

Set to not OK

The Set to not OK parameter assigns a completion status of NOTOK to a Job when the On Statement/Code criteria are satisfied, regardless of the Job’s actual completion status.

 

Rerun Job

Indicates if an automatic rerun should be performed when the On Statement/Code criteria are satisfied.

 

Stop cyclic run

When specified, this parameter prevents subsequent iterations of the current cyclic Job.

 

Set Variable

The Set Variable assigns a value to a variable for use in a rerun of the Job when the On Statement/Code criteria are satisfied.

Type:

  • Local: Defines variables that can be used by other post-processing actions of the Job, such as messages, do-action arguments, or the script itself in the next run.
  • Global: Enables you to access the variables by its name which can be used by any Job.
  • Named Pool: Defines variables in a pool. The variable is referenced by the pool name - %%\\<named_pool>\<variable_name>.

    If Named Pool is selected, the Pool Name field appears. In the Pool Name field, type the name of the pool.

    You can use a local variable as a pool name which enables you to pass a pre-defined pool name to Jobs at order time.

Length:

  • Name: 1- 38 characters
  • Value:1-214 characters
  • z/OS only: The total length of Set Variable, including the %% prefix, variable-name, value, and the = sign, must not exceed 55 characters

Order Job (ignore scheduling criteria)

The Order Job parameter forces an individual Job or all Jobs in a Folder to be placed in Active Jobs (regardless of each Job’s Scheduling criteria) when the On Statement/Code criteria are satisfied. For information about sub parameters, see Order Job (ignore Scheduling Criteria).

Folder:

  • Length:

    1 through 20 characters

  • Invalid Characters:

    Blanks; single quotation marks

    OS/900: Non-English characters

Job Name:

  • Length:

    Computers other than z/OS: 1 through 20 characters.

    z/OS: 1 through 8 characters.

  • Invalid Characters:

    Blanks (embedded); single quotation marks

Date:

  • ODAT:

    Resolves to the original scheduling date of the Job resulting in the execution of this parameter (default).

  • specific date: dd-mm-yy

Handle Output

Indicates how the Job’s output should be handled when the On Statement and Code criteria are satisfied.

Options:

  • Copy
  • Delete
  • Move
  • Print

z/OS:

  • None
  • Change Jobs class
  • Delete output
  • Copy output
  • Move output

File name: Defines the name of the file.

 

Add/Remove condition

The Add/Remove Condition parameter specifies a prerequisite condition to be added or deleted when the On Statement/Code criteria are satisfied.

 

Name:

  • Length:

    1 to 255 characters

    z/OS: 1 through 39 characters

  • Case Sensitive:

    Yes.

  • Invalid Characters:

    Blanks; parentheses; "|" (pipe)

    Computers other than z/OS: Single quotation marks

  • Date: (four characters long) for the prerequisite condition.
  • Specific date (mmdd or ddmm format).
  • Order date: Automatically replaced by the Job’s original scheduling date when the Job is ordered.
  • Prev order date: Automatically replaced by the Job’s previous scheduling date when the Job is ordered (or for a forced Job, ODAT-1).
  • Next order date: Automatically replaced by the Job’s next scheduling date when the Job is ordered (or for a forced Job, ODAT+1).
  • Any date: Any condition date. For deleting a prerequisite condition, only. When specified, all prerequisite conditions with the specified condition name are deleted, regardless of their dates.
  • No date: Condition is not date-dependent.

    NOTE: Prev order date and Next order date cannot be specified when modifying details of a Job in the Active Jobs database. A date reference is required for each condition. However, order date can be specified when modifying details of a Job in the Active Jobs database.

Add/Remove: Indicates whether the conditions should be added (created) or removed.

Control-M Analyzer Rule

(z/OS only) Invokes a Control‑M/Analyzer rule to be executed.

Name:

  • Length:

    1 through 8 characters

  • Case Sensitive:

    Yes

  • Invalid Characters:

    Blanks; non-English characters

Argument:

  • Length:

    1 through 45 characters

  • Case Sensitive:

    Yes

  • Invalid Characters:

    Blanks; non-English characters

Set Restart Options

(Z/OS only) Job steps to be executed during restart of a Job

Parameters:

  • From program: First program step within the Job stream.
  • From procedure: First procedure step in the range. characters
  • To program: Last program step within the Job stream
  • To procedure: Last procedure step in the range.
  • Request automatically: Enables you to specify whether manual confirmation is required before the Job is restarted.

Parent Topic

Job actions