SYS_RESTART_POINT

Script Function: Supplies the restart point from which the object will be executed

Syntax

SYS_RESTART_POINT ()

Return codes
Name of the restart point " " - The script is not executed from a particular restart point or generally not in restart mode.

Comments

This script function retrieves the restart point from which the script should  be processed when a task was started with Execute..., thereby having specified a restart point.

Restart points are set using the script element :RESTART.

Example

In the following example, files are copied from the AE directory. When the job is restarted with "DB" being indicated as restart point, only files from the database directory (including all sub-directories) will be copied. A corresponding message is written in the activation report.

:RESTART BIN, "Program directory"  
COPY C:\AEG\BIN\*.* C:\BACKUP\AEG\BIN\*.* /Y
:INC DOS.ERRORLEVEL

:RESTART DB, "Database directory"  
XCOPY C:\AEG\DB\*.* C:\BACKUP\AEG\DB\*.* /E /Y
:INC DOS.ERRORLEVEL

:SET &RET# = SYS_RESTART_POINT()
:PRINT "Script was processed from &RET# on."

See also:

Script element	Description
:RESTART	This is used to set restart points in an executable object.
RESTART_UC_OBJECT	Repeats the execution of a task.
SYS_ACT_RESTART	Determines if the object was 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.

Script Elements - Activation Data

About Scripts
Script Elements - Alphabetical Listing
Script Elements - Ordered by function