Syntax for scripting, Syntax overview, Internal macro commands for truecopy for mainframe – HP StorageWorks XP Remote Web Console Software User Manual

Page 223

Advertising
background image

Table 71 Functional Macro Commands for TrueCopy for Mainframe Scripting

Description

TrueCopy 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

Description

Macro

Type

Set (define) a list of items.

SetList

For lists

Add items to a list.

AddList

Declares the beginning of a script.

Start

For 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

Advertising