|
Timer - Stop |
Declaration
<AMTIMER ACTIVITY="stop" RESULTVARIABLE="text" SCALE="text (options)" SESSION="text" />
Description
Stops a timer session that was previously started using a Timer - Start step and populates a variable with the elapsed time.
Practical Usage
Used in conjunction with the Timer - Start activity to record the elapsed execution time. A Timer - Read activity can be used prior to this step to record the elapsed time without stopping the timer.
Parameters
General
Property | Type | Required | Default | Markup | Description |
---|---|---|---|---|---|
Populate variable with elapsed time | Text | Yes | (Empty) | RESULTVARIABLE="myVar" | The
name of an existing variable to populate with the elapsed time. NOTE: Calculation
is based on the total amount of time that passed between the start
of a previous Start Timer activity and the start of this activity. |
Time Scale | Text (options) | No | Seconds | SCALE="minutes"
|
The
time scale to be used in calculating the elapsed time. The available
options are:
|
Session | Text | Yes | TimerSession1 | SESSION="TimeSess2" | The session name previously established by a Timer - Start step that this activity should associate with. Timer sessions allow several timer-based operations to run simultaneously within a single task. This parameter's default value is TimerSession1. |
Example
- The sample AML code below can be copied and pasted directly into the Steps Panel of the Task Builder.
- Parameters containing user credentials, files, file paths, and/or other information specific to the task must be customized before the sample code can run successfully.
Description
This sample task illustrates execution of the Timer - Start, Timer - Stop, and Timer - Read activities.
<AMVARIABLE NAME="timeVar" />
<AMTIMER SESSION="myTime" />
<AMSHOWDIALOG MESSAGE="This step is used primarily to increase the elapsed time. Press Ok to proceed." />
<AMTIMER ACTIVITY="read" RESULTVARIABLE="timeVar" SESSION="myTime" />
<AMSHOWDIALOG>The task execution time to this point is %timeVar% seconds.</AMSHOWDIALOG>
<AMTIMER ACTIVITY="stop" RESULTVARIABLE="timeVar" SESSION="myTime" />
<AMSHOWDIALOG>The total task execution time is %timeVar% seconds.</AMSHOWDIALOG>