Hitachi TrueCopy for IBM z/OS User and Reference Guide (T5211-96001, June 2007)

TrueCopy for z/OS Scripting B-23
Hitachi Universal Storage Platform V TrueCopy for IBM z/OS User’s Guide
Internal Macro Commands
The internal macro commands are the connection agents that allow you to
connect the functional macros together and produce a complete and
functioning script. The internal macros are divided into two groups as shown in
Table B.9: list types and non-list types.
Table B-9 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
Message
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.
Note: The Message command is not yet supported.
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.
The Delay command allows you to delay a script for up to an hour. The
MakeString command allows you to assign several values to a string
statement, or the MakeString command can convert numeric values to sting
values. The SetList command allows you to create a list (e.g., all the
searchable ports in the USP V, all the searchable LDEVs in the USP V) and the
AddList command allows you to expand the parameters of a list created with
the SetList command.
Internal Macro Command Definitions
AddList
The AddList command allows you to add 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}