:RESTART

Use the :RESTART script statement to define a restart point in an executable object. When starting the object, you can use the restart point to begin execution at a specific point in the script rather than processing the entire script. Some script functions let you select restart points, and you can also specify restart points when defining options for object execution. For more information, see Restarting Tasks.

Important! The :GENERATE script statement includes parameters that control whether and how restart points are considered when a task is restarted. For more information, see :GENERATE.

Tip: Use the SYS_LAST_RESTART_POINT and SYS_LAST_RESTART_TEXT script functions to read the last passed restart point and restart text.

Syntax

: RESTART Restart Point [, Restart Text]

Parameters

Parameter	Description	Format
Restart Point	Name of the restart point. Maximum 8 characters.	Name without quotation marks
Restart Text (Optional)	Description of the restart point. When defined, this text is written to the execution report as additional information. Maximum 24 characters.	Script literal or script variable

Examples

The following example defines a restart point named REORG with a descriptive text that appears in the execution report.

: RESTART REORG, "Start Reorganization"