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

Page 227

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.

Add items to a list.

SetList

AddList

For lists

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.

The Message command is not yet
supported.

Start

End

Delay

If EndIf

MakeString

Message

For non-lists

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 228)

and

“Script Components” (page 228)

):

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 227

Advertising
This manual is related to the following products: