Hitachi TrueCopy for z/OS (T1711-96009, June 2006)

188 TrueCopy for the XP1024/XP128/XP12000/XP10000
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 51 on page 188 lists the TC390 pair macro commands. Table 52 on page 189 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 83).
• Monitor remote copy activity (”Usage Monitor Window” on page 77).
• Clear remote copy SIMs (”Other Operations” on page 113).
• Add/delete RCU (”Registering an RCU (Add RCU)” on page 87 and ”Deleting an RCU (Delete RCU)”
on page 97).
• Change RCU options (”Modifying RCU Options (Change RCU Option)” on page 92).
• Add/delete path/SSID (”Adding and Deleting Logical Paths for an RCU (Add Path and Delete Path)”
on page 97 and ”Adding and Deleting SSIDs for an RCU (Add SSID and Delete SSID)” on page 100).
• View RCU status (”Viewing RCU Status (RCU Status)” on page 85).
• Change async options (”Asynchronous Copy Option” on page 108).
• Add/delete group (
”Adding Consistency Groups (Add CT Group)” on page 105 and ”Deleting Consistency
Groups (Delete CT Group)” on page 107
).
• Change group options (”Modifying Consistency Group Options (CT Group Option)” on page 106).
• View group status (
”Viewing Consistency Group Status (CT Group Status)” on page 103).
NOTE: The scripting command names did not change between CA and TC390. Your existing CA
scripting files can be used for TC390 operations.
Table 51 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.