Job Control Action Properties

Show Window Sample

The Job Control Action can be used to perform a number of job-related tasks. The following options are available.

Action to take

Click to view a list of available actions

Action

Description

Hold a job

Places the target job on hold. Can be used to hold the job that is executing the action, or another action.

Release a job

Releases the target job. Can be used to hold the job that is executing the action, or another action.

Restart the job from the beginning

Restarts the target job from the beginning. Applies only to the job that is executing the action.

This results in a new instance of the job being started. Subsequent steps in the original instance are not executed.

Run a job

Runs a job. The job can be started from any step.

The new job is executed asynchronously. That is, the Job Control action returns control immediately to the caller, without waiting for the target job to complete.

Terminate a job

Terminates (aborts) a running job.

Restart the step

Restarts the target step. Applies only to the step that is executing the action.

Run another step in the current job

Transfers control to another step in the current job.

Once control is transferred, execution continues from the new step. Execution doe

Delete a job

Deletes the target job. Can delete the job that is executing the action, or another job.

Note that if you delete the job that is executing the action, any executing instances (including the one responsible for the deletion) will continue executing until they complete.

Stop executing steps in this job

Instructs adTempus to stop automatically executing steps in the job. After this action is executed, you are responsible for executing subsequent steps as appropriate, using further Job Control actions.

Set the job's status to failed

Overrides normal success determination rules and sets the job's status to Failed.

Set the job's status to succeeded

Overrides normal success determination rules and sets the job's status to Succeeded.

Set the step's status to failed

Overrides normal success determination rules and sets the step's status to Failed.

Set the step's status to succeeded

Overrides normal success determination rules and sets the step's status to Failed.

Restart no more than __ times

This option is available only when the action is "Restart the job from the beginning" or "Restart the step."

When this option is selected, adTempus will limit the number of times that the job or step is restarted. Once the limit is exceeded, adTempus will not restart the job or step, and the "Restart limit exceeded" event will be fired.

Applies To

Determines whether the action applies to the current job  (the job that is executing the action) , another job on the same server, or a job on another computer. To target another job, you must have "Execute" authority for that job.

Step

This option is available only when the action is "Run a job" or "Run another step in the current job."

If the action is "Run a job" you may optionally specify the step at which execution should begin. If you do not select a step, the job is executed from the beginning.

If the action is "Run another step in the current job" you must specify the step to execute.

Checkpoint

This option is available only when the action is "Run a job" or "Run another step in the current job." You may optionally specify a checkpoint to be passed to the job or step.

Ignore conditions for the job

If this option is checked, adTempus will ignore any conditions that are defined for the target job (this forces the job to execute even if the conditions are not met). Conditions at the step level are not ignored (see next option).

Ignore conditions for individual steps

If this option is checked, adTempus will ignore any conditions that are defined for the target step, or for the steps of the target job (this forces the step(s) to execute even if the conditions are not met).

Force a new instance of the job if necessary

This option overrides the Multiple Instances option for the target job, forcing adTempus to start a new instance of the job even if another instance is already running.

Run the job even if it is held

If this option is checked, adTempus runs the target job regardless of whether it is held. If the option is not checked, the target job will not be run if it is held.

 

Job Control Action Overview