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 restartA restart refers to the repetition of an object's execution. This action differs from a new start in some parts. point as defined in the scriptA particular Automation Engine object type..

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 reportA report provides more detailed information about a task's execution or a component. 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 objectAutomation Engine controlled activities and processes are structured in the form of objects. See also: Task.
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

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH