SYS_LAST_RESTART_POINT

Use the SYS_LAST_RESTART_POINT script function to retrieve the name of restart point from the last processed :RESTART statement.

Notes:

Use the :RESTART script statement to set restart points.
Restart points define the line from which the script is processed when the task restarts.

Tip: Retrieve the details of the last restart point and include the information in notifications as a part of your error handling procedures.

Syntax

SYS_LAST_RESTART_POINT ()

Return Codes

The script function returns the name of the restart point that has last been run through.
If no restart points have been specified, the script function returns a blank.

Example

In the following example, the script retrieves the name of the previous restart (BIN), and writes the name in the activation report.

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

:SET &RET# = SYS_LAST_RESTART_POINT()
:PRINT "Last restart point: &RET#"

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