Automation Engine Script Guide > Ordered by Function > Activation Data > SYS_LAST_RESTART_TEXT

SYS_LAST_RESTART_TEXT

Script Function: Supplies the text of the previous restart point as defined in the script.

Syntax

SYS_LAST_RESTART_TEXT()

Return codes

Text of the restart point that has last been passed.
"Restart Point Name of the restart point" - A restart point without text has been defined
" " - No restart points have been defined

Comments

Restart points are set using the script element :RESTART.

Examples

In the following example, files are copied from an AE directory. "Program directory" is written in the activation report as it is the restart text referring to the previous restart point.

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

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

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

The second example supplies the result "Restart Point BIN" as no text was specified for the restart point.

:RESTART BIN
:SET &RET# = SYS_LAST_RESTART_TEXT()
:PRINT &RET#

 

See also:

Script element Description

:RESTART

This is used to set restart points in an executable object.
SYS_LAST_RESTART_POINT Supplies the name of the previous restart point in the script.

Script Elements - Activation Data

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