HP StorageWorks XP Remote Web Console Software - Manual (Page 187)

TrueCopy for z/OS user guide 187
Internal Macro Commands
The internal macro commands are the connection agents that connects the functional macros together and
produces a complete and functioning script. The internal macros are divided into two groups as shown in
the following table: list types and non-list types.
The Start and End commands are used together to begin and end the functions of a script. Every script
must have a Start and End command. The If/EndIf commands are also used concurrently to string two or
more functional commands together. The If/EndIf commands must be used together. For every If command
in a script there must be an EndIf command. Use the Delay command to delay a script for up to an hour.
Use the MakeString command to assign several values to a string statement. The MakeString command
can convert numeric values to sting values. The SetList command creates a list (for example, all the
searchable ports in the XP128/XP1024/XP10000/XP12000, all the searchable LDEVs in the
XP128/XP1024/XP10000/XP12000) and the AddList command expands the parameters of a list created
with the SetList command.
Internal Macro Command Definitions
AddList
The AddList command adds a specified value to a specific list type. If you add a value to a list that exceeds
the maximum number of items for that output list, the excess values will be ignored. The format for the
AddList command is: AddList $D= the output list to which you want to add a value, $S= the expressions or
values to be added to the output list with a numeric range of 0x0000 to 0xffff. For example, to add these
values (0, 1, 2, 3, 0x1e, and 0x1f) to the Dev (Device) B list, the AddList command would be:
AddList $D=_ilDevB
,$S={0,1,2,3,0x1e,0x1f}
Delay
Use the Delay command to delay a script for a specified length of time. The script delay time is set in
seconds (0 - 3600). The format for the Delay command is: Delay $Time= the length of time you want to
delay the script. For example, to delay a script by 60 seconds, the Delay command would be:
Delay $Time=60
End
Use the End command to declare the end of a script. The End command also terminates the execution of a
script. At least one End statement must be described in the trailing line of the script statement. The format
for the End statement is:
End
If/EndIf
The If/EndIf statements are used together to verify the conditions of an expression. If the If/EndIf statement
is successfully completed, succeeding statements will be processed. If the If/EndIf statement is not
successfully completed, the script will abort and the succeeding statements will not be completed. When
If/EndIf statements are used, several conditions must be met. You must end an If statement with an EndIf
Table 52 Internal macro commands
Type Macro Description
For lists SetList
AddList Set (define) a list of items.
Add items to a list.
For non-lists Start
End
Delay
If
EndIf
MakeString Declares the beginning of a script.
Declares the end of a script.
Suspends script execution for the specified length of time.
Executes a script conditionally.
Terminates a script conditionally.
Makes strings; converts numeric value to character string.