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