Hitachi TrueCopy for z/OS user guide (December 2005)

176 TrueCopy for the XP128/XP1024/XP10000/XP12000
NOTE: This section assumes that the user is familiar with batch files and does not provide instructions for
writing or editing batch files. The macro commands and parameters listed in this section are the only
commands recognized by the TC390 scripting function.
CAUTION: The user is responsible for testing the TC390 scripting function before running any TC390
scripts. If a TC390 script is run without prior testing and the script ends abnormally, data loss could occur.
Before testing a TC390 script, back up the data and vary the volumes offline. If the volumes must remain
online, back up the data and confirm that the target volume pair defined in the TC390 script is correct. The
results of a TC390 script can be confirmed by checking the latest TC390 pair status update (Last Updated
box on TC390 Pair Status window).
Table 44 on page 177 lists the TC390 pair macro commands. Table 45 on page 178 lists the internal
macro commands for TC390 scripting. The following TC390 operations cannot be performed using TC390
scripting:
• Configure serial/fibre ports (”Configuring the Host Interface Ports” on page 77).
• Monitor remote copy activity (”Usage Monitor Window” on page 71).
• Clear remote copy SIMs (”Other Operations” on page 107).
• Add/delete RCU (”Registering an RCU (Add RCU)” on page 81 and ”Deleting an RCU (Delete RCU)”
on page 91).
• Change RCU options (”Modifying RCU Options (Change RCU Option)” on page 86).
• Add/delete path/SSID (”Adding and Deleting Logical Paths for an RCU (Add Path and Delete Path)”
on page 91 and ”Adding and Deleting SSIDs for an RCU (Add SSID and Delete SSID)” on page 94).
• View RCU status (”Viewing RCU Status (RCU Status)” on page 78).
• Change async options (”Asynchronous Copy Option” on page 102).
• Add/delete group (”Adding Consistency Groups (Add CT Group)” on page 99 and ”Deleting
Consistency Groups (Delete CT Group)” on page 101).
• Change group options (”Modifying Consistency Group Options (CT Group Option)” on page 100).
• View group status (”Viewing Consistency Group Status (CT Group Status)” on page 97).
NOTE: The scripting command names did not change between CA and TC390. Your existing CA
scripting files can be used for TC390 operations.
Table 44 Functional macro commands for TrueCopy scripting
TC390 Scripting Macro Description
CreateHrcPair Registers a TC390 pair or pairs. (StartHrcPair is used to start the initial copy
operation.)
SuspendHrcPair Suspends a TC390 pair or pairs.
DeleteHrcPair Deletes a TC390 pair or TC390 pairs.
ResumeHrcPair Resumes a TC390 pair or TC390 pairs. Use with StartHrcPair.
ChangeHrcOption Changes the pair options for a TC390 pair or TC390 pairs.
StartHrcPair Starts remote copy operations for the new pairs and/or resumed pairs specified in
the preceding scripting commands.
GetHrcStatus Displays the status of a TC390 pair or TC390 pairs.
SelectHrcDevice Searches TC390 paired devices.