Automation Engine Script Guide > Ordered by Function > Script Structure and Processing > :RESTART

:RESTART

Script Statement: This statement sets restart points in an executable object.

Syntax

:RESTART Restart Point, [Restart Text]

Syntax

Description/Format

Restart Point

The name of the restart point.
Format: restart point name without quotation marks
Maximum of 8 characters

Restart Text

The description of the restart point.
Format: script literal or script variable
Maximum of 24 characters

Comments

You use the :RESTART statement to set restart points in an executable object. Restart points allow you to start an executable object from a particular position. You can define them when you execute objects with options.

The Restart Text can be used to describe the restart point. This description is written to the execution protocol as additional information. Restart Text is an optional parameter.

Note that script handling in restarts depends on the script statement :GENERATE. If you do not use this script statement, all script lines are processed until the very first :RESTART statement and additionally all lines are processed that are positioned after the indicated restart point.

The script functions SYS_LAST_RESTART_POINT and SYS_LAST_RESTART_TEXT can be used to read the restart point that has last been passed including its restart text.

Examples

The following example defines a restart point and a Restart Text.

:RESTART REORG,"Start Reorganization"

 

See also:

Script element Description

:GENERATE

This statement controls the processing of script lines during the execution of a script.
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 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.

Script Elements - Script Structure and Processing

Restarting Executable Objects

About Scripts
Script Elements - Alphabetical Listing

Script Elements - Ordered by function