Usage
Assignments are:
•
Local to each job and cannot be referenced across jobs.
•
Not case sensitive.
Format
•
The first two characters must be a dollar sign ($) followed by an alpha character. No special
characters are allowed after the first character.
•
Upper and lower case, alpha and numeric are allowed.
•
Underscores are allowed; spaces are not allowed.
Branches
Branches and labels are typically used to handle errors and to create jobs that can be looped repeatedly.
In line 9 of the following example, the command branches to label E1 on line 30 if there is an error
when the command is executed.
Line Task
...
9
Launch ( %source_host%, %suspend_command_line%, "", WAIT, "0" ) onerror pauseat E1:
...
30
E1: Exit (FAILURE)
Branching types
•
Default. If the command fails, abort the job at this task (line).
•
None. Use the default behavior.
•
Onerror Goto. If the command fails, go to the label. Execute the command at the label.
•
Onerror Pauseat. If the command fails, go to the label and pause the job. When the job is
continued from the GUI or CLUI, resume the job by executing the command at the label.
•
Onsuccess Goto. If the command is successful, go to the label. Execute the command at the label.
Commands
When you include a command in a job, the command's arguments and default values are displayed in
the job editor window. Argument names that appear with red % markers indicate that specific values
are required. See job arguments. For example:
SnapcloneStorageVolume ( %storvol_unc_name%, "", SAME, "", WAIT )
^ command
You must edit the command and select or enter values for any required arguments. After editing, the
command displays the argument value as normal text, in quotes.
SnapcloneStorageVolume ( "\\Array2\Cats", "", SAME, "", WAIT )
You can also edit a command to change its default values. In the example below, the defaults for disk
group name and snapclone name have been changed.
SnapcloneStorageVolume ( "\\Array2\Cats", "DskGrp3", SAME, "CatsCopy", WAIT )
You can also edit a command to add job flow controls and assignments. See job labels,
and assignments.
16
Job concepts, templates and commands
^ arguments ...
^
^
^
^
branches