Label - Create

Declaration

<AMLABEL LABELNAME="text" />

Related Topics   

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 activity for usage information.

IMPORTANT: 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 activity). In many programming  languages, the use of even one Goto statement is considered bad programming practice. Use at your own risk!

Parameters

General

Property Type Required Default Markup Description
Label name Text Yes (Empty) LABELNAME="problemhandler" The name of the label to create.

Description

Error Causes

On Error

Example

NOTE:
  • Copy and paste the sample AML code below directly into the Task Builder Steps Panel.
  • To successfully run the sample code, update parameters containing user credentials, files, file paths, or other information specific to the task to match your environment.

Description

This sample task checks if C:\Temp\test1.txt exists. If so, it will be copied to C:\Monthly_Backup\Archive\test1.txt and a subsequent step stops the task. If not, the task will skip to a label named bugHandler, at which point, a subsequent step will display a message dialog stating "File not found!"

Copy
<AMIF ACTIVITY="file_exist" FILE="C:\Temp\test1.txt" MODE="not_exist"><AMGOTO LABELNAME="bugHandler" /></AMIF>
<AMLABEL ACTIVITY="goto" LABELNAME="bugHandler" />
<AMIF ACTIVITY="end" />
<AMFILESYSTEM SOURCE="C:\Temp\test1.txt" DEST="C:\Monthly_Backup\Archive\test.txt" />
<AMTASK ACTIVITY="stop" STATUSTYPE="SUCCESS" />
<AMLABEL LABELNAME="bugHandler" />
<AMSHOWDIALOG MESSAGE="File not found!" />