HP P9000 HP StorageWorks P9000 for Business Continuity Manager Software Refere
HP P9000 Manual
View all HP P9000 manuals
Add to My Manuals
Save this manual to your list of manuals |
HP P9000 manual content summary:
- HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 1
Manager Software Reference Guide Abstract This manual is a reference guide to the following program products, known collectively as Business Continuity Manager: HP StorageWorks P9000 for Business Continuity Manager Basic and HP StorageWorks P9000 for Business Continuity Manager Continuous Access - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 2
and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Acknowledgments Microsoft, Windows, and Windows XP are U.S. registered trademarks of Microsoft Corporation. Hitachi and - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 3
and DAD ID Settings 27 Manage Licenses Panel (License Management 29 Message Panel...30 Discover/Define Configuration Panel (Configuration File Definition 31 Discover HP Storage System Panel 32 Scan Device Address Extent Panel 34 CU Selection List for Remote Storage Array Panel 35 CCA Selection - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 4
YKQRYPTH with RESTRUCT Specified 115 Manage Copy Groups Panel (Copy Group Operation 115 Sort the Copy Groups Panel 118 Executing YKLOAD...119 Copy Group Status Summary Panel (Executing YKQUERY 120 Copy Group Storage System Summary Panel 123 CAA Copy Group Performance Statistics Panel 124 Sort - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 5
Confirm Route List Edit Panel 184 Confirm Retry of Configuration File Create Panel 184 Confirm Open/MF Consistency Group Suspension Panel 185 2 CLI Commands 186 Copy Types and Targets for Which Commands Can Be Executed 187 List of Functions...187 Configuration Files That Must Be Loaded Before - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 6
Contents of Disk Configuration Definition File 322 Example Contents of Route List Definition File 322 Example Contents of Command Device Definition File 322 Example Contents of Path Set Definition File 323 About REXX Variable Structures 323 Copy Group Structure...323 Host-discovered Array Index - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 7
the YKMONCG File 365 Copy Group Parameters 366 Processing for Changing to the Startup Status 368 5 Support and other resources 377 Contacting HP...377 Subscription service...377 Documentation feedback 377 Related information...377 HP websites...379 Conventions for storage capacity values 379 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 8
: Hitachi TrueCopy Asynchronous (TCA) is supported on the HP StorageWorks XP Disk Array. TCA is not supported on the P9500 Disk Array. Business Continuity Manager can be used with both P9500 and XP disk arrays. The XP disk array copy products can be configured and controlled using the P9000 version - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 9
10) show the panel structure beginning with the main menu. As the panel system illustration suggests, there are multiple levels of panels. Tertiary panels are accessed through secondary panels. Figure 1 ISPF Panel System (1 of 2) Overview of ISPF Panels 9 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 10
the entry by pressing Enter. NOTE: During execution of Business Continuity Manager, you must not perform ISPF operations that involve execution of the following: • YKSTART command • Scripts that execute Business Continuity Manager Function Keys Function keys, which are common among panels, are - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 11
to AC in a panel that displays list items in accordance with the conditions specified by the SELECT command. The SELECT command selects the rows that match the condition and performs the action on them. The command selects these rows not only from the part of the list that is displayed, but from the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 12
for the applicable panel. If field-name is omitted, the default field established for the applicable panel Manage Copy Groups panel, enter the following command: SΔCGIDΔTCGRP*ΔQ • To load copy groups for which NOT LOADED is set to Status, in the Manage Copy Groups panel, enter the following command - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 13
Function The SCANPAIR command displays the Scan Copy Pair Inside Storage System panel that scans volumes of PPRC copy pairs. Format SCANPAIR ERRCODE Command Function The ERRCODE command displays the Error Code Help panel. If you enter an error code on this panel, you can view the details for that - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 14
- - Path Set Status of Copy Group Pair - - Setting Information - - Hitachi TrueCopy™ Asynchronous Y - for Mainframe Copy Group Performance Statistics Continuous Access Journal for Y - Mainframe Copy Group Performance Statistics Others - - 1 This command can be used, but you - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 15
keys that are displayed. This setting is saved in the profile even after Business Continuity Manager is stopped To set the number of PF keys that are displayed: 1. Start Business Continuity Manager. Type PFSHOW TAILOR on the command line, and then press the Enter key. The ISPF Settings panel appears - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 16
of messages (message structures) that are output to the ISPF log when a command is executed Displays whether the remote DKC control function is applied: • Y: The Remote DKC Control Function is being used. • N: The Remote DKC Control Function is not being used. Preset RouteListID Current route list - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 17
Panel to close. If there are multiple messages, they can all be viewed by scrolling the panel. Each operation and the messages output for that space, and you then press the F5=ErrCode key or execute the ERRCODE command, the first 40 characters before the current cursor position will be searched. If - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 18
of the configuration file, see the HP StorageWorks P9000 for Business Continuity Manager Software User Guide. Figure 6 (page 18) shows the code on this panel, you can view the details for that error code. For details about the ERRCODE command, see "ERRCODE Command" (page 13). In the Exception - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 19
, the entire message can be viewed by scrolling the panel. Pressing the F10=PrvsErr key displays the error code that is immediately before the current error code according to the list of error codes in the HP StorageWorks P9000 for Business Continuity Manager Software Messages. If the first error - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 20
you really want to update the configuration file, which will cause the other user's changes to be overwritten. Figure 8 (page 20) shows the Update Panels The following notes are common to all panels: • XP24000 disk array is displayed as USPV. • Lowercase letters might not be displayed correctly - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 21
Figure 9 Panel Transitions from the Main Menu Pressing the F6=Sort key sorts items on the panel. To display the Main Menu panel: 1. Select 6 Command from the ISPF menu. 2. Enter YKSTART. In some cases, the following panels might be displayed instead of the Main Menu panel: Main Menu Panel 21 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 22
RACF security setting. • No user SVC has been registered. • A user SVC version is enabled that cannot be used with the version of Business Continuity Manager being installed. For details on and their descriptions. Specify the number corresponding to the operation to be performed. 22 ISPF Panels - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 23
configuration file Manages routes Manages logical paths Operates a copy group Terminates the panel Version of Business Continuity Manager When the PF keys are not displayed in the Main Menu panel or the Set Defaults panel, you can display the PF keys by entering the PFSHOW ON command. Installation - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 24
Business Continuity Manager instance that is running. • FAULTY: No user SVC is registered, or a user SVC is enabled whose version cannot be used with the Business Continuity Manager are registered, N/A is displayed. Facility Class Profiles Commands Names of the profiles for operations that are - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 25
Routine from the Installation Verification Summary panel, the User SVC Information panel is displayed. The User SVC Information panel displays the user SVC setting information. Figure 13 (page 25) shows the User SVC Information panel. Figure 13 User SVC Information Panel If you press the F8=Forward - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 26
) lists and describes the items in the User SVC Information panel. Table 9 Items in the User SVC Information Panel Item Version of User SVC for this program Description The version of the user SVC, which can be used with the Business Continuity Manager instance that is running. If the value shown - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 27
The setting for use of the Remote DKC Control Function or the route list ID • The parameters for the YKWATCH command, which monitors volume status, and the the device address domain ID of the host on which Business Continuity Manager is running (the host DAD ID) by using alphanumeric characters ( - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 28
file. To do this, use the command for Configuration File Prefix. If you specify the same prefix, an error occurs in the Scan Copy Pair Inside Disk Array panel or Manage Copy Groups panel. 2 If you have already started the Business Continuity Manager agent with LOCK(PREFIX) specified, specify - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 29
. Business Continuity Manager assumes that volumes with the same DAD ID as the one specified for the Set Defaults panel can be directly accessed. • For BC, the same DAD ID must be specified for P-VOL and S-VOL. However, when defining a Non Gen'ed volume and a Gen'ed volume inside the same storage - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 30
11 Contents of the Manage Licenses Panel Item License Key Dataset Name Key Code PP Name Serial Num Model Description The dataset name of the license key file that has been transferred to MVS. Key code of the license License name Physical Storage system serial number Storage system model code For - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 31
Defines the path set Defines the copy group/copy pair For instructions on how to create a configuration file, see the HP StorageWorks P9000 for Business Continuity Manager Software User Guide. The configuration file needed to use Business Continuity Manager can be created in the Discover/Define - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 32
a list of storage systems detected by performing a scan. Figure 19 (page 32) shows the transitions of the operation panel starting from the Discover HP Disk Storage System panel. Figure 19 Panel Transition from the Discover HP Disk Storage System Panel The Discover HP Storage Arrays panel is shown - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 33
of a volume scan. • r: Displays the Scan Remote Device Address Extent panel used to perform a remote scan. • e: Displays the CU Selection List for Remote Storage Array panel used to display a list of CUs detected in a remote scan or NG scan. S/N Storage system serial numbers The following marks - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 34
, and then perform the next operation. Scan Device Address Extent Panel When you press the F4=Discover key in the Discover HP Storage System panel, the Scan Device Address Extent panel for scanning the volumes of the storage system connected to the host is displayed - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 35
N Y First entry of the route list specified for Command device used when an NG Preset RouteListID in the Set Defaults scan is performed panel Not applicable The first command device of the list that was sorted in ascending order by CU If the storage system is not a target for and CCA. The - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 36
to which the CU belongs Setting for use of the copy type by the storage system: • Y- Copy type can be used. • N- Copy type cannot be used. Specify an action: • s- Displays the CCA Selection List for Remote Storage Array panel which identifies detailed information about the CU. • e- Displays the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 37
Address Extent panel or the Discover HP Storage System panel transitions to the CU Selection List for Remote Storage System panel, you can return to the Discover HP Storage System panel by pressing the F3=Exit key in the Selection List for Remote Storage Array panel. CCA Selection List for Edit - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 38
continued) Item Storage System S/N Model uCode IFType Control Unit SSID CCA Description Serial number of the storage system to which a device belongs Model of the storage external volume. The values are: • +: An external volume • -: Not an external Selection List for Remote Storage Array panel, the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 39
the Scan Device Address Extent panel, the Storage System/DADID Selection List panel is displayed. The Storage System/DADID Selection List panel displays storage system serial numbers and DAD IDs that have been NG-scanned. To perform a scan again, select storage system serial numbers and DAD IDs that - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 40
in the AC column in the Discover HP Storage System panel, the Control Unit Selection Domain Description Storage System S/N Model uCode IFType Software Keys CA copy type by the storage system. • Y- Copy type can be used. • N- Copy type cannot be used. Specify an action: s- Displays the Command - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 41
Command Control Address (CCA) Selection List panel. Table 21 Contents of the Command Control Address (CCA) Selection List Panel Item Device Address Domain Description Storage whether the CCA is an external volume. The values are: • +: An external volume • -: Not an external volume • (blank): The - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 42
unit and command control address) range to be remotely scanned.1 Specify the hexadecimal number in ascending order. If the CCA is omitted, Start and End will be set to 00 and FF respectively. 1 Do not include any volumes that belong to a copy pair that was created by Remote Web Console. If such - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 43
list. #2: Displayed if the specified entry was created by the remote scan and no dummy device number has been assigned. #3: Returns to the called this panel. #4: If Device Address Domain or Storage System S/N is blank, the Storage System/Device Address Domain Selection List panel is displayed - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 44
Figure 30 Panel Transitions from the Route Config Panel (2 of 2) #1: Displayed if no APID is set for the DAD ID that was selected on the Add Route panel. #2: Pressing the F6=Sort key sorts items on the panel. The Route Config panel is shown in Figure 31 (page 44). Figure 31 Route Config Panel Table - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 45
in the route list Route list ID The route list definition is required when using the Remote DKC Control Function and the Cnt Ac-S consistency preservation function. It defines routes between devices and command devices so that these devices are available. The route list ID list is displayed in the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 46
Figure 33 Route Information Panel Table 24 (page 46) describes the items in the Route Information panel. Table 24 Contents of the Route Information Panel Item Route List ID AC Description Route list ID selected in the Route Config panel Specify an action. • s- Displays the Inner Route Information - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 47
is 1 only. From the DAD ID list, select the first DAD ID of the route. Specify the DAD ID that is connecting to the host where Business Continuity Manager will execute, since I/Os are issued to this first DAD ID of the route. Add APID Panel If no APID is set for the DAD - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 48
to DADR). Figure 36 (page 48) indicates the DAD connection in ascending order of list numbers. S/N and Devn show information on the storage system which is connected and the command device that controls it. If these items are blank, this means that the information is not set. To create a route list - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 49
to the route Device Address Domain Selectable DAD ID Add Remote Route Entry Panel In the Inner Route Information panel, press F6=Remote . The Add Remote Route Entry panel for specifying information about a storage system to be remotely scanned is displayed. Figure 38 (page 49) shows the Add - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 50
the CCA (in hexadecimal) of the command device assigned to the storage system to be remotely scanned. After an entry is added, **** is displayed for Devn of the command device of the corresponding entry in the Inner Route Information panel. A disk configuration definition file is created that - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 51
System Selection List Panel (continued) Item Description AC Specify an action. s- Displays the Define Command Device panel used to select a single command device in the storage system. S/N Devn Storage system serial number Device number of the command device If the command device is to be - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 52
of the Define Command Device Panel (continued) Item CU SSID CCA Device Number Volume Serial Number Description The number of the CU to which the command device belongs SSID of the CU to which the command device belongs CCA of the command device Device number of the command device Volume serial - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 53
Item CU CCA Device Number Volume Serial Number Sorted by Number of the CU to which the command device belongs CCA of the command device Device number of the command device Volume serial number of the command device Edit APID Panel If e is specified in AC in the Route Information panel, the Edit - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 54
Remote Route Entry Panel is displayed. • r:- Adds an entry to be processed by remote scan to the next row. Displays the Insert Remote Route Entry panel used to add an entry for remote DAD ID to which the entry belongs Serial number of the storage system to which the entry belongs SSID of the CU to - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 55
you do not manually type in a DAD ID and storage system serial number, or a command device, but remote scan or NG scan cannot be specified. Storage System S/N Device Number Enter the storage system serial number for the command device being registered. Specify the device number of the command - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 56
DAD ID selected in this panel will be defined in the route list. AC Specify an action. s: Select a DAD ID or storage system serial number for the DAD ID or storage system serial number selected in the Add Route Entry panel, Insert Route Entry panel, or Edit Route Entry panel. S/N Device Address - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 57
Item Description AC Specify an action: s- Used to select a DAD ID and storage system serial number, or select a command device. When you specify this in either Device Address Domain or Storage System S/N, the Storage System/DAD Selection List panel is displayed. When you specify this in Device - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 58
not want to manually enter a combination of the DAD ID and storage system serial numbers, or enter a command device, but Remote Route Entry panel is displayed to update information for entries added for remote scan. Figure 48 (page 58) shows the Edit Remote Route Entry panel. Figure 48 Edit Remote - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 59
the CCA of the command device assigned to the storage system to be remotely scanned, in hexadecimal. After a remote entry is added, **** is displayed for Devn of the command device of the corresponding entry in the Entire Route Information panel. A disk configuration definition file is created - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 60
prefix.DSK.SNnnnnn.dad-id When entering information for prefix and dad-id, the names must be 44 characters or less. Path Set Selection List Panel The Path Set Selection List panel displays a list of path set IDs when 3 Path Set Definitions is selected in the Discover/Define Configuration panel. - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 61
Figure 51 Path Set Selection List Panel Table 42 (page 61) describes the items in the Path Set Selection List panel. Table 42 Contents of the Path Set Selection List Panel Item Description AC Specify an action. • e- Displays the Path Set Detail panel used to load a path set definition file • - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 62
system serial number Primary path ID1 CU Primary CU number SSID Primary SSID2 Dir Direction of the path Secondary S/N PathID Secondary storage system serial number Secondary path ID1 CU Secondary CU number SSID Secondary SSID2 1 Valid only when the Type is DKC. 2 Valid only when - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 63
Set Detail panel, you can use the SORT command. For details about how to use the SORT command, see "Command Line Commands" (page 11). Edit Logical Path Definition action. s: Displays the Select Storage System panel used to select the site from a list of storage systems. When actions are entered - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 64
Table 44 Contents of the Edit Logical Path Definition Panel (continued) Item Primary S/N Model IFType PathID Description Primary storage system serial number (modifiable) Primary storage system model (modifiable) Primary interface version (modifiable) Specify the primary path ID. Specify this - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 65
the storage system is not directly connected to the host and CCA is not specified, execution of the YKQRYPTH command will Storage System HP StorageWorks XP1024/XP128 Disk Array HP StorageWorks XP12000/XP10000 Disk Array HP StorageWorks XP24000/XP20000 Disk Array HP StorageWorks P9500 Disk Array - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 66
Table 47 (page 66) describes the items in the Select Storage System panel. Table 47 Contents of the Select Storage System Panel Item Description AC Specify an action. s- Displays the Select SSID panel used to load a disk configuration definition file. When actions are entered in multiple AC - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 67
Definition Panel Item Path Set ID Primary S/N Model IFType PathID CU SSID Description Path set ID Primary storage system serial number Model of the primary storage system Primary interface version Primary path ID Primary CU number Primary SSID Discover/Define Configuration Panel (Configuration - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 68
Table 49 Contents of the Edit Port Definition Panel (continued) Item Secondary AC S/N Model IFType PathID CU SSID Description Secondary storage system serial number Model of the secondary storage system Secondary interface version Secondary path ID Secondary CU number Secondary SSID Specify an - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 69
Primary path ID number • Secondary Serial Number: Serial number in secondary storage system • Secondary CU: Secondary CU number. • Secondary PathID: Path Set Status panels. Copy Group Selection List Panel The Copy Group Selection List panel is displayed when 4 Copy Group Definitions is selected in - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 70
Group Pair Detail panel is displayed, and the Setting C/T ID Attributes panel is displayed on top of that panel. #5: If you press Enter, the Copy Group Pair Detail panel is displayed, and the Setting C/T ID Attributes panel is displayed on top of that panel. #6: If the number of P-VOLs and S- - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 71
does not change the panel that is currently displayed. Figure 63 (page 72) shows the panel when e is specified for AC in the Copy Group Selection List panel. The Copy Group Selection List panel is shown in Figure 63 (page 72). Discover/Define Configuration Panel (Configuration File Definition) 71 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 72
that was not created by Business Continuity Manager. NOTE: • When you enter an action in AC , complete the action by pressing the Enter key, and then perform the next operation. • When the target copy group is being copied (with a copy pair other than SIMPLEX), the copy pair is not dissolved even - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 73
'ed volume and a Gen'ed volume inside the same storage system as a BC copy pair, specify respective values (the DAD ID specified for an NG scan and the DAD ID specified for a local scan). Copy Group Type Use Container Specify the copy type of the copy group (either BC, CA, CAA, or CAJ). Select Use - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 74
will be applied to the storage system settings when the copy pair is reloaded (by executing the YKLOAD command) and then created. For Continuous Access Synchronous for Mainframe copy pairs with the HyperSwap attribute, because Business Continuity Manager cannot perform copy pair operations, if you - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 75
for Continuous Access When the YKMAKE command is executed.1 Synchronous for Mainframe copy groups with the HyperSwap attribute. sub Pair(s) Primary S S/N Specify the subconsistency group ID (hexadecimal). When the YKMAKE command is executed.1 The number of copy pairs in the applicable - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 76
been updated by another user, the Confirm Configuration command, see "Command Line Commands" (page 11). Copy Group Attributes Panel If you press the F4=Attr key in either the Copy Group Pair Detail panel or the Copy Group Detail Definition panel, either the Copy Group Attributes panel or the Copy - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 77
displayed for each combination (continued) Copy type CG Container? Displayed panel CAJ Yes Copy Group Attributes For Container (CAJ) No 1 Including when no C/T group ID is specified. Copy Group Attributes (CAJ) "Copy Group Attributes For Container (BC) Panel (for BC Copy Groups that are CG - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 78
Group Attributes For Container (CAA) Panel (for CAA Copy Groups that are CG Containers) Figure 71 Copy Group Attributes (CAA) Panel (for CAA Copy Groups that are not CG Containers) Figure 72 Copy Group Attributes For Container (CAJ) Panel (for CAJ Copy Groups that are CG Containers) 78 ISPF Panels - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 79
is specified for Linkage Option, because Business Continuity Manager cannot perform copy pair operations, if you change the definitions of the items that require the YKMAKE or YKRESYNC command to make changes, the changes will not be applied to the storage system settings. Table 56 Contents of the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 80
that is used for control by the OS or applications such as Business Continuity Manager, specify DATA or STATUS for FENCE LVL to create a copy pair and operate the system. Write to P-VOL is prohibited and the OS or application might hang when a failure problem occurs. For that reason, if you use the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 81
when performing copy operations from the secondary site to primary site (required for TCA). • SYSTEM: Uses a timestamp to maintain consistency. • LOCAL: Uses storage system's internal clock to maintain consistency. • NONE: Does not maintain consistency. When effective • When the YKMAKE command is - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 82
documents: • HP StorageWorks P9000 Continuous Access Synchronous for Mainframe Systems User Guide • HP StorageWorks P9000 Continuous Access Synchronous User Guide • Hitachi TrueCopy for Mainframe User Guide: HP XP24000 Disk Array, HP XP20000 Disk Array When effective • When the YKMAKE command is - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 83
-data management unit, there is a limit to the number of copy pairs that can be created in each storage system. For details, see the HP StorageWorks P9000 Continuous Access Synchronous for Mainframe Systems User Guide or the HP StorageWorks P9000 Continuous Access Synchronous User Guide. Preset - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 84
is to be used when the copy type is CA. Y: Uses the Open/MF Consistency Preservation Function (Open/MF Consistency attribute setting). N: Does not use the Open/MF Consistency Preservation Function. When effective When the YKSUSPND command is executed When the YKQUERY command is executed When the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 85
Systems User Guide • HP StorageWorks P9000 Continuous Access Synchronous User Guide • Hitachi TrueCopy for Mainframe User Guide: HP XP24000 Disk Array, HP XP20000 Disk Array • HP StorageWorks XP24000/XP20000 Continuous Access Software User Guide 7 When executing the YKRESYNC command, specify - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 86
, or CAA, • BC specify the C/T group ID (required for CAA). • CA Specify a value between 00 and 7F • CAA (depending on the storage system type). • CAJ If the copy type is CAJ, specify the journal group number of the primary site as the C/T group ID (required for CAJ). Specify a value between - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 87
Editing panel, see "Confirm Command Device Delete Panel" (page 178). If you change the definition in the Copy Group Detail Definition panel and press file you are trying to update has already been updated by another user, the Confirm Configuration File Update panel is displayed, and then the Update - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 88
Detail Panel (continued) Item Copy Group Type AC Description The copy type of the copy group Specify an action. • d: Deletes the copy pair. Grp Num Group ID of the C/T group This value corresponds to the value of n in CopyGroup .n. of the copy group structure. VOLSER Pri Pri Devn Array SSID CU - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 89
column, complete the action by pressing the Enter key, and then perform the next operation. • When an EXCTG attribute is defined, if you edit the copy pair definition in this panel, the storage system information belonging to the copy group might change. Therefore, check the definition of the EXCTG - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 90
the number of S-VOL devices, display transits to the Copy Group Pair Detail panel. You can use the SELECT command in the Pair Selection List (Primary) panel. For details about how to use the SELECT command, see "Command Line Commands" (page 11). "Specifying fields for a condition of the SELECT - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 91
Business Continuity Manager in the SMS Storage Group Name column, and the SMS storage group name that is used for acquiring data from DFSMS Access Method Service in the Complete SMS Storage Group Name column. Import SMS Storage panel, you specify the S-VOL of the copy pair. If you select DEVN, enter - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 92
Description If the copy pairs to be specified are indicated Storage system serial number SSID SSID CU CU number CCA The two leftmost digits indicate the device CCA (in hexadecimal) The rightmost digit indicates whether the CCA is an external volume. • +: External volume • -: Not an external - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 93
system serial number order. Order of the arbitration command device (primary storage system) Order of the arbitration command device (secondary storage system) If you press the F3=Exit key when you change the copy type in the Copy Group Detail Definition panel, or when the consistency group ID - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 94
List panel, the display switches to the Scan Copy Pair Inside Storage System panel for scanning the P-VOL of the PPRC copy pair and generating a copy group definition file. Execute the YKH2B command to create a copy group definition file for a CA copy group with the HyperSwap attribute from a PPRC - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 95
Copy Pair Inside Storage System Panel Item Device Address Domain Primary Description Specify the Device Address Domain ID to which the P-VOL of the PPRC copy Secondary Specify the Device Address Domain ID of the S-VOL of the PPRC copy pairs to be scanned belong (required for CA or CAA). Use no - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 96
Copy Pair Inside Storage System Panel (continued) Item Device Num Description Specify the Start and End of the device number range for scanning the P-VOL of the PPRC copy , create a disk configuration definition file for the search-target storage system in the Discover HP Storage System panel. When - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 97
operations repeatedly, HP recommends that you change the value specified for CA Copy Group ID, TCA Copy Group ID, or BC Copy Group ID a copy group that you want to display in the Browse Copy Group Detail Definition panel In this panel you can view the details on the copy pairs in the copy group - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 98
only, and is not for editing. In the Browse Copy Group Pair Detail panel, you can use the LOCATE and SORT commands. For details about how to use each command, see "Command Line Commands" (page 11). Manage Route Panel (Route Management) The Manage Route panel to operate the routes is displayed when - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 99
Route list ID Extra Command Device Direct Operation Panel In the Manage Route panel and Route Status panel, press the F5=Extra key to display the Extra Command Device Direct Operation panel. You can use the Extra Command Device Direct Operation panel to perform operations (aside from registration - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 100
(that is, when this panel is displayed from the Manage Route panel), operations can only be performed for local command devices. In this case, you cannot overwrite DAD IDs that are already displayed. Serial Number Specify the storage system serial number, using 5 digits of alphanumeric characters - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 101
Disk Array ◦ HP StorageWorks XP24000/XP20000 Disk Array ◦ HP StorageWorks P9500 Disk Array • For the HP StorageWorks XP1024/XP128 Disk Array, you can only delete command devices registered in storage systems that are directly connected to the host. You cannot delete remote storage system command - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 102
. Table 67 Contents of the Route Status Panel Item Route List ID APID HOST ID CYL HD SLOTSIZE Description Route list ID selected in the Manage Route panel. APID1 Host ID assigned to the local host.1 The top cylinder number of the command device protection dataset.1 The top header number of the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 103
(continued) Item Description AC Specify an action. • q: Displays the Command Device Status panel used to execute the YKQRYDEV command to display the command device information that is registered in a storage system. • b: Executes the YKBLDCMD command to register a command device in a storage - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 104
specified for AC. If you specify f for AC and execute the action, out of the devices registered in the disk configuration definition file, all command devices that are registered in the storage system are displayed in the Command Device Selection List panel. If you press the F3=Exit key to exit the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 105
While it is defined as a command device, it has not been registered to a storage system as a command device (the YKBLDCMD command has not been executed), also it has not been defined as a copy pair. Figure 92 Command Device Status Panel (Command Device Not Registered/Copy Pair Not Defined) Table 68 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 106
/S-VOL status and copy pair status in the HP StorageWorks P9000 for Business Continuity Manager Software Users Guide. 1 If the information cannot be obtained, N/A is displayed.1 2 If the target volume is related to another volume as a copy pair, and not as a command device, the pair relationship - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 107
the primary site. For details about how to delete a command device, see the HP StorageWorks P9000 for Business Continuity Manager Software Users Guide. If you specify d for multiple fields in AC in the Route Status panel, processing will be performed from bottom to top. Even when d is specified in - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 108
DAD ID Description of the storage system specified in the Host-Discovered Array structure Storage system model • 9900V: HP StorageWorks XP1024/XP128 • USP: HP StorageWorks XP12000/XP10000 • USPV: HP StorageWorks XP24000/XP20000 Disk Array • VSP: HP StorageWorks P9500 Disk Array uCode IFType S/N AC - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 109
. Such command devices can be accessed directly through this panel. NOTE: Only devices registered in the disk configuration definition file are displayed. Scan the target storage system to detect command devices and register them in the disk configuration definition file in advance. Manage Path - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 110
Set Status panel. If you press the F3=Exit key to exit the Path Set Status panel, Status in the Manage Path Set panel displays the execution result of the YKQRYPTH command that was executed to display the Path Set Status panel. Executing YKLOAD When 1 is specified for the AC column in - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 111
specify b or q in the AC column of the Manage Path Set panel without executing the YKLOAD command, the Confirm Path Set Load panel (see "Confirm Path the storage system at the primary site or secondary site is connected to the host when loading a path set, then, from the scanned disk configuration - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 112
status details for the logical path. • b: Executes the YKBLDPTH command, and establishes the selected logical path. The execution result is displayed • CU: Inter-CU logical path • DKC: Inter-DKC logical path Primary storage system serial number Path ID of the primary site When the path type is - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 113
Panel (continued) Item Secondary SN ID Description Secondary storage system serial number Path ID of the secondary site When the path type is CU, nothing is displayed. CU Secondary CU number Displays the number of the CU in which a device exists to which the path operation command is issued - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 114
. CU Primary CU number Displays the number of the CU in which a device exists to which the path operation command is issued. Secondary SSID S/N PathID Primary SSID Secondary storage system serial number Secondary path ID When the path type is CU, nothing is displayed. CU Secondary CU number - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 115
is set to c, the YKQRYPTH command is executed with the RESTRUCT parameter specified To use this functionality, see the description in the HP StorageWorks P9000 for Business Continuity Manager Software Users Guide that explains how to acquire path information from storage system. If the return code - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 116
Figure 98 Manage Copy Groups Panel Table 73 (page 117) describes the items in the Manage Copy Groups panel. 116 ISPF Panels - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 117
. • RECOVER SUCCESSFULLY: a request was made to dissolve the copy pair from the secondary site. 1 An error occurs if an attempt is made to load a copy group definition file that was not created by Business Continuity Manager. 2 The following list describes the differences between specifying q and - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 118
Groups panel, Status displays the execution result of the YKQUERY command. You can use the LOCATE, SELECT, and SORT commands in the Manage Copy Groups panel. For details about how to use each command, see "Command Line Commands" (page 11). You can specify the following fields for a sort key of the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 119
in the Manage Copy Groups panel, the YKLOAD command to load a copy group is executed and the LOAD Option panel for specifying YKLOAD command parameters is settings of the Remote DKC Function column and Preset RouteListID column in the Set Defaults panel. Settings of the Remote Settings of the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 120
(Executing YKQUERY) When q or f is specified in AC on the Manage Copy Groups panel, the YKQUERY command executes and the Copy Group Status Summary panel, which displays the number of copy pairs in individual copy pair statuses within a copy group, is displayed. When v is specified in AC, the YKQUERY - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 121
Figure 101 Panel Transitions from the Copy Group Status Summary Panel The Copy Group Status Summary panel is shown in Figure 102 (page 122). Manage Copy Groups Panel (Copy Group Operation) 121 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 122
Current time Proxy C/T delta value for the entire copy group1, 1 Copy pair matching rate in the applicable copy group2 If f is specified in the Manage Copy Groups panel, N/A is displayed. Reversed Pairs % The ratio of copy pairs that the copy direction in DUPLEX status is in reversed direction in - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 123
in Pair Status Counts because a copy pair in the suspend status might be included. Copy Group Storage System Summary Panel When the F5=Storage key is pressed in the Copy Group Storage System Summary panel, the Copy Group Array Summary panel showing the number of copy pairs that are in individual - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 124
pairs in the NODELTA status CAA Copy Group Performance Statistics Panel For the CAA copy type, when the F5=Stats key is pressed in the Copy Group Storage System Summary panel, CAA performance information is displayed in the CAA Copy Group Performance Statistics panel. Figure 104 (page 124) shows - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 125
Device Addr. Domain Secondary DAD ID in the copy group definition file C/T ID Consistency group ID in the copy group definition file Pri-SN Storage system serial number of the copy source Sec-SN Storage system serial number of the copy target Pri %s SFT Sidefile threshold of Pri-SN - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 126
: • Before displaying CAA performance information in this panel, Usage Monitor should have started from Remote Web Console. If the copy group consists of USPV volumes only, there is no need to start Usage Monitor. • For Pri-SN and Sec-SN, information acquired from the storage system is displayed. If - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 127
the F5=Stats key is pressed in the Copy Group Storage System Summary panel, CAJ performance information is displayed in the CAJ Copy Group Performance Statistics panel. Figure 106 (page 128) shows the CAJ Copy Group Performance Statistics panel. Manage Copy Groups Panel (Copy Group Operation) 127 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 128
copy group definition file Serial number of a storage system of the copy source Serial number of a storage system of the copy target Data transfer rate (KB/s) between a Pri-Array and a Sec-Array possibly because a path between storage systems is temporarily out of service. • STOP: Data transfer has - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 129
P9500 disk array in this panel, it is necessary that the Usage monitor for the control unit (to which the journal volume used by the copy group definition file belongs) was started from Remote Web Console, and that the data capture interval of this Usage monitor is 10 minutes or less. • The storage - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 130
copy group definition Ascending file Serial number of the storage system for Pri-SN Ascending Serial number of the storage system Ascending Sort CAJ Copy Group Statistics Panel Pressing F6=Sort in the CAJ Copy Group Performance Statistics panel displays the Sort CAJ Copy Group Statistics panel, - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 131
Status Panel" (page 131) describes the items in the Copy Group Pair Status panel. Table 78 Contents of the Copy Group Pair Status Panel Item Copy Group ID Status Time Description Copy group ID The item corresponding to the displayed status time Manage Copy Groups Panel (Copy Group Operation) 131 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 132
the HP StorageWorks P9000 Continuous Access Synchronous User Guide: HP XP12000 Disk Array, HP XP10000 Disk Array, HP 200 Storage Virtualization System. VOLSER Pri Devn EX Dir Volume serial number P-VOL device number Displays the following information that indicates whether the P-VOL is an external - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 133
Copy Group Pair Status Panel (continued) Item Description EX Displays the following information that indicates whether the S-VOL is an external volume. • +: An external volume • -: Not an external is displayed. 3 If f is specified in the Manage Copy Groups panel, N/A is displayed. 4 If the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 134
Device Number 3. Primary Volume Serial Number 4. Secondary Device Number 5. C/T ID 6. sub C/T ID 7. Dir(>) 8. Dir( - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 135
(continued) Item 10. Primary external volume information 11. Secondary external volume information Sort Order Blank, +, or - in the EX for P-VOL Blank, +, or - in EX for S-VOL Volume Query Information (BC) Panel If you specify q in AC on the Copy Group Pair Status panel, the YKQRYDEV command is - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 136
Query Information (BC) Panel Item Copy Group ID Copy Group Type (in Configuration) Copy Group Type (from Storage System) Primary Volume SN SSID CU CCA DEVN Description Copy group ID Copy group type at definition Copy types held by the storage system Storage system serial number of the P-VOL - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 137
(BC) Panel (continued) Item Secondary Volume SN SSID CU CCA DEVN Description Storage system serial number A suspension was performed because no-update journal was detected. • N/A: This Copy pair is not the BC copy pair specified with displayed. Manage Copy Groups Panel (Copy Group Operation) 137 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 138
of the Volume Query Information (BC) Panel (continued) Item Preset Mode Status Description Type of ATTIME copy pair was abnormally terminated. • ERROR(0002): Since a storage system-derived error occurred, suspend processing for the BC copy pair was abnormally terminated. Contact the storage - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 139
: Update of the S-VOL is allowed after the copy pair is suspended (YKSUSPND command is executed). Pace of copying4, 1 • NORMAL: The speed of the copy operation improves. However, update I/O load on P-VOL is high, and this might affect the I/O performance of the host. • SLOW: Slows the speed of the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 140
of the volume which makes a copy pair 1 It is not displayed when the YKQRYDEV command has been executed for the HP StorageWorks XP1024/XP128 Disk Array. 2 See the table (for BC) in the HP StorageWorks P9000 for Business Continuity Manager Software User Guide for details about obtaining the status - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 141
Figure 112 Volume Query Information (CA) Panel Command ===> Volume Query Information (TC) Scroll ===> PAGE 2008/03/11 19:11:45 Copy Group ID TC Copy Type(in Configuration): TC Copy Type(from Storage System) : N/A ---------- Primary Volume ---------- --------- Secondary Volume --------- SN - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 142
: Slows the speed of the copy operation so that the effect of the copy operation on the I/O performance of the host is minimal. Fence level5 • DATA: Places P-VOL in fence status (updates suppressed) when updates in P-VOL cannot be copied to S-VOL due to a problem such as a failure. • STATUS: Places - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 143
in the storage system. • The Open/MF storage system serial number for the P-VOL of the copy pair specified in the Copy Group Pair Status panel • For Secondary: storage system serial number for the S-VOL of the copy pair specified in the Copy Group Pair Status panel Manage Copy Groups Panel (Copy - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 144
the HP StorageWorks XP1024/XP128 Disk Array. 2 For details about the status of the displayed copy pair, see the table (for CA/CAA) that shows the copy pair statuses of volumes obtained by using the YKQRYDEV command, in the HP StorageWorks P9000 for Business Continuity Manager Software Users Guide - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 145
information about a device of a remote storage system if the route list has not been loaded or the target storage system is not included in the route list Volume Query Information (CAA) Panel If you specify q in AC on the Copy Group Pair Status panel, the YKQRYDEV command is executed on the P-VOL - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 146
Volume Query Information (CAA) Panel Item Copy Group ID Copy Group Type(in Configuration) Copy Group Type(from Storage System) Primary Volume SN SSID CU CCA DEVN Description Copy group ID Copy group type at definition Copy types held by the storage system Storage system serial number of the P-VOL - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 147
continued) Item Description Dir Copy direction in the copy pair Always displays > when the Status of the Primary Volume is SIMPLEX. Secondary Volume SN SSID CU CCA DEVN Status Storage . Copy pair status2 JOURNAL is displayed for the journal volume.3 Manage Copy Groups Panel (Copy Group - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 148
Contents of the Volume Query Information (CAA) Panel (continued) Item Suspend ATTIME Consistency Time (GMT) Description time -TIMESTAMP TRIGGERED: A suspension was performed at ATTIME-suspend-time. • ATTIME-suspend-time -TIMEOUT TRIGGERED A suspension was performed due to a timeout. On the second - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 149
the speed of the copy operation so that the effect of the copy operation on the I/O performance of the host is minimal. FLOW CTL DIF UNIT GEN ID Value set for the sidefile inflow limit4 Units by which differential data is managed4 Generation ID Manage Copy Groups Panel (Copy Group Operation) 149 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 150
is displayed when volume online information cannot be obtained. Dir Pair Volume Status SN SSID CU Copy pair status6, 2 Copy direction in the copy pair Storage system serial number of the volume which makes a copy pair SSID for the volume which makes a copy pair CU number of the volume which makes - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 151
the HP StorageWorks XP1024/XP128 Disk Array. 2 For details about the status of the displayed copy pair, see the table (for CA/CAA) that shows the copy pair statuses of volumes obtained by using the YKQRYDEV command, in the HP StorageWorks P9000 for Business Continuity Manager Software User's Guide - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 152
Volume Query Information (CAJ) Panel Item Copy Group ID Copy Group Type (in Configuration) Copy Group Type (from Storage System) Primary Volume SN SSID CU CCA DEVN Description Copy group ID Copy type at definition Copy types held by the storage system Storage system serial number of the P-VOL at - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 153
continued) Item Description Dir Copy direction in the copy pair Always displays > when the Status of the Primary Volume is SIMPLEX. Secondary Volume SN SSID CU CCA DEVN Status Storage direction N/A is displayed if EXCTG is not defined. Manage Copy Groups Panel (Copy Group Operation) 153 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 154
. The timer type obtained from the storage system is displayed. N/A is displayed when a reverse direction timer type cannot be obtained Write-protect for the S-VOL3 • PROTECT: Update of the S-VOL is prohibited after the copy pair is suspended (YKSUSPND command is executed). • PERMIT: Update of the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 155
. Dir Pair Volume Status SN SSID CU Copy pair status2, 5 Copy direction in the copy pair Storage system serial number of the volume that makes a copy pair SSID of the volume that makes a copy pair CU number of the volume that makes a copy pair Manage Copy Groups Panel (Copy Group Operation) 155 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 156
the HP StorageWorks XP1024/XP128 Disk Array. 5 For details about the status of the displayed copy pair, see the table (for CAJ) that shows the copy pair statuses of volumes obtained by using the YKQRYDEV command, in the HP StorageWorks P9000 for Business Continuity Manager Software Users Guide. Note - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 157
as EXCTG. • N/A: Unable to identify the status. status2: Indicates whether the journal group of the copy destination volume has been registered in a storage system as EXCTG when a copy is being performed in the reverse direction. The characters displayed in status2 are determined according to the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 158
a device of a remote storage system if the route list has not been loaded or the target storage system is not included in the route list Volume Query Information Panel (Executing YKQRYDEV) When you specify q for the AC column of the Copy Group Pair Status panel, the YKQRYDEV command is executed for - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 159
Executing YKMAKE If m is specified in the AC column in the Manage Copy Groups panel, the YKMAKE command is executed. The Make Options panel corresponding to the copy type is displayed for specifying the YKMAKE command parameters. The Make Options panels are shown in Figure 116 (page 159), Figure 117 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 160
is displayed. Executing YKSUSPND If u is specified in the AC column in the Manage Copy Groups panel, the YKSUSPND command to suspend a copy pair is executed, and the Suspension Options panel for specifying YKSUSPND command parameters is displayed. The Suspension Options panel is shown in Figure 119 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 161
Figure 119 BC Copy Group Suspension Options Panel Figure 120 BC with C/T Copy Group Suspension Options Panel Figure 121 CA Copy Group Suspension Options Panel Manage Copy Groups Panel (Copy Group Operation) 161 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 162
Group Suspension Options Panel Figure 123 CAJ Copy Group Suspension Options Panel Displayed from the Manage Copy Groups Panel Figure 124 CAJ Copy Group Suspension Options Panel Displayed from the Copy Group Pair Status Panel "Contents of the Suspension Options Panel" (page 163) describes the items - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 163
the time of the suspend request. NOTE: • The Preset and Cancel Preset parameters are effective for BC and TCA copy groups with a consistency group ID, and can be specified for a remote storage system only when the CAJ ATTIME suspend function is used. Note that this setting is released by P/S ON/OFF - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 164
on whether the secondary volumes can be accessed or updated while a BC copy group for which NORMAL is specified is being transitioned to suspend mode, see the Business Copy for Mainframe Systems UserGuide: HP XP24000 Disk Array, HP XP20000 Disk Array. • CAJ(Steady): Uses the CAJ ATTIME suspend - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 165
group ID. The YKSUSPND command terminates successfully when the instruction to the copy pair succeeded. Even if the command has terminated successfully, make sure that the transition of the copy pair status was performed, using the YKQUERY command or the YKEWAIT command. If there is a volume - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 166
Figure 126 CA & CAA Copy Group Resync Options Panel Figure 127 CAJ Copy Group Resync Options Panel Displayed from the Manage Copy Groups Panel Figure 128 CAJ Copy Group Resync Options Panel Displayed from the Copy Group Pair Status Panel 166 ISPF Panels - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 167
of an error during delta resync. • All-Journal: Identifies the cause of an error during delta resync with full copy. If you do not specify anything, YKRESYNC command is executed without the ERRCHK parameter. You can specify this option for CAJ. Manage Copy Groups Panel (Copy Group Operation) 167 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 168
is not applied. The YKRESYNC command terminates successfully when the instruction to the copy pair succeeded. Even if the command has terminated successfully, make sure that the transition of the copy pair status was performed, using the YKQUERY command or the YKEWAIT command. If there is a volume - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 169
and then dissolve the copy pair. Executing YKWATCH If w is specified in the AC column in the Manage Copy Groups panel, the YKWATCH command to monitor the minute (0 to 9999). SEND Option Specify the USER, OPERATOR, or CN parameter of the YKWATCH command. 1 The sum total of the values specified in - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 170
be correctly monitored. Executing YKEWAIT If e is specified in the AC column in the Manage Copy Groups panel, the YKEWAIT command will be executed and the Wait Options panel for specifying the parameters of the YKEWAIT command is displayed. Figure 130 (page 170) and Figure 131 (page 170) show the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 171
ERRORS. YKEWAIT RC = xx when the YKEWAIT startup fails. Executing YKRECVER When specifying c in the AC column in the Manage Copy Groups panel, the YKRECVER command to dissolve a copy pair from the secondary site is executed. In this case, the Confirm Execution Recover panel prompts you to confirm - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 172
the Logical Path Status of Copy Group Pair panel used to display the status of physical paths in the logical path. Path type • CU: Inter-control unit logical path • DKC: Inter-disk controller logical path Primary Serial# PathID Serial number of the primary storage system Primary path ID When - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 173
Volume/Secondary Volume in the Copy Group Pair Status panel is a remote site, then either the route list is not specified, or the serial number of the storage system to which the device belongs is not registered in the route list specified for the YKLOAD command. Other than the above Return - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 174
Table 91 Contents of the Logical Path Status of Copy Group Pair Panel Item Copy Group ID Type Description Copy group ID Path type • CU: Inter-control unit logical path • DKC: Inter-disk controller logical path Primary S/N PathID Primary storage system serial number Primary path ID When the path - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 175
Path Status of Copy Group Pair Panel (continued) Item Secondary Status Description Secondary port number Status of each physical path • ESTABLISHED: The physical path has been established. • INIT FAILED: Initialization failed. • NO RESOURCES AT PRI: The port for the primary storage system is - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 176
Cancel key cancels the dissolving of the copy pair. Confirm Command Device Build Panel If b is specified in AC in the Route Status panel, the Confirm Command Device Build panel is displayed asking you whether you want to register the command device in the storage system. Figure 136 (page 176) shows - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 177
command device in the storage system. Pressing the F12=Cancel key cancels the registration of the command configuration file. Pressing the F12=Cancel key continues processing while keeping the update of the you attempt to cancel an update of the copy pair definition file or path set definition - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 178
Cancel key continues processing while keeping the update of the copy pair definition file or path set definition file. Confirm Command Device Delete command device registered in the storage system. Figure 139 (page 178) shows the Confirm Command Device Delete panel. Figure 139 Confirm Command Device - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 179
device Specified DAD ID Model name of the storage system to which the specified command device belongs Microcode information for the storage system to which the specified command device belongs Interface version of the storage system to which the specified command device belongs Serial number of the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 180
Device Delete Panel (displayed from Extra Command Device Direct Operation Panel) (continued) Item CCA APID Description CCA to which the specified command device belongs APID of the specified command device For the HP StorageWorks XP1024/XP128 Disk Array, or when APID information cannot be obtained - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 181
the copy group definition file, the disk configuration definition Manage Copy Groups panel without executing the YKLOAD command, the Confirm Copy Group Load panel is displayed to request the copy group load. Figure 143 (page 181) shows the Confirm Copy Group Load panel. Figure 143 Confirm Copy - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 182
target volume (S-VOL) will be overwritten when the YKMAKE or YKRESYNC command is executed. Pressing the Enter key overwrites the contents of the online (S-VOL). Confirm Path Delete Panel If d is specified in AC in the Manage Path Set panel or Path Set Status panel, the Confirm Path Delete panel is - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 183
=Cancel key cancels the deletion of the logical path. Confirm Path Set Load Panel When you specify b or q in AC of the Manage Path Set panel without executing the YKLOAD command, the Confirm Path Set Load panel is displayed, requesting the loading of the path set. Figure 146 (page 183) shows the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 184
the beginning. Confirm Retry of Configuration File Create Panel In defining copy groups, if an error occurs during creation of the configuration file creation of the configuration file, see the HP StorageWorks P9000 for Business Continuity Manager Software Users Guide. Figure 149 (page 184) shows the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 185
Group Suspension panel is displayed, requesting confirmation of the suspension. HP recommends that you first check whether suspending the open-system copy pairs is acceptable, and then perform the suspension because open-system copy pairs contained in the same consistency group are also suspended - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 186
Business Continuity Manager. • " Copy Types and Targets for Which Commands Can Be Executed" (page 187) • "List of Functions" (page 187) • "Configuration Files That Must Be Loaded Before Command Execution" (page 188) • "YKBLDCMD Command" (page 191) • "YKBLDPTH Command" (page 192) • "YKCONMSG Command - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 187
a script by using the YKLOAD command and then expanded. Obtains a Business Continuity Manager environment variable and displays it in the TSO/E terminal. Displays storage system sense byte information (error codes) on the TSO/E terminal. Copy Types and Targets for Which Commands Can Be Executed 187 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 188
Table 99 List of Supported Functions (continued) Command Function YKEWAIT Monitors the copy pair status transition and waits for a certain specified status. YKEXPORT Outputs the contents of a copy group definition file to a CSV file. YKFCSTAT Acquires the FlashCopy information for the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 189
not recognize the P-VOL (remote storage system) or the S-VOL (Non Gen'ed volume). • The copy type parameter is BC, and the host does not recognize the P-VOL (Non Gen'ed volume) but recognizes the S-VOL. Table 100 Configuration Files That Must Be Loaded Before Command Execution (When the Environment - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 190
Command Execution (When the Environment Does Not Contain a Non Gen'ed Volume) (continued) Command name Configuration file that must be loaded Copy copy group operation commands. 3 You need to load the configuration file when acquiring information about an S-VOL that is not recognized by the host. - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 191
Table 101 Configuration Files That Must Be Loaded Before Command Execution (When the Environment Contains a Non Gen'ed Volume) (continued) Command name Configuration file that must be loaded YKMAKE Copy group definition file Y Route list definition file D2 Path set definition file -- YKQHPATH - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 192
storage systems when a command device is registered. • The corresponding command device should be offline before the YKBLDCMD command command terminates. Table 102 YKBLDCMD Command Return Code List Return Code -4095 to -4040 -3 Meaning The command terminated abnormally, possibly because the user - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 193
. You must also include a trailing period character. The message structure is initialized when the Business Continuity Manager command with the same name as the MSG parameter is called. PSN(storage system-serial-number) ~ If this parameter is specified, for - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 194
-specified-in-STEM-parameterPATH.n.Sec, in the forward direction. REVERSE The command establishes the logical paths that are identified in the path set stored in the path set structure specified by the STEM parameter. Each path extends from the initiator node defined by stem-name-specified-in-STEM - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 195
NOTE: • Before executing the command, create and load the path set definition file. • If a message that contains sense information for the storage system is output, see the list of error codes in the HP StorageWorks P9000 for Business Continuity Manager Messages and then eliminate the cause of the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 196
command is a TSO/E command called from REXX scripts. This command monitors for the following messages: • IEA494I message Copy status display message that is output to the MVS console • IOSHM0414I message HyperSwap completion message that is output to the MVS console • User-specified message User - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 197
console. Thus, the YKCONMSG command cannot monitor status transitions of a copy pair on a remote site. ◦ The IOSHM0414I message or user-specified messages are not displayed on the MVS console An interruption occurred during execution. 0 Open processing terminated normally. 1 Message specified - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 198
Specify the device number of the command device that you want to delete. The route list does not need to be loaded for the locally connected storage system when this parameter is specified. You cannot specify the DEVN parameter for a remotely connected storage system. MSG(stem-name-1) ~ - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 199
device is online or offline: ◦ HP StorageWorks XP12000/XP10000 Disk Array ◦ HP StorageWorks XP24000/XP20000 Disk Array ◦ HP StorageWorks P9500 Disk Array • When deleting a command device not specified in the route list on the remote storage system, before executing this command, you need to create - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 200
execution target of the command. COND Only pairs with certain volume statuses are affected by the command. For details on the copy pairs that are affected by the command, see the table regarding copy pair statuses that are affected by commands in the P9000 for Business Continuity Manager. 200 CLI - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 201
copy pair corresponding to the device number specified with the DEVN parameter is not found. 128 The command terminated abnormally. The user does not have permission to execute this command. YKDELPTH Command Applies to PTH. Format YKDELPTH 1STEM(stem-name-1)] 1MSG(stem-name-2) [ 1PSN(storage - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 202
parameter) as RCUs, and inter-disk controller logical paths will be deleted in all cases where the paths treat the storage system (that has the serial number specified by this parameter) as the secondary storage system. If this parameter is not specified, the command deletes all logical paths with - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 203
defined by stem-name-specified-in-STEM-parameterPATH.n.Sec. REVERSE The command deletes logical paths that are identified in the path set stored in deleted. If neither this parameter nor any other parameters are specified, the command deletes all logical paths. CU Out of the logical paths within the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 204
NOTE: • Before executing the command, create and load the path set definition file. • If a message that contains sense information for the storage system is output, see the list of error codes in the HP StorageWorks P9000 for Business Continuity Manager Software Messages and then eliminate the cause - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 205
(copy group structures, route list structures, path set structures, Host-Discovered Array Index structures, and Host-Discovered Array structures when the YKDROP command terminates. Table 108 YKDROP Command Return Code List Return code 0 48 1004 1008 Meaning The command terminated normally. - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 206
was being accessed. NOTE: This occurs when the IRXEXCOM routine's return code (R15) is -2, -1, 28, or 32. 2000 A system error occurred. YKENV Command Format YKENV Function This is a TSO/E command called from REXX scripts. This command outputs Business Continuity Manager environment variables - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 207
. Value of the system symbol &YKSYSLG. If &YKSYSLG is not set, N/A is displayed. Output example The following is an output example of the YKENV command: HP StorageWorks P9000 for Business Continuity Manager Software BC Manager environment variables (6.5.0-00(01)) Host ID: 00 License info DSN prefix - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 208
describes storage system sense byte information in the HP StorageWorks P9000 for Business Continuity Manager Software Messages. Example The following shows an example of executing the YKERCODE command. READY YKERCODE 6A13 Error details: The command could not be executed because a remote command was - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 209
program control function. YKEWAIT Command Applies to Business Copy for Mainframe, Continuous Access Synchronous for Mainframe, Continuous Access Synchronous for Mainframe with the HyperSwap attribute, Continuous Access Asynchronous for Mainframe, and Continuous Access Journal for Mainframe. Format - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 210
status. SWAPPING Applies to Continuous Access Synchronous for Mainframe, Continuous Access Synchronous for Mainframe with the HyperSwap attribute, Continuous Access Asynchronous for Mainframe, and Continuous Access Journal for Mainframe. The command waits until all copy pairs in the group reach - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 211
not change to that specified in the GOTO parameter, command processing will continue until the timeout time specified in the TIMEOUT parameter is HOLDER, HOLDTRNS, NODELTA, CONSLOST, or INVALID statuses. When the command waits for copy pairs in the CG container specified by EXCTG ID to reach DUPLEX - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 212
copy pair to operate, to view REXX variables (such as SimplexCt) shown in information for copy pairs that are not operation targets, execute the YKQUERY command or YKEWAIT command for all copy pairs. TO({PRIMARY|SECONDARY}) Applies to Continuous Access Synchronous for Mainframe, Continuous Access - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 213
registered in EXCTG. YKEXPORT Command Applies to Business Copy for Mainframe, Continuous Access Synchronous for Mainframe, Continuous Access Synchronous for Mainframe with the HyperSwap attribute, Continuous Access Asynchronous for Mainframe, and Continuous Access Journal for Mainframe. Format - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 214
structure, and then returns a return code other than 0. This command can be used for volumes of the following models on which FlashCopy Mirror Version 2 is installed: • HP StorageWorks XP12000/XP10000 Disk Array • HP StorageWorks XP24000/XP20000 Disk Array • HP StorageWorks P9500 Disk Array 214 CLI - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 215
due to processing errors. 48 Terminating due to invalid parameters. 128 The command terminated abnormally. The user does not have permission to execute this command. YKFREEZE Command Applies to Continuous Access Synchronous for Mainframe. Format YKFREEZE 1STEM(stem-name-1) 1MSG(stem-name - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 216
Function This command: • Is a TSO/E command called from REXX scripts. • Is executable for a copy group specified by the consistency group ID. • Freezes the specified copy group, changes it to the SCP status and suspends update I/O to the P-VOL. • Works when the storage system has the corresponding - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 217
VOLs and S-VOLs (CA copy pairs that have the HyperSwap attribute of Business Continuity Manager). Before executing this command, you must use Business Continuity Manager to create a disk configuration definition file for the storage system to scan. If the disk configuration definition file does not - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 218
a change was detected in an I/O configuration while the YKH2B command was being executed by omitting the HS parameter or by specifying CHECK. • Although a copy group definition file was generated, a storage system that does not support 2DC configurations with HyperSwap and CAJ was detected. 8 An - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 219
YKIMPORT Command Applies to Business Copy for Mainframe, Continuous Access Synchronous for Mainframe, Continuous Access Synchronous for Mainframe with the HyperSwap attribute, Continuous Access Asynchronous for Mainframe, and Continuous Access Journal for Mainframe. Format YKIMPORT 1PREFIX(prefix) - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 220
codes to be returned when the YKINSCHK command terminates. Table 119 YKINSCHK Command Return Code List Return Code 0 8 32 Meaning There are no problems in the settings. There is a problem with the settings. A processing error occurred during command execution. Output items Table 120 (page 221 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 221
the permission that is required in order to execute a CLI command for referencing or operations. Version of user SVC The user SVC version, which can be used with the Business Continuity Manager instance for this program that is running. Current User SVC: SVC Number Outputs the SVC number of the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 222
CLI commands. After a profile is defined in the RACF FACILITY class, a user can use CLI commands by being given the access rights User SVC: : START YKALCSVC : Note: A User SVC registered by using the YKALCSVC command will become invalid during a re-IPL. As a result, we recommend performing - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 223
Copy group structure • Host-Discovered Array Index structure • Host-Discovered Array structure ROUTE • Disk configuration definition file • Route list definition file • Command device definition file • Route list structure • Host-Discovered Array Index structure • Host-Discovered Array structure - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 224
STEM parameter, the Host-Discovered Array Index structure is > Specify the DAD ID (host DAD ID) specified in the current host DAD ID. You must specify this parameter when you operate the copy group. Maximum length that can command. You must also include a trailing period character. The message - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 225
storage system connected to the host where Business Continuity Manager is running. • When operating with a route list, to execute the YKLOAD command the disk configuration definition file of the storage system on the secondary site (as created by the remote scan) is copied to the secondary host. - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 226
to invalid parameters. Terminating due to improper invocation method. YKMAKE Command Applies to Business Copy for Mainframe, Continuous Access Synchronous for Mainframe, Continuous Access Asynchronous for Mainframe and Continuous Access Journal for Mainframe. Format YKMAKE 1STEM(stem-name-1) 1MSG - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 227
depend on their volume status. For more information, see the table regarding copy pair statuses that are manipulated by the command in the HP StorageWorks P9000 for Business Continuity Manager Software Users Guide. For CG containers specified by EXCTG ID, journal groups not registered in EXCTG - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 228
pairs sharing P-VOL with the specified copy pairs, the number of CAJ copy pairs sharing S-VOL with the specified copy pairs, and the status of copy pairs. • Because the EXCTG registration processing is performed asynchronously with the YKMAKE command, an error might occur during EXCTG registration - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 229
The user does not have permission to execute this command. YKQRYDEV Command Applies to Business Copy for Mainframe, Continuous Access Synchronous for Mainframe, Continuous Access Synchronous for Mainframe with the HyperSwap attribute, Continuous Access Asynchronous for Mainframe, Continuous Access - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 230
is a TSO/E command called from REXX scripts. Storage system information about the specified volume is obtained from the storage system, and stored in the device information structure specified by the STEM parameter. For a copy pair, you can specify this for either the P-VOL or the S-VOL. If the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 231
is HP StorageWorks XP24000/XP20000 Disk Array. VSP Specify this option when the model of the secondary storage system for the inter-disk controller logical path you want to obtain is VSP. Return Codes Table 125 (page 231) lists the return codes to be returned when the YKQRYDEV command terminates - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 232
. You must also include a trailing period character. The message structure is initialized when the CLI command with the same name as the MSG parameter is specified. PSN(storage system-serial-number) ~ If this parameter is specified, for each logical path within - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 233
extends from the initiator node defined by stem-name-specified-in-STEM-parameterPATH.n.Pri to the target node defined by stem-name-specified-in-STEM-parameterPATH.n.Sec. REVERSE The command is set on the storage system, the command sets the port information on the storage system to the REXX - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 234
type. NOTE: • Before executing the command, create and load the path set definition file. • If a message that contains sense information for the storage system is output, see the list of error codes in the HP StorageWorks P9000 for Business Continuity Manager Software Messages and then eliminate the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 235
user does not have permission to execute this command. YKQUERY Command Applies to Business Copy for Mainframe, Continuous Access Synchronous for Mainframe, Continuous Access Synchronous for Mainframe with the HyperSwap attribute, Continuous Access Asynchronous for Mainframe, and Continuous Access - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 236
see the description of the copy group configuration check function in the HP StorageWorks P9000 for Business Continuity Manager Software Users Guide. NOTE: • For CG containers specified by EXCTG ID, if you execute the YKDELETE command and then the YKQUERY command to obtain the copy pair status, the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 237
copy pair corresponding to the device number specified with the DEVN parameter is not found. 128 The command terminated abnormally. The user does not have permission to execute this command. YKRECVER Command Applies to Continuous Access Synchronous for Mainframe, Continuous Access Synchronous - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 238
dissolve copy pairs during a planned outage. Return Codes Table 128 (page 238) lists the return codes to be returned when the YKRECVER command terminates. Table 128 YKRECVER Command Return Code List Return Code -4095 to -4040 -3 Meaning The command terminated abnormally, possibly because the user - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 239
user does not have permission to execute this command. YKRESYNC Command Applies to Business Copy for Mainframe, Continuous Access Synchronous for Mainframe, Continuous Access Synchronous for Mainframe with the HyperSwap attribute, Continuous Access Asynchronous for Mainframe, and Continuous Access - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 240
For more information, see the table showing the copy pair statuses that are manipulated by the command, in the HP StorageWorks P9000 for Business Continuity Manager Software Users Guide. {QUICK|NORMAL} Applies to Business Copy for Mainframe. Specify the copy mode. QUICK Transit to the DUPLEX status - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 241
and the ERRCHK parameter to make sure the command terminates successfully with the return code 0. 2. Execute the YKRESYNC command with only the ALLJNL parameter to make sure there all copy pairs can perform full copy. ERRCHK Applies to Continuous Access Journal for Mainframe. Identify the cause of - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 242
Applies to Continuous Access Synchronous for Mainframe. Specify this parameter to change the Open/MF Consistency attribute (whether the Open/MF Consistency Preservation Function is used). The Open/MF Consistency attribute of the copy group definition information that is loaded when the command that - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 243
, a CA, CAA, or CAJ copy cannot be performed in the reverse direction (from the secondary site to the primary site). HP recommends strongly that copying from a small volume to a large volume function should be used exclusively for data migration. • After this command is executed against a volume is - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 244
. The user does not have permission to execute this command. YKRUN Command Applies to Continuous Access Synchronous for Mainframe. Format YKRUN 1STEM(stem-name-1) 1MSG(stem-name-2) Function This Command: • Is a TSO/E command called from REXX scripts. • Cancels the SCP status for the specified copy - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 245
. 128 The command terminated abnormally. The user does not have permission to execute this command. YKSCAN Command Format YKSCAN 1STEM command is executed. Parameters STEM(stem-name-1) ~ Specify an optional prefix for the name of the Host-Discovered Array - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 246
by appending n to the stem name specified by the ARRAYS parameter). NOTE: • Before creating a copy group, use the YKSCAN command to obtain the information on the volumes available on this site. • If storage system functions or information such as the Software Keys or microcode number is changed - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 247
definition occurred while storage system information was command terminated abnormally. The user does not have permission to execute this command. YKSLEEP Command Format YKSLEEP [ 1{SEC(timeout-value))|MIN(minutes)} Function This command is a TSO/E command called from REXX scripts. This command - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 248
Command Applies to Continuous Access Asynchronous for Mainframe and Continuous Access Journal for Mainframe. Format YKSTATS 1STEM(stem-name-1) 1MSG(stem-name-2) Function This command is a TSO/E command called from REXX scripts. This command acquires the operating information for the specified copy - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 249
copy group. ◦ HP StorageWorks XP24000/XP20000 Disk Array volumes ◦ HP StorageWorks P9500 Disk Array • If the specified copy group is a CAA copy group and contains only HP StorageWorks XP24000/XP20000 Disk Array volumes, you do not need to start Usage Monitor. • When CAA is used, the storage system - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 250
command is an REXX subroutine, so it should be called from REXX script by the REXX CALL key word instruction. • When you store the current volume status in a configuration file, HP recommends that you specify a prefix other than the prefix used when the copy group was created and manage the copy - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 251
parameters. Terminating due to improper invocation method. YKSUSPND Command Applies to Business Copy for Mainframe, Continuous Access Synchronous for Mainframe, Continuous Access Asynchronous for Mainframe, and Continuous Access Journal for Mainframe. Format YKSUSPND 1STEM(stem-name-1) 1MSG - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 252
use the ATTIME suspend function, specify the time at which suspend processing is performed. This parameter is valid for copy groups specified by consistency group ID. If you do not use the CAJ ATTIME suspend function, this parameter cannot be specified for a remote storage system. 252 CLI Commands - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 253
a time later than 2042/9/17 23:53:47 GMT. • If the host on which the command is executed is different from the host that issues an I/O to the storage system, synchronize the time between the hosts. ATOPT({NORMAL|CAJ[({STEADY|QUICK})]}) Applies to Business Copy for Mainframe. Command details 253 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 254
copy copy copied Business Copy for Mainframe. If you use the CAJ ATTIME suspend function, specify the timeout value in minutes. When the journal is acquired at the remote storage system, the copy copy pair storage systems are recovered. CANCEL Applies to Business Copy for Mainframe, Continuous Access - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 255
is not canceled because it has not been set.1 The NORMAL ATTIME suspend time is not canceled because it has not been set.1 Legend: --: Not applicable DRAIN Applies to Continuous Access Asynchronous for Mainframe. Command details 255 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 256
StorageWorks P9000 Business Copy for z/OS User Guide: HP XP12000 Disk Array, HP XP10000 Disk Array, HP 200 Storage Virtualization System. When the CAJ ATTIME suspend function is used, the method of performing suspensions used depends on the specified ATOPT parameter. FORWARD Applies to Continuous - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 257
suspend are canged as follows, depending on the copy type: Copy type Business Copy for Mainframe Continuous Access Asynchronous for Mainframe Write permissions to the S-VOL , 4-digit hexadecimal number> Specify the device number of the copy pair (P-VOL and S-VOL) to operate. Command details 257 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 258
is performed by volume even when the environment supports operation by group. Usually, to operate by volume only those copy pairs whose describing the copy pair statuses that are subject to the command, in the HP StorageWorks P9000 for Business Continuity Manager Software Users Guide. NOTE: - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 259
suspend time for the remote storage system was made. 128 The command terminated abnormally. The user does not have permission to execute this command. YKWATCH Command Applies to Business Copy for Mainframe, Continuous Access Synchronous for Mainframe, Continuous Access Synchronous for Mainframe - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 260
) ~ Specify the current host DAD ID. Maximum length that can actually be specified = 44 - (13 + PREFIX-length) USER({user-id|*}) ~ Specifies the terminal to which messages issued by the YKWATCH command are transmitted. user-id Transmits the messages to the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 261
cannot monitor the status transition of the copy pair on the remote site. Use the YKEWAIT command. • When using a CAJ copy pair, the YKWATCH command cannot monitor the status transition of the CAJ copy pair. Use the YKEWAIT command. • Execute the YKWATCH command when device numbers are assigned for - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 262
Command Return Code List (continued) Return Code 44 48 Meaning Terminating due to invalid processing. Terminating due to invalid parameters. YKWTOMSG Command within a REXX script. This command outputs the specified message ID and message text to the OS console. Parameters type Specify the type - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 263
IBM documentation MVS Programming: Assembler Services Reference. CLI Command Coding Examples Coding examples for each CLI command are stored in the sample library name YKDEMO01 Overview Uses the following CLI commands to demonstrate basic operations on copy groups: • YKLOAD • YKMAKE • YKSUSPND - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 264
a script from the OS console. In this file, the following sample script is executed: • YKDEMO10 YKDEMO11 YKDEMO12 Shows an example of using the YKENV command to obtain a Business Continuity Manager environment variable in a REXX variable. Shows an example of detecting a copy pair in the CONSLOST - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 265
Hitachi, Ltd. */ /* */ /* */ /* YKDEMO01 - A sample demonstration script that illustrates how to */ /* use the Business Continuity Manager's REXX CLI commands for */ /* manipulation of a copy called with "call" instruction because it is * a REXX subroutine, not TSO/E command. */ call " - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 266
one or more volumes in the given * copy group are offline, which is not necessarily Business Continuity Manager Reference Guide to see how * YKQUERY and YKEWAIT update the Copy /* * Establish all copy pairs in MYTCS copy group into DUPLEX. * automatically skip a copy pair that is already - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 267
return code for * YKEWAIT indicates that the copy pair state transition did not * happen as copy pairs in MYTCS copy group. * Like YKMAKE, use SELECT(COND) to let YKSUSPND skip a copy ; else nop; /* * Wait until all copy pairs in MYTCS copy group become suspended. */ address TSO "YKEWAIT STEM - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 268
copy pairs in MYTCS copy group. * Use SELECT(COND) parameter to let YKRESYNC skip copy end; else nop; /* * Wait until all copy pairs in MYTCS copy group become DUPLEX. */ address TSO "YKEWAIT STEM( call printCopyGroupStatus; /* * Dissolve all copy pairs in MYTCS copy group, putting them back to * - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 269
This procedure prints the status information * of copy pairs in the copy group "MYTCS". */ printCopyGroupStatus: procedure expose Hitachi, Ltd. */ /* */ /* */ /* YKDEMO02 - A sample demonstration script that illustrates how to */ /* use the Business Continuity Manager's REXX CLI commands - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 270
and re-attempt to detect completion of the * copy process. This cycle will continue for 10 times unless * completion of the copy process is detected. */ outFlag = "INLOOP"; do i = 1 to 10 while (outFlag == "INLOOP") /* * Use YKFCSTAT command to view the current status of the * FlashCopy processing - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 271
(C) 2007, 2010, Hitachi, Ltd. */ /* */ /* /* YKDEMO03 - A sample demonstration script that illustrates how to */ /* use the Business Continuity Manager's REXX CLI commands for */ /* establishing and deleting routes (command devices) and logical */ /* paths between two storage systems - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 272
the primary and the secondary * storage systems in direction from the primary storage system * to the secondary storage system. */ address TSO "YKBLDPTH to the Business Continuity Manager Reference Guide for the * full details about information items available in the Path Set 272 CLI Commands - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 273
the information about a volume device that was * specified in its parameters. The following example retrieves the * information about the command device in the primary storage system. * The information is stored under "DEMO_CDEVP" as specified by the * STEM parameter. * The following code shows one - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 274
then do call printErrorMessage; exit; end; else nop; /* * Print the information in the command device in the primary * storage system. * Refer to the Business Continuity Manager Reference Guide for the * full details about information items available by YKQRYDEV. */ say say "CDEV(Primary) - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 275
printErrorMessage; exit; end; else nop; /* * Now delete the command device in the primary storage system. As * in the previous YKDELCMD call, supply the appropriate same path because * deleting such a shared path will affect other users or applications * who are using the same path. */ address TSO " - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 276
All Rights Reserved. Copyright (C) 2007, 2010, Hitachi, Ltd. */ /* */ /* */ /* YKDEMO04 - A sample demonstration script that illustrates how to */ /* use the Business Continuity Manager's REXX CLI commands for */ /* using Extended C/T Group feature of TrueCopy Synchronous. */ /* This - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 277
copy OPEN) parameter to establish the EMCS console * interface for monitoring IEA494I message. Use OUTTRAP instruction OPEN) is 0. */ temp = OUTTRAP("MyHandle."); address TSO "YKCONMSG OP(OPEN)"; temp = OUTTRAP("OFF"); if rc /= 0 then do say "YKCONMSG OP(OPEN (OPEN). console * interface. * - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 278
may check the return code of each command for * more thorough error checking. */ /* * Block the host I/O for 5 seconds. Use YKRUN to resume * I/O earlier. */ address TSO "YKFREEZE STEM(DEMO_INFO.) MSG(DEMO_MSG.)", "TIMEOUT(5000)"; /* * Suspend the TC-Sync copy group. */ address TSO "YKSUSPND STEM - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 279
.) MSG(DEMO_MSG.)", "GOTO(SUSPEND) TIMEOUT(30)"; /* Check if the TC-Sync copy group is suspended. */ if rc /= 0 then do call printErrorMessage; /* * Close the EMCS console interface that was opened by * the previous YKCONMSG OP(OPEN) call. Note that the * return code for YKCONMSG with OP(CLOSE - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 280
All Rights Reserved. Copyright (C) 2007, 2010, Hitachi, Ltd. */ /* */ /* */ /* YKDEMO05 - A sample demonstration script that illustrates how to */ /* use the Business Continuity Manager's REXX CLI commands for */ /* obtaining various copy group information. */ /* */ /* This sample - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 281
exit; end; else nop; /* * Call YKQUERY to fully update the information in the Copy Group * structure of MYTCA copy group. * YKEWAIT with TIMEOUT(0) as demonstrated in YKDEMO01 should not be * used because if it is bigger than 8. */ if rc > 8 then do call printErrorMessage; exit; Command details 281 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 282
YKSTATS to obtain * performance information. */ address TSO Business Continuity Manager * Reference Guide for the list of all information items that you can * obtain via YKQUERY and YKSTATS. * For C/T Delta value, this sample script shows the value from just * one copy pair. You may view Commands - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 283
*/ /* */ /* All Rights Reserved. Copyright (C) 2007, 2010, Hitachi, Ltd. */ /* */ /* */ /* YKDEMO06 - A sample demonstration script that illustrates how to */ /* use the Business Continuity Manager's YKWATCH command. */ /* */ /* This sample script assumes the following settings - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 284
* statuses, too. * In this example, YKWATCH monitors MYTCS copy group to become * DUPLEX for 30 minutes, and notifies a user about such status * transition by sending a notification message to the current user's * console. */ call "YKWATCH" "PREFIX(BCM.DEMO) GROUP(MYTCS) GOTO(DUPLEX)", "TIMEOUT - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 285
Hitachi, Ltd. */ /* */ /* */ /* YKDEMO07 - A sample demonstration script that illustrates how to */ /* use the Business Continuity Manager's YKRECVER command call printErrorMessage; exit; end; else nop; /* * Update the Copy Group structure for MYTCS before YKMAKE. You may * also use - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 286
nop; /* * The line below shows how to execute YKRECVER. * The situation in which you have to use this command is rare, but * this command is useful when the primary site failed and a copy * group between the primary and the secondary sites cannot be * dissolved from the primary site. In such a case - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 287
demonstration script that illustrates */ /* how to use the Business Continuity Manager's CLI commands to */ /* perform fail-over operations in a 2DC configuration with */ /* HyperSwap and UR. */ /* This script can be used when storage system at the primary */ /* site has been stopped - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 288
configuration with HyperSwap and UR. */ address TSO "YKEWAIT STEM(DEMO_INFO.MYUR1.) MSG(DEMO_MSG.)", "GOTO(DUPLEX) TIMEOUT(0) NOINVALIDCHECK" /* * Check the return code of YKEWAIT. 288 CLI Commands - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 289
do call printErrorMessage exit end else nop /* * Use YKCONMSG with the OP(OPEN) and MSGID(IOSHM0414I) parameters * to establish the EMCS console interface to monitor the IOSHM0414I * message. Use the REXX instruction OUTTRAP to acquire the handler * value that needs to be referenced in subsequent - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 290
message is * generated due to the relevant copy pair in the MYTCHS * copy group performing a planned or unplanned HyperSwap. */ PlannedFound of the secondary volume that belong * to the MYTCHS copy pair to see if a DeltaResync * can be performed. */ address TSO "YKEWAIT STEM(DEMO_INFO.MYTCHS.)", " - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 291
MYUR1 copy pair is in a * status where a DeltaResync can be performed. copy pair is in a status * where a DeltaResync can be performed. copy pair to change the status of * MYUR1 into one where a DeltaResync can be performed the MYUR1 copy pair is in a status * where a DeltaResync can be performed. */ - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 292
leave /* Exit the loop. */ end else nop /* * Wait for completion of copying from the local site to * the remote site. */ address TSO "YKEWAIT STEM(DEMO_INFO.MYUR2.) MSG(DEMO_MSG.)", "GOTO(DUPLEX) TIMEOUT monitoring IOSHM0414I." leave end else nop end /* do forever */ 292 CLI Commands - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 293
/* All Rights Reserved. Copyright (C) 2009, 2010, Hitachi, Ltd. */ /* */ /* */ /* YKDEMO09 - A sample demonstration script that illustrates */ /* how to use the Business Continuity Manager's CLI commands to */ /* perform fail-back operations in a 2DC configuration with */ /* HyperSwap - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 294
*/ /* a DKC failure, before using this sample script, change the */ /* status of the MYTCHS copy pair to Swapping that direction */ /* is the primary site to the secondary site. */ /* 1) Call * Check the return code of YKLOAD. */ if result /= 0 then do call printErrorMessage 294 CLI Commands - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 295
* the copy pair can be copied. */ address TSO "YKEWAIT STEM(DEMO_INFO.MYUR1.) MSG(DEMO_MSG.)", "GOTO(SIMPLEX) TIMEOUT(10)" /* * Check the return code of YKEWAIT. */ if rc /= 0 then do call printErrorMessage exit end else nop say "#-- MYTCHS copy pair change to DUPLEX state in TPC-R." Command details - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 296
code of YKMAKE. */ if rc /= 0 then do call printErrorMessage end else nop /* * Confirm that the status of the MYUR1 copy pair is one where a * DeltaResync can be performed. */ address TSO "YKEWAIT STEM(DEMO_INFO.MYUR1.) MSG(DEMO_MSG.)", "GOTO(HOLD) TIMEOUT(10)" /* * Check the return code of YKEWAIT - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 297
else nop /* * Confirm that the status of the MYUR2 copy pair is one where a * DeltaResync can be performed. */ address TSO "YKEWAIT STEM(DEMO_INFO.MYUR2.) MSG(DEMO_MSG nop /* * Execute a DeltaResync on the MYUR1 copy pair to change * the status of MYUR1 to DUPLEX, and to change Command details 297 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 298
completion of copying from the primary site to * the remote site. */ Hitachi, Ltd. */ /* */ /* */ /* YKDEMO10 is a sample demonstration script of YKWTOMSG. */ /* Using YKWTOMSG, a REXX script can pass a string to another script */ /* through a MCS console. */ /* */ 298 CLI Commands - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 299
/* * Retrieve a volume information in the storage system. DEVN * operand is specified a device Writing USR001E message with * return code of the command to MCS console. Then, terminate * the script. */ wtorc = //* All Rights Reserved. Copyright (C) 2009, 2010, Hitachi, Ltd. //* Command details 299 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 300
Reserved. Copyright (C) 2010, Hitachi, Ltd. */ /* Output setting for the CLI command-execution logs */ /* */ push_trap) /* Parse each line of the LINE array to get the status of the */ /* Var line.i text ':' value . Select When text == 'Host ID' Then HostID = value When text == 'License - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 301
Say '1) Host ID Say '2) License info DSN prefix Say '3) BCM log output method Say '4) CLI log output settings = ' HostID = ' LicDSN = ' BCMLog = ' CLILog Exit save_retc Command details 301 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 302
YKDEMO12 302 CLI Commands - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 303
Rights Reserved. Copyright (C) 2011, Hitachi, Ltd. */ /* */ /* */ /* YKDEMO12 is an example script that demonstrates recovery of TC */ /* pairs that became inconsistent because of interrupted FlashCopy */ /* copy process. This script discovers CONSLOST copy pairs in the TC */ /* group - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 304
Else Nop /* * Confirm that the status of the deleted pair is one where * the copy pair can be copied. */ Address TSO "YKEWAIT STEM(DEMO_INFO.) MSG(DEMO_MSG.)", "GOTO(SIMPLEX) TIMEOUT(1) NOINVALIDCHECK", "DEVN (10)", "DEVN("P_DEVN","S_DEVN")" /* * Check the return code of YKEWAIT. 304 CLI Commands - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 305
END YKDEMO12." Exit /* * PrintErrorMessage: This procedure prints all of the error messages * in the Message structure when a CLI command failed. */ PrintErrorMessage: procedure expose DEMO_MSG. Do x = 1 To DEMO_MSG.0 Say "Severity = " || DEMO_MSG.x.Severity Say "Text = " || DEMO_MSG.x.Text - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 306
• "REXX Variables Updated by YKQUERY and YKEWAIT Commands" (page 349) • "CSV Files Used by the Copy Group Definition File Generation Function" (page 355) • "Calling HP Technical Support" (page 360) Saving and Converting Objects Running Business Continuity Manager data objects exist as REXX variable - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 307
are listed in Table 143 (page 307). Table 143 Configuration File Dataset Format Type of the configuration file Copy group definition file Disk configuration definition file Route list definition file Command device definition file Path set definition file DSORG PS PS PS PS PS RECFM VB VB VB VB VB - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 308
Description item of the ISPF panel, then the required disk space will increase according to the number of included Copy group definition file The YKSTORE command has 400 been used in the script. + J x 16 + A x (2,760 + J x 16) + B x 90 XML Document Type Definitions Business Continuity Manager - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 309
configuration file read processing in Business Continuity Manager. • API Information All XML data objects in Business Continuity Manager should be within the CUNum SSID CCA External Meaning Storage system serial number CU number SSID CCA External volume information • Copy Pair Status - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 310
Meaning Copy pair status C/T delta value Copy pair matching rate Whether direction is reverse from Secondary to Primary • Copy Pair When Y, the timestamp transfer mode is enabled. Unit of difference management When Y, the Open/MF Consistency Preservation Function is used. • TCA Option - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 311
indicates whether secondary volumes transitioning to the suspend status can be accessed or updated.) • UR Option copy pairs Consistency time mode • Related - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 312
of the attributes of the DKCState elements. Attribute name SerialNum WPR_All RSF_All RSF_CT JNL_Meta JNL_Data JNL_Trfr JNL_Cache_Capacity JNL_Data_Capacity Meaning Storage system serial number Write pending rate Reserve sidefile cache-usage rate Reserve sidefile cache-usage rate for C/T Metadata - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 313
. Attribute name ID PrimaryDADID SecondaryDADID SimplexCt DuplexCt PendingCt RevresyncCt SuspendOpCt SuspendVSCt SuspendCuCt SuspendErCt SwappingCt TransitionCt InvalidCt Meaning Copy group ID Primary DADID Secondary DADID SIMPLEX count DUPLEX count PENDING count REVRSY count SUSPOP count SUSPVS - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 314
ConslostCt CurrentTime MatchingPercent InitPace ProtectMode LinkageOption Meaning Count of copy pairs with reverse direction from Secondary to Primary HOLD NODELTA count CONSLOST count Current time in local time Copy pair matching rate Copy pace Protect mode Linkage option • CG Container - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 315
PENDING count DUPLEX count TRANS count SUSPCU count SUSPOP count SUSPVS count SUSPER count INVALID count SWAPPING count REVRSY count Count of copy pairs with reverse direction from Secondary to Primary HOLD count HOLDER count CHKJNL count HOLDTRNS count NODELTA count CONSLOST count Whether to - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 316
system serial number during a forward operation Storage system serial number during a reverse operation Arbitration command device during a forward operation Arbitration command device during a reverse operation • Host-Addressed Disk Device - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 317
Path set ID The following table gives the meanings of the attributes of the CUPath elements. Attribute name Shared PriModel Meaning Existence of sharing Primary storage system model XML Document Type Definitions 317 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 318
interface version Secondary storage system interface version Primary storage system serial number Secondary storage system serial number Primary path ID Secondary path ID Primary CU number Secondary CU number The CCA of the device to which I/Os are issued when path operations are performed on the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 319
of the CDEVGRP elements. Attribute name DADID APID CYL HD SLOTSIZE Meaning DAD ID to which a command device belongs APID First cylinder (fixed value of 0001) the command device in the storage system Volume serial number of the command device in the storage system DAD ID to which a command device - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 320
• Host-Discovered Array Microcode IFType PhysicalSerialNum Meaning Descriptions added by the user Device Address Domain ID Non Gen'ed function flag 0. Serial number of the scanned storage system Storage system model Microcode number Interface version Physical storage system serial number • DKC - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 321
examples for each of the following configuration file types: • Copy group definition file • Disk configuration definition file • Route list definition file • Command device definition file • Path set definition file. Example Contents of Copy Group Definition File The example of the contents of the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 322
Disk Configuration Definition File The example of the contents of the disk " CCA="12" External="N"/> < command device definition file, prefix.CDEV.dad-id, is shown: - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 323
YKLOAD command that Business Continuity Manager processes with the REXX variable structure. This section describes the REXX variable structures used in Business Continuity Manager. To code REXX script, consult the descriptions of the REXX variables in this section as necessary. NOTE: In this manual - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 324
NOTE: You can use the YKDROP command to drop the REXX variables in any copy group structure that was loaded by using the YKLOAD command. Table 146 (page 324) shows the copy group structure when a configuration file is loaded. The prefix for the name of the copy group structure is stem-name- - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 325
Enable Description Proxy C/T delta value for the entire copy group Copy pair matching rate (average value of CopyGroup.n.MatchingPerCent) Minimum primary interface version value (minimum value of IFType in the Host-Discovered Array structure of the storage system at the primary site) Primary CA key - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 326
Table 146 Copy Group Structure (continued) REXX variables ExctgID14 Super_Model14 Pair 0 CopyGroup 0 n3 Super_SerialNum14 ID PrimaryDADID SecondaryDADID SimplexCt DuplexCt InvalidCt PendingCt SuspendOpCt SuspendCuCt SuspendVSCt SuspendErCt TransitionCt ReversedCt SwappingCt1 RevrsyncCt HoldCt - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 327
146 Copy Group Structure (continued) REXX Open/MF Consistency Preservation Function is used. Unit for suspending • GROUP • VOLUME Flow Control Unit of difference management • TRK • CYL C/T group timer type for Forward C/T group timer type for Reverse Mirror ID of CAJ Unit for suspending CAJ copy - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 328
Table 146 Copy Group Structure (continued) REXX variables accessed or updated after the copy operation is completed. • QUICK: Volumes can be accessed or updated even while the copy operation is in progress. Model • XP10000 or XP12000 • XP20000 or XP24000 • P9500 Serial number Arbitration command - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 329
Table 146 Copy Group Structure (continued) REXX variables or XP24000 • P9500 Serial number Arbitration command device Arbitration count time (yyyymmdd hh status Error code Number of Stats (number of n) Primary storage system serial number Primary write pending rate Primary reserve sidefile cache - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 330
Table 146 Copy Group Structure (continued) REXX variables Description Pri_JNL_Data Sec_JNL_Meta19 Sec_JNL_Data19 Data % used rate JNL groups in Primary storage system Sec_JNL_Trfr19 Operating information between JNL groups in Secondary storage system Pri_JNL_Cache_Capacity10 Cache capacity - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 331
Copy Group Structure (continued) REXX variables Sec Model Description Primary storage system Model • XP256 • XP48 or XP512 • XP128 or XP1024 • XP10000 or XP12000 • XP20000 or XP24000 • P9500 Devn Secondary device number SerialNum Secondary storage value is invalid when the copy type is CAJ. 10 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 332
created by using one of the following methods: • Executing the YKLOAD command to load copy groups, so that the disk configuration definition file will be converted to the Host-Discovered Array Index structure. • Executing the YKSCAN command, so that the scanned information will be converted to the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 333
so that the YKLOAD command and the YKSTORE command can access the structure. Host-discovered Array Structure The Host-Discovered Array structure is created by using one of the following methods: • Executing the YKLOAD command to load copy groups, so that the disk configuration definition file will - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 334
Each REXX variable is preceded by a period (.). Table 148 Host-Discovered Array Structure REXX variables SNnnnnn UpdateID Description SerialNum Model Description Last update ID Descriptions added by the user Storage system serial number Storage system Model • XP256 • XP48 or XP512 • XP128 or - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 335
HP StorageWorks XP12000/XP10000 Disk Array • HP StorageWorks XP24000/XP20000 Disk Array • HP StorageWorks P9500 Disk Array A value of 0 is also set when the YKLOAD command is executed. External volume information can be obtained when Business Continuity Manager 4.1 or later scans an HP StorageWorks - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 336
storage system used in Route. Message Structure Table 150 (page 336) shows the message structure. The prefix for the name of the message structure is stem-name-specified-in-MSG-parameter. Each REXX variable is preceded by a period (.). The CLI commands and scripts of Business Continuity Manager - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 337
Table 151 Device Information Structure (continued) REXX variables HostStatus2 DKC Model Microcode IFType PPInfo VOL Info1 Attr8 Cdev Pair Info1 Status2 APID2 Info1 CA 0 Description Status of host connection • ONLINE • OFFLINE Storage system Model • XP256 • XP48 or XP512 • XP128 or - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 338
continued) REXX variables n State CONSLOST Path FenceLevel3 ErrorLevel4 Pri SSID Serialnum CUNum CCA Sec SSID Serialnum CUNum CCA MatchingPerCent Description Status of CA copy P-VOL Storage system serial number of P-VOL CU number of P-VOL CCA of P-VOL SSID of S-VOL Storage system - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 339
151 Device Information Structure (continued) REXX variables Mode MAP ProtectMode11 FlowControl4 FreezeSCPMode2, 3, 11 InitPace2 CT ID4, 5 TimerType4 Status4 Time4, 6 OpenMF5 AT Info1 GenID4 Time4, 6 Tout4 Description Copy mode • Sync • Async Unit of difference management • CYL • TRK - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 340
continued performed because a timeout occurred. Number of copy pairs in the C/T group Number of suspended copy pairs Number of suspending copy pairs Number of failure suspended copy mode • PROTECT • PERMIT Copy pace • SLOW • NORMAL Copy pair matching rate SSID of P-VOL Storage system serial number of - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 341
Structure (continued) performed because a timeout occurred. Number of copy pairs in the C/T group Number of suspended copy pairs Number of suspending copy pairs Number of failure suspended copy pairs Time remaining until timeout (minutes) Number of copy pairs made by full copy Number of Duplex copy - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 342
pairs were in DUPLEX status. • UNEXPECTED: When a suspend was performed, some CAJ copy pairs were not in DUPLEX status. Error code (hexadecimal number: 0000-FFFF) ATTIME suspend information (yyyymmdd hh:mm:ss.nnnnnn) Timeout value since the command is issued (minutes) Timeout value since the ATTIME - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 343
continued) REXX variables n State Path MatchingPerCent ProtectMode ExctgRegistFlag ExctgRegistFlag27 ErrorLevel9 ExctgID Pri SSID Description Existence of CAJ copy 1 is set only when the journal group that has the applicable volume has been registered in EXCTG. EXCTG registration flag for pair - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 344
Information Structure (continued) REXX variables Serialnum CUNum CCA Sec SSID Serialnum CUNum CCA CT ID subID TimerType Path CUxx Info1 0 n type Status TIME JNL_TIME SVOL_TIME Sec Model Serialnum SSID1 SSID2 SSID3 SSID4 P2S 0 Description Storage system serial number - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 345
Table 151 Device Information Structure (continued) REXX variables n Status DKC Info1 Sec Model Sec.SerialNum (0 to 64) Path ID Number of path IDs established from the storage system to which this device belongs to the storage system of Sec.SerialNum (0 to 8) Status of physical path • NO PATH - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 346
is OPEN-V, NORMAL is displayed. 9 When the copy type is CAJ, and the following models supports the relevant attribute settings, information is displayed. • HP StorageWorks XP12000/XP10000 Disk Array • HP StorageWorks XP24000/XP20000 Disk Array • HP StorageWorks P9500 Disk Array When information - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 347
used. The device number of the device to which I/Os are issued when path operations are performed on the primary site where the path is used. Serial number of secondary storage system Type of secondary storage system • XP48 or XP512 • XP128 or XP1024 • XP10000 or XP12000 • XP20000 or XP24000 • P9500 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 348
storage system (0 to 8) 1 These variables are valid when the n.type value is DKC. 2 These variables are valid when the n.type value is CU. 3 When the YKLOAD command 1: Yes (copying) State1 Existence of a FlashCopy in COPY mode relationship: • 0: No • 1: Yes (Copying in COPY mode) State2 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 349
Table 153 FlashCopy Information Structure (continued) REXX variables State3 State4 State5 State6 Description Hardware YKQUERY and YKEWAIT Commands Table 154 (page 349) shows the copy group structure's REXX variables that are updated by the YKQUERY command and the YKEWAIT command. REXX variables - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 350
Table 154 REXX Variables Updated by YKQUERY and YKEWAIT (continued) REXX variables CopyGroup 0 n YKQUERY DEVN specified -- SimplexCt N DuplexCt N InvalidCt N PendingCt N SuspendOpCt N SuspendCuCt N SuspendVSCt N SuspendErCt N TransitionCt N ReversedCt N SwappingCt N - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 351
REXX Variables Updated by YKQUERY and YKEWAIT (continued) REXX variables other- pairs YKQUERY DEVN applicable. REXX Variables Updated by YKQUERY Command with the TO Parameter Specified Table 155 (page 351) shows the copy group structure's REXX variables that are updated by the YKQUERY command - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 352
Table 155 REXX Variables Updated by YKQUERY Command with the TO Parameter Specified (continued) REXX variables Copy direction: Forward Copy direction: Reverse1 PRIMARY SECONDARY PRIMARY SECONDARY specified specified specified specified ConslostCt CTDelta MatchingPerCent Y Y Y Y F3 Y4 Y4 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 353
Updated by YKQUERY Command with the TO Parameter Specified (continued) REXX variables Copy direction: Forward Copy direction: Reverse1 updated --: Not applicable REXX Variables Updated by the YKEWAIT Command with the TO Parameter Specified Table 156 (page 353) shows the copy group structure's - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 354
Variables Updated by the YKEWAIT Command with the TO Parameter Specified (continued) REXX variables SuspendCuCt SuspendVSCt HoldCt HoldErCt HoldTrnsCt NoDeltaCt ConslostCt CurrentTime Pair 0 Copy direction: Forward Copy direction: Reverse PRIMARY SECONDARY PRIMARY SECONDARY specified - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 355
applicable CSV Files Used by the Copy Group Definition File Generation Function CSF File Dataset Formats and Disk command does not support a dataset whose DSORG is PO. Table 158 (page 355) shows the disk requirements for CSV files. When you determine the disk capacity, take into account - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 356
command • Delimit item values with the comma. If there is no value for an item, you must specify a comma to represent the empty item. • Item values can be enclosed in double-quotation marks. In this case, only values enclosed in the double-quotation marks are written into the copy Storage system - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 357
details about data types, see the table of syntax elements in " Copy Types and Targets for Which Commands Can Be Executed" (page 187). 2 Use either of the following methods to specify P-VOL and S-VOL volumes: • Device number • Storage system serial number, CU number, and CCA number If both methods - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 358
about data types, see the table of syntax elements in " Copy Types and Targets for Which Commands Can Be Executed" (page 187). 2 This item is mandatory. 3 This item is mandatory for operation in the forward direction. 4 Indicates that the storage system specified in SSN is to be specified as the - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 359
is used in the file. Examples of CSV Files CSV Files Used by the YKIMPORT Command This example presents the pair information CSV file and EXCTG information CSV file that are required for defining the copy group configuration shown in Figure 151 (page 359). Insert spaces appropriately. The first line - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 360
about the problem as possible. Include the circumstances surrounding the error or failure and the exact content of any error codes and/or messages displayed on the Remote Web Console. For worldwide technical support information, see the HP support website: http://www.hp.com/support 360 Data - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 361
Specifies the option information required for starting BCM Monitor. Specifies the copy groups to be monitored by BCM Monitor and operation details (actions). a parameter specification span across multiple lines, specify the continuation symbol at the end of each line (except the last line). "Types - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 362
symbol is used, the next line is treated as part of the same line. Maximum number of characters per line Even with the use of continuation symbols, the maximum number of characters per line is 32,760. Specifying comments Specify a comment symbol (* or #) at the beginning of a line or anywhere in - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 363
time in seconds for monitoring the copy group status. The following figure shows the concept of the copy group status monitoring cycle. If the YKEWAIT command, which is issued when the CGSTARTUPSTATUS parameter is specified in the YKMONCG file. MSGLEVEL=SYSTSPRT-message-level,console-message-level - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 364
might be output only to SYSTSPRT or the console. • YK81nnZ: These are messages with the 4095)) Stops BCM Monitor with the specified return code. HP recommends that you specify a value other than 0, a problem occurs. Example 1 Example This example has the following operating environment: ◦ Copy group - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 365
Structure of the YKMONCG File "Structure of Parameters in the YKMONCG File" (page 365) shows the structure of parameters in the YKMONCG file. Figure 153 Structure of Parameters in the YKMONCG File YKMONCG File 365 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 366
DUPLEX SUSPOP HOLD EXIT STOP ADJUST Parameters CGID=copy-group-ID Specifies the copy group name. CGPREFIX=prefix Specifies the prefix of the copy group definition file for the copy group. CGDAD=DADID Specifies the host device address domain ID of the copy group. If this parameter is omitted, no - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 367
, CGSTARTUPSTATUS parameter processing is executed after the following processing is performed: • When there is a copy pair in the TRANS status: The YKEWAIT GOTO(SUSPEND) TIMEOUT(WAITTIMEOUT) command is executed. • When there is a copy pair in the HOLDTRNS status: The YKEWAIT GOTO(HOLD) TIMEOUT - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 368
processing column is performed for the copy group. Table 164 Processing for the Specified Startup Status Specified startup status SIMPLEX Copy pair status All the monitoring status of all copy groups specified in the CGID parameter to INACTIVE. Executes the following commands: • YKDELETE • YKEWAIT - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 369
Processing for the Specified Startup Status (continued) Specified startup status DUPLEX SUSPOP Copy pair status All DUPLEX PENDING SIMPLEX Places the monitoring status of all copy groups specified in the CGID parameter to INACTIVE. Executes the following commands: • YKRESYNC • YKEWAIT GOTO(DUPLEX - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 370
TRANS HOLDTRNS INVALID SUSPVS REVRSY NODELTA CONSLOST HOLDER Processing Places the monitoring status of all copy groups specified in the CGID parameter to INACTIVE. Executes the following commands: • YKRESYNC PREPARE • KEWAIT GOTO(HOLD) Action Parameters An action parameter specifies an action for - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 371
Table 165 Combinations of Target Statuses and Actions That Can Be Specified (continued) Target status Action CONSLOST Y Y Y Y N N Y NY Y Y SUSPER Y Y Y Y Y Y Y NY Y be specified. Parameters target-status Specifies the status of the copy group on which the action is to be executed. - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 372
continued) Specifiable value WAITFOR(copy-group-ID, {DUPLEX|SUSPEND|SIMPLEX|SUSPVS|HOLD}[,timeout-value]) Overview Executes the YKEWAIT command. RESYNC(copy-group-ID,command-wait-time[,command-parameter]) Executes the YKRESYNC command. SUSPEND(copy-group-ID[,command return code. HP recommends hat - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 373
GOTO Parameter" (page 211). {DUPLEX|SUSPEND|SIMPLEX|SUSPVS|HOLD} Specifies the status of the copy group that is specified in the GOTO parameter of the YKEWAIT command. After all copy pairs in the copy group have changed to the specified status, the processing terminates normally. For details on this - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 374
command with the specified command parameter on the specified copy group. command-parameter ~ Specifies the YKMAKE command ((0 to 4095)) Stops BCM Monitor with the specified return code. HP recommends that you specify a value other than 0, 4, 8, or - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 375
of the high priority levels shown in the table below, that copy pair status is used for the copy group. For example, if there are no copy pairs in the INVALID status, but there is a copy pair in the SUSPER status, then the corresponding copy group is treated as being in the SUSPER status. If - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 376
, the SELECT(COND) parameter is the default value. However, in the case of the YKSUSPND command, SELECT(ALL) is the default value. • If the attempted action fails, summary information about the copy group will be output regardless of the specified message level. • If you specify parameters for - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 377
for Business Continuity Manager Software Installation Guide A manual related to HP StorageWorks P9000 Command View Advanced Edition SuiteSoftware products: • HP StorageWorks P9000 Replication Manager Software User Guide Manuals related to OS/390 and z/OS: • HP StorageWorks P9000 Continuous Access - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 378
External Storage for Open and Mainframe Systems User Guide • HP StorageWorks P9000 External Storage Access Manager User Guide Manuals related to OS/390: • MVS Programming: Assembler Services Guide, GC28-1762 • MVS Setting Up a Sysplex, GC28-1779 • MVS System Codes, GC28-1780 • MVS System Commands - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 379
's Guide & Commands, SC31-8780 • Communications Server IP API Guide, SC31-8788 • ISPF User's Guide Volume I, SC34-4822 • DFSMS Advanced Copy Services, SC35-0428 You can find these documents on the HP Manuals website: http://www.hp.com/support/manuals In the Storage section, click Storage Software - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 380
168 Document conventions (continued) Convention Bold text Code • Commands, their arguments, and argument values Monospace, italic text • Code variables • Command variables specific instructions. NOTE: Provides additional information. TIP: Provides helpful hints and shortcuts. 380 Support - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 381
copy pairs If you press the Enter key in the Scan Copy Pair Inside Storage System panel, volumes of PPRC copy pairs will be scanned, and the copy pair configuration information will be stored in the copy (C) 2003, 2009, Hitachi, Ltd. XX* XX Then place this into a user PROCLIB which XX* can be - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 382
(1) The scan results of PPRC copy pairs are displayed. For details on the displayed messages, see HP StorageWorks P9000 for Business Continuity Manager Software Installation Guide. If a value of RC other than 0 displayed in the YKB001I message, see the messages that were output before the YKB001I - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 383
Convention This font style marks a placeholder that indicates where appropriate characters are to be entered in an actual command. Bold code-font characters indicate the abbreviation for a command. Only one of the options separated by a vertical bar can be specified at the same time. Square brackets - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 384
continued part can contain from 1 to 8 characters. User ID string A string consisting of alphanumeric characters or character ($, #, or @). @a123 Console name string A string consisting of or special character ($, #, or @). @a123 Command parameter string A string consisting of one or - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 385
Business Continuity Manager application program application programming interface Business Copy for Mainframe A generic name for the following products: • HP StorageWorks P9000 for Business Continuity Manager Basic • HP StorageWorks P9000 for Business Continuity Manager Extended CT Group Software - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 386
(continued) P-VOL primary volume PSW program status word R-JNL restore journal RACF resource access control facility RAID redundant array of independent disks RCU remote control unit RECFM record format Replication Manager HP Replication Manager Software REXX restructured extended - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 387
between remote DKCs in a 4x4 configuration Audit log information enables you to get operating usage and communication records. Audit logs are output to SYSLOG when actions or errors that are related to the linkage between XP Replication Manager Software and the Business Continuity Manager agent - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 388
mode entry environment setting command EXCTG A startup mode option for Business Continuity Manager agents. If you start a Business Continuity Manager agent in the edit mode, you can define, operate, or monitor copy groups from XP Replication Manager Software. A DKC or command device that the route - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 389
in which EXCTG information in a 4x4 configuration copy group container is described A sequential dataset for the log data output from the system logger service See the HP StorageWorks XP24000/XP20000 External Storage Software User's Guide. F failback failover FlashCopy See failover . The process - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 390
A disk control unit that controls the P-VOL of a TC/TCA/UR copy pair A product used for displaying information about mainframe storage systems in Device Manager or XP Replication Manager Software The copy source journal for UR Main control unit. A startup mode option for Business Continuity Manager - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 391
remote copy. A PPRC TC copy pair for which HyperSwaps can be performed. TPC-R can be used to create these copy pairs. You can define a TC copy pair as a TC copy pair with the HyperSwap attribute by using the YKH2B command in Business Continuity Manager, making it possible to use Business Continuity - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 392
used to set the initialization parameter for the Business Continuity Manager agent. By specifying this parameter in the MODIFY command, you can dynamically change the log output level. Hitachi ShadowImage. Also known as HP StorageWorks XP Business Copy. An area of cache used to store the data - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 393
volume A volume on the DKC that is used on z/Linux. z/Linux volume copy groups can be operated from Business Continuity Manager running on z/OS. For details about prerequisites for using z/Linux volumes, see the HP StorageWorks P9000 for Business Continuity Manager Software Installation Guide. 393 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 394
), 166 CAJ Copy Group Suspension Options panel, 162 CANCEL parameter YKSUSPND command, 254 Cancellation Warning Panel, 18 CCA parameter YKDELCMD command, 198 YKQRYDEV command, 230 CCA Selection List for Remote Storage Arrays panel, 37 CLI Command coding example, 263 CLI commands, 186 CN parameter - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 395
Group Selection List panel, 69 Copy Group Status Summary panel, 120 copy group structure, 323 copy pace, 83 CU parameter YKDELCMD command, 198 YKQRYDEV command, 230 CU Selection List for Remote Storage Array panel, 35 D DAD parameter YKLOAD command, 224 YKWATCH command, 260 data objects, 306 dataset - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 396
, 197 help obtaining, 377 HOLD parameter YKMAKE command, 227 Host-Discovered Array Index structure, 332 Host-Discovered Array structure, 333 HP technical support, 377 I Import SMS Storage Group Panel, 90 Inner Route Information panel, 48 Insert Remote Route Entry panel, 59 Insert Route Entry panel - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 397
objects, 306 Scan Copy Pair Inside Storage System panel, 94 Scan Device Address Extent panel, 34 Scan Remote Device Address Extent panel, 42 SCANPAIR command format, 13 SCU parameter YKBLDPTH command, 194 YKDELPTH command, 203 YKQRYPTH command, 233 SEC parameter YKSLEEP command, 247 Security Setting - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 398
List panel, 50 Storage System/DAD Selection List panel, 56 Storage System/DADID Selection List panel, 39 storage systems supported models, 8 Subscriber's Choice, HP, 377 SVOL parameter YKSUSPND command, 257 symbols in text, 380 398 Index T technical support, 360 HP, 377 service locator website, 379 - HP P9000 | HP StorageWorks P9000 for Business Continuity Manager Software Refere - Page 399
overview of sample script, 264 YKDEMO1S overview of sample script, 264 sample script, 299 YKEWAIT command, 209 TO parameter, 212 YKEXPORT command, 213 YKFCSTAT command, 214 YKFREEZE command, 215 YKH2B command, 217 CGNAME parameter, 218 DAD parameter, 217 DEVN parameter, 217 HS parameter, 218 PREFIX
HP StorageWorks
P9000 for Business Continuity Manager
Software Reference Guide
Abstract
This manual is a reference guide to the following program products, known collectively as Business Continuity Manager: HP
StorageWorks P9000 for Business Continuity Manager Basic and HP StorageWorks P9000 for Business Continuity Manager
Continuous Access Journal 4x4 Extended CTG.
HP Part Number: T5253-96053
Published: May 2011
Edition: Tenth