Label Action

Declaration

 

<AMLABEL LABELNAME="text">

 

See Also

    Label Action-Setting Properties, Goto Action, Else Action, End If Action, The BASIC Language All Groups

Description

Labels a point in a task with a specific name.  Can be used with the Goto Action or On Error Goto to direct task execution to a different point of the task.

Practical Usage

This action does not have an effect on task execution, it only defines a point in a task. Please see, Goto Action for usage information.

IMPORTANT NOTE: Excessive use of Goto can create tasks that are difficult or impossible to debug. If your task requires more than a few goto steps it is recommended to consider re-structuring with "Sub-tasks"  (using the Start Task Action).  In many programming  languages, the use of even one Goto statement is considered bad programming practice. Use at your own risk!

Parameters

General Tab

Expression

Text, Optional
MARKUP: LABELNAME="problemhandler"

Specifies the name of the label.

 Notes

Custom Description

This action includes the Description tab for entering a custom step description.

More on setting custom step description

Standard Error Handling Options

This action also includes the standard Error Causes and On Error failure handling options/tabs.

More on Error Handling Options

Variables and Expressions

All text fields allow the use of expressions, which can be entered by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by pressing F2.

More on variables
More on expressions

More on the expression builder

Examples

NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.

<AMIFFILEEXISTS ACTION="not_exist" SOURCE="c:\filename.txt">
<AMGOTO LABELNAME="problemhandler1">
</AMIF>
<AMFILECOPY SOURCE="c:\filename.txt" DEST="c:\newfolder\filename.txt">
<AMSTOPTASK>
<AMLABEL LABELNAME="problemhandler1">
<AMMESSAGEBOX>File not found!</AMMESSAGEBOX>