Restarting Tasks

The Restart option is available for active, blocked and ended tasks.

Starting vs Restarting

There are three main differences between starting and restarting a task:

Avoid repeating restarted tasks, as these are difficult to trace.

Restarting a task is possible from

To Restart a Task

  1. Do one of the following:

    • In the Process Monitoring perspective: Right-click the task and select Restart.
    • In the Process Assembly perspective: Select the object, click the arrow on the Execute toolbar button to expand the options and select Restart. Alternatively, right-click the object on the Explorer and select Execute>Restart.
  2. The Restart dialog is displayed, for example:

    You can define the following execution settings:

    Field Description
    Parameters
    Reference RunID

    You can indicate here the RunID of the execution that should be repeated. By default this field is populated with the RunID of either the highlighted task or the original execution.

    If you need the original RunID later on, you can see it on the details of the task.

    Restart Point

    This determines the point in the script from which the process will be restarted.

    If you leave this field empty, the entire script will be reprocessed.

    Keep start type Activate this checkbox if you want the task to keep its start type. For example, if a group has been assigned to the object, restarting will take place within the group.
    Wait for manual release

    Before being actually executed, tasks go through the following phases: Activation, Generation and Transfer. Activate this checkbox if you want the task to go through them but stop after transferring because you want to control when to execute it.

    For details see Restarting Tasks.

    To Release the Task Manually

    There are several ways of releasing the task:

    • For Workflows, from the Explorer in the Process Assembly perspective:
      1. Right-click the object and select Last Monitor. The task is opened in the Process Monitoring perspective in edit mode.

      2. Open the Modify... button on the upper left corner of the window and select Release manually.

        Before releasing the task you can modify its parameters. These changes apply to the current execution only.

    • For other executable objects, from the Tasks table in the Process Monitoring perspective.
      1. The task is already available in the list. Search for it as follows.
        1. Click the Filter button on the toolbar to toggle on the filter pane.
        2. Open the Status tab and expand the WAITING options.
        3. Activate Waiting for manual release.
      2. The task is displayed on the list. Right-click it and select Release manually.
    Queue

    You can assign a particular queue for this execution, which can be different to the one in the object's definition.

    If you leave this field empty, the object queue is used.

    Test Options
    Activate attributes dialog

    When you define an object type, you specify the general attributes that will always apply to objects with this type. In some cases, however, it might be necessary to change specific settings for a particular run of an object without modifying its general definitions.

    If you activate this checkbox, before the task is executed a dialog pops up displaying the attributes that can be changed for this particular run. These values apply only to this execution.

    Display in activation report

    Activating option in this section causes the script to be processed and overrules the Generat at Runtime settings defined for the object in the General - Runtime page.

    The activation report includes both the script statements and the content of all involved Include objects. In the case of jobs, also the job includes such as Header and Trailer.

    Generated JCL Activate it to display the JCL in the report.

    After clicking the Execute button, the task is activated and the report opens. This allows you to check and, if necessary, modify it.

    You can use this in combination with the Wait for manual release option. When you are happy with the results you can release the task for execution.

    Original script

    Activate it to display the script in the report.

    After clicking the Execute button, the task is activated and the report opens. This allows you to check and, if necessary, modify it.

    You can use this in combination with the Wait for manual release option. When you are happy with the results you can release the task for execution.

    Modifications of variables

    When testing your object definitions, you may want to modify your variables and check the results before actually executing them. Activate this option if you want those changes to be displayed in the activation report.

    Modifications of attributes When testing your object definitions, you may want to modify their attributes and check the results before actually executing them. Activate this option if you want those changes to be displayed in the activation report.
  3. Click Restart.

  4. If the Activate attributes dialog checkbox is activated, a dialog pops up where you can enter specific attribute settings for this run.

    If any of the other test options is activated, a message opens prompting you to confirm that you want to execute the task after the script has been generated.

Easy Configuration and Automation or Restarts

Use the following script elements for this purpose:

Script elements Description
Script element Description

:GENERATE

This controls the processing of scripting lines during the execution of a script.

:RESTART

This is used to set restart points in an executable object.

RESTART_UC_OBJECT

Repeats the execution of a task.

SYS_ACT_RESTART

Retrieves whether the object has been activated in restart mode.

SYS_ACT_RESTART_ME_NR

Returns the run number (RunID) of an object that has been activated in restart mode.

SYS_LAST_RESTART_POINT

Supplies the name of the previous restart point in the script.

SYS_LAST_RESTART_TEXT

Supplies the text of the previous restart point as defined in the script.

SYS_RESTART_POINT

Supplies the restart point from which the object will be executed.