HP Hitachi TrueCopy for Mainframe User Guide (T5211-96014, November 2011)

Table 71 Functional Macro Commands for TrueCopy for Mainframe Scripting
DescriptionTrueCopy for Mainframe Scripting Macro
Registers a TrueCopy for Mainframe pair or pairs.
(StartHrcPair is used to start the initial copy operation.)
CreateHrcPair
Releases a TrueCopy for Mainframe pair or TrueCopy for
Mainframe pairs.
DeleteHrcPair
Suspends a TrueCopy for Mainframe pair or pairs.SuspendHrcPair
Resynchronizes a TrueCopy for Mainframe pair or
TrueCopy for Mainframe pairs. This command must be
used with StartHrcPair.
ResumeHrcPair
Changes the pair options for a TrueCopy for Mainframe
pair or TrueCopy for Mainframe pairs.
ChangeHrcOption
Starts remote copy operations for the new pairs and/or
resynchronized pairs specified in the preceding scripting
commands.
StartHrcPair
Displays the status of a TrueCopy for Mainframe pair or
TrueCopy for Mainframe pairs.
GetHrcStatus
Searches TrueCopy for Mainframe paired devices.SelectHrcDevice
Table 72 Internal Macro Commands for TrueCopy for Mainframe Scripting
DescriptionMacroType
Set (define) a list of items.SetListFor lists
Add items to a list.AddList
Declares the beginning of a script.StartFor non-lists
Declares the end of a script.End
Suspends script execution for the
specified length of time.
Delay
If EndIf
Executes a script conditionally.
MakeString
Terminates a script conditionally.
Message
Makes strings; converts numeric value
to character string.
The Message command is not yet
supported.
Syntax for Scripting
Syntax Overview
A TrueCopy for Mainframe script file can be written using any text editor (for example, WordPad,
NotePad). A script file consists of an unlimited number of statements which consist of macros (that
is, commands), work variables, and comments. The first executable statement in a TrueCopy for
Mainframe script file must be the Start macro, and the last statement must be the End macro. Each
line in a TrueCopy for Mainframe 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 “Syntax Description” (page 224) and
“Script Components” (page 224)):
• 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
Syntax for Scripting 223