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