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
See also: