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

TrueCopy for z/OS user guide 177
Syntax for Scripting
Syntax Overview
A TC390 script file can be written using any text editor (for example, WordPad or Notepad). A script file
consists of an unlimited number of statements that consist of macros (commands), work variables, and
comments (see ” Operation Macro Commands ” on page 180 and ” Internal Macro Commands ” on
page 188). The first executable statement in a TC390 script file must be the Start macro and the last
statement must be the End macro. Each line in a TC390 script file cannot exceed 320 bytes. A leading
blank is ignored and a leading tab character (0x09) is converted to a space (0x20). A tab character
(0x09) within a string is not converted to a space.
Each script file should contain all five script statements (see
Table 46 on page 179 and Table 47 on
page 179):
• A comment statement, including a short preface for the script: purpose, author, usage, description,
operation, creation date, update date, and any reminder notes to the author. The comment statement is
a non-execution statement. A comment statement begins with “//” and contains text (any character
string) without any commands. Do not use the “//” symbol anywhere else in a script file, only at the
beginning of a comment statement.
• A macro statement (see ” Operation Macro Commands ” on page 180 and ” Internal Macro
Commands ” on page 188). The macro statement is an execution statement. Only one macro instruction
can be set per line and a macro can span more than one line.
• A work variable statement (see ” Work Variables ” on page 190). The work variable statement is also
an execution statement. Only one work variable statement can be set per line and a work variable
statement cannot span more than one line.
• A blank statement (see Table 46 ). The blank statement is a non-execution statement.
Table 45 Internal macro commands for TrueCopy scripting
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.