:RESTART

Use the :RESTART script statement to define a restart point in an executable object. When you start the object, you can use the restart point to start the execution at a particular point in the script instead of processing the entire script. Some script functions let you select restart points, and you can also use restart points when you define options for object execution. For more information, see Restarting Tasks.

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

Syntax

:RESTART Restart Point [, Restart Text]

Parameters

• :RESTART
  Defines a restart point

• Restart Point
  Name of the restart point
  Format: name without quotation marks, maximum 8 characters

• Restart Text
  (Optional) Description of the restart point
  If you define a text here, this description is written to the execution report as additional information.
  Format: Script literal or script variable, maximum 24 characters

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

Example

The following example defines a restart point called REORG, and includes a text (Start Reorganization) to provide additional information in the execution report.

:RESTART REORG,"Start Reorganization"

See also: