HP StorageWorks P9000 Reference Manual

Business continuity manager software reference guide
Hide thumbs Also See for StorageWorks P9000:
Table of Contents

Advertisement

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 201 1
Edition: Tenth

Advertisement

Table of Contents
loading

Summary of Contents for HP StorageWorks P9000

  • Page 1 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.
  • Page 2 © Copyright 2007, 201 1 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.21 1 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.
  • Page 3: Table Of Contents

    Contents 1 ISPF Panels....................8 Overview of ISPF Panels......................8 ISPF Panel System........................9 Operating Procedures......................10 Function Keys........................10 Panel Scrolling......................11 Command Line Commands....................11 LOCATE Command.......................11 SELECT Command......................11 SORT Command......................13 SCANPAIR Command....................13 ERRCODE Command.....................13 Commands that Can Be Used on the Command Line............13 ISPF Settings........................14 Setting the Position of the Command Line.................14 Setting the Number of PF Keys that are Displayed..............15 Common Displays Among Panels....................15...
  • Page 4 Sort the Define Command Device Panel................52 Edit APID Panel......................53 Entire Route Information Panel..................53 Add Route Entry Panel....................55 Storage System/DAD Selection List Panel................56 Insert Route Entry Panel....................57 Edit Route Entry Panel....................57 Edit Remote Route Entry Panel..................58 Insert Remote Route Entry Panel..................59 Path Set Selection List Panel....................60 Add Path Set Panel......................61 Path Set Detail Panel......................61...
  • Page 5 Sort CAJ Copy Group Statistics Panel................130 Copy Group Pair Status Panel..................131 Sort the Copy Group Pairs Status Panel................134 Volume Query Information (BC) Panel................135 Volume Query Information (CA) Panel................140 Volume Query Information (CAA) Panel................145 Volume Query Information (CAJ) Panel................151 Volume Query Information Panel (Executing YKQRYDEV)..........158 Executing YKMAKE......................159 Executing YKSUSPND.......................160 Executing YKRESYNC.......................165...
  • Page 6 YKFREEZE Command.......................215 YKH2B Command......................217 YKIMPORT Command......................219 YKINSCHK Command......................220 YKLOAD Command......................223 YKMAKE Command......................226 YKQHPATH Command.....................229 YKQRYDEV Command......................229 YKQRYPTH Command......................232 YKQUERY Command......................235 YKRECVER Command......................237 YKRESYNC Command......................239 YKRUN Command......................244 YKSCAN Command......................245 YKSLEEP Command......................247 YKSTATS Command......................248 YKSTORE Command......................249 YKSUSPND Command.....................251 YKWATCH Command......................259 YKWTOMSG Command....................262 CLI Command Coding Examples..................263 YKDEMO01.......................264 YKDEMO02.......................269...
  • Page 7 REXX Variables Updated by YKQUERY and YKEWAIT Commands..........349 REXX Variables Updated by YKQUERY Command with the TO Parameter Specified....351 REXX Variables Updated by the YKEWAIT Command with the TO Parameter Specified....353 CSV Files Used by the Copy Group Definition File Generation Function........355 CSF File Dataset Formats and Disk Requirements..............355 Specification Format for CSV Files..................355 Coding Rules......................355...
  • Page 8: Ispf Panels

    P9500 and XP disk arrays. The XP disk array copy products can be configured and controlled using the P9000 version of BCM. With the exception of TrueCopy Asynchronous, the HP product names are used in this manual. For compatibility with existing implementations on XP disk arrays, the Hitachi abbreviations shown in parenthesis are accepted by the user interface.
  • Page 9: Ispf Panel System

    overview of ISPF panels. Note that the following explanations assume the default values for the PF key numbers. ISPF Panel System Figure 1 (page 9) Figure 2 (page 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.
  • Page 10: Operating Procedures

    Figure 2 ISPF Panel System (2 of 2) Operating Procedures There is no restriction on the case and type of characters entered. The maximum length of the entered characters is determined by the length of the input fields. A validation check takes place after input. After entering the data, confirm the entry by pressing Enter.
  • Page 11: Panel Scrolling

    F8=Forward: Scrolls down the display F12=Cancel: Cancels the process F17=DispConf: Displays the settings information Panel Scrolling If there are more rows than can be displayed at once within the panel, F7=Backward and F8=Forward can be used to scroll the screen. The last row of table data is marked Bottom of data. In panels that display lists, you can use the Scroll line to specify the amount that will be scrolled.
  • Page 12 Table 1 SELECT Parameters Parameter Explanation field-name Specifies the name of a field in which a condition is specified. For details about the field names that can be specified, see the explanation for the applicable panel. If field-name is omitted, the default field established for the applicable panel is assumed.
  • Page 13: Sort Command

    NOTE: If you specify three parameters, the command interpreter assumes that the field name is specified. If you specify two parameters, the command interpreter assumes that the field name is omitted. SORT Command Function List items, displayed in a panel, are sorted by the SORT command based on the specified field names.
  • Page 14: Ispf Settings

    Table 2 Commands that Can Be Used on the Command Line Panel Name Command Name LOCATE SELECT SORT SCANPAIR ERRCODE Browse Copy Group Pair Detail — — Copy Group Detail Definition — — — Copy Group Pair Detail — — Copy Group Pair Status —...
  • Page 15: Setting The Number Of Pf Keys That Are Displayed

    Setting the Number of PF Keys that are Displayed You can set the number of PF 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: Start Business Continuity Manager.
  • Page 16: Exception Message Panel

    Figure 4 Setting Information Panel Table 3 (page 16) describes the items in the Setting Information panel. Table 3 Contents of the Setting Information Panel Item Description Configuration File Prefix Prefix of the configuration file Local Device Address Domain ID DAD ID of local site ISPF Log Max The maximum number of messages (message structures) that are...
  • Page 17 Figure 5 Exception Message Panel Table 4 (page 17) describes the items in the Exception Message Panel. Table 4 Contents of the Exception Message Panel Item Description Message Message ID and message text output to the Text in the message structure Severity output to the Severity in the message structure Related Information Additional information output to the Value in the message structure...
  • Page 18: Cancellation Warning Panel

    For details about what actions to take when an error occurs during creation or update of the configuration file, see the HP StorageWorks P9000 for Business Continuity Manager Software User Guide.
  • Page 19: Update Warning 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 code in the list of error codes is currently displayed, the last error code in the list will be displayed.
  • Page 20: Notes Common To All Panels

    will be displayed. The panel will ask you whether 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 Warning panel. Figure 8 Update Warning Panel Pressing the Enter key will overwrite the configuration file.
  • 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: Select 6 Command from the ISPF menu. Enter YKSTART. In some cases, the following panels might be displayed instead of the Main Menu panel: Main Menu Panel...
  • Page 22 Installation Verification Summary panel If any of the following conditions are met, the system assumes that the installation of Business Continuity Manager did not complete and the Installation Verification Summary panel is displayed: No profile for referencing or operations has been specified for the RACF security setting. No user SVC has been registered.
  • Page 23: Installation Verification Summary Panel (Environment Settings Verification)

    Table 6 Contents of the Main Menu Item Description 0 Installation Verification Verifies the environment settings. 1 Set Defaults Sets the default of a site 2 Manage Licenses Manages license information 3 Discover/Define Configuration Scans volumes and defines the configuration file 4 Manage Route Manages routes 5 Manage Path Set...
  • Page 24: Security Setting Information Panel

    Table 7 Items in the Installation Verification Summary Panel Item Description 1 Security Setting Status of the RACF security setting OK: A profile for referencing or operations has been specified. FAULTY: No profile for referencing or operations has been specified. 2 User SVC Routine Status of the user SVC setting OK: The user SVC version is one that can be used with the version of the Business...
  • Page 25: User Svc Information Panel

    User SVC Information Panel When you select 2 User SVC 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 key, the rest of the User SVC Information panel is displayed as follows: Installation Verification Summary Panel (Environment Settings Verification)
  • Page 26 Table 9 (page 26) lists and describes the items in the User SVC Information panel. Table 9 Items in the User SVC Information Panel Item Description Version of User SVC for this program The version of the user SVC, which can be used with the Business Continuity Manager instance that is running.
  • Page 27: Set Defaults Panel (Prefix And Dad Id Settings)

    Set Defaults Panel (Prefix and DAD ID Settings) The Set Defaults panel is displayed when 1 Set Defaults is selected in the Main Menu panel. The following items can be defined in the Set Defaults panel: The configuration file prefix and DAD ID The maximum number of messages that can be output to the ISPF log 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 JCL for...
  • Page 28 Table 10 Contents of the Set Defaults Panel (continued) Item Description Remote DKC Function Use the following values to set the Remote DKC Control Function: For these values, see . Y—Default to the Remote DKC Control Function. N—Do not default to the Remote DKC Control Function. 3, 3 Preset RouteListID Specify ROUTE parameter value (the route list ID) for the YKLOAD command.
  • Page 29: Manage Licenses Panel (License Management)

    Figure 15 Set Defaults Panel NOTE: When entering a DAD ID, remember the following: Specify the same DAD ID for volumes that can be directly accessed. Business Continuity Manager assumes that volumes with the same DAD ID as the one specified for the Set Defaults panel can be directly accessed.
  • Page 30: Message Panel

    Figure 16 Manage Licenses Panel Table 1 1 (page 30) describes the items in the Manage Licenses panel. Table 1 1 Contents of the Manage Licenses Panel Item Description License Key Dataset Name The dataset name of the license key file that has been transferred to MVS. Key Code Key code of the license PP Name...
  • Page 31: Discover/Define Configuration Panel (Configuration File Definition)

    4 Copy Group Definitions 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 Configuration panel.
  • Page 32: Discover Hp Storage System Panel

    Before creating copy groups, you must scan the volumes to be used and then create the disk configuration definition files. If the disk configuration definition files exist, the scanning is not required. Discover HP Storage System Panel The Discover HP Storage system panel is displayed when 1 Discover HP Storage System is selected in the Discover/Define Configuration panel.
  • Page 33 Figure 20 Discover HP Storage System Panel Table 13 (page 33) describes the items in the Discover HP Storage System panel. Table 13 Contents of the Discover HP Storage System Panel Item Description Specify an action: s: used to display a list of CUs detected by performing a volume scan. d: Deletes the results of a volume scan.
  • Page 34: Scan Device Address Extent Panel

    NOTE: When you enter an action in AC, complete the action by pressing the Enter key, 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.
  • Page 35: Cu Selection List For Remote Storage Array Panel

    Table 14 Contents of the Scan Device Address Extent Panel (continued) Item Description Storage System Serial number of the storage system to be scanned. Device Address Specify the Start and End of the device address (CU and CCA) range to be scanned. Specify the hexadecimal number in ascending order.
  • Page 36 Figure 22 CU Selection List for Remote Storage System Panel Table 16 (page 36) describes the items in the CU Selection List for Remote Storage System panel. Table 16 Contents of the CU Selection List for Remote Storage System Panel Item Description Device Address Domain...
  • Page 37: Cca Selection List For Edit Devn Panel

    scan does not display the command devices. If you exit the CU Selection List for Remote Storage System panel by pressing F3=Exit, and enter e in AC in the Discover HP Storage System panel. NOTSET is displayed in Information for the CU number to which the command device belongs. Assign a dummy device number to the command device.
  • Page 38: Edit Device Number For Cu Panel

    Table 17 Contents of the CCA Selection List for Edit devn Panel (continued) Item Description Storage System S/N Serial number of the storage system to which a device belongs Model Model of the storage system to which a device belongs uCode Microcode information for the storage system to which a device belongs IFType...
  • Page 39: Storage System/Dadid Selection List Panel

    Figure 24 Edit Device Number for CU Panel Table 18 (page 39) describes the items in the Edit Device Number for CU panel. Table 18 Contents of the Edit Device Number for CU Panel Item Description Storage System S/N Serial number of the storage system to which the CU belongs Control unit number SSID SSID of the CU...
  • Page 40: Control Unit Selection List Panel

    In the initial state, the entries are displayed in ascending order of EBCDIC codes, with S/N followed by Device Address Domain in the priority order. Control Unit Selection List Panel If s is specified in the AC column in the Discover HP Storage System panel, the Control Unit Selection List panel displays a list of all detected CUs.
  • Page 41: Command Control Address (Cca) Selection List Panel

    Command Control Address (CCA) Selection List Panel If s is specified in AC in the Control Unit Selection List panel, the Command Control Address (CCA) Selection List panel with details about the selected CU is displayed. The Command Control Address (CCA) Selection List panel is shown in Figure 27 (page 41).
  • Page 42: Scan Remote Device Address Extent Panel

    Table 21 Contents of the Command Control Address (CCA) Selection List Panel (continued) Item Description Device Number The number of a device Volume Serial Number Volume serial number of a device Scan Remote Device Address Extent Panel In the Discover HP Storage System panel, when you specify r in AC in the remote storage system, the Scan Remote Device Address Extent panel for executing the remote scan is displayed.
  • Page 43 Figure 29 Panel Transitions from the Route Config Panel (1 of 2) #1: Displayed if the entered DAD ID is not the same as the first DAD ID of the route that has already been registered in the route list. #2: Displayed if the specified entry was created by the remote scan and no dummy device number has been assigned.
  • 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).
  • Page 45: Add Route List Id Panel

    Table 23 Contents of the Route Config Panel Item Description Specify an action. s— Displays the first DAD ID of the route included in the selected route list d— Deletes the route list ID e— Displays the Entire Route Information panel that displays a list of the entries that have been defined in the route list RouteList ID Route list ID...
  • Page 46: Add Route Panel

    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 Description Route List ID Route list ID selected in the Route Config panel Specify an action. s—...
  • Page 47: Add Apid Panel

    Figure 34 Add Route Panel Table 25 (page 47) describes the items in the Add Route panel. Table 25 Contents of the Add Route Panel Item Description Route List ID Route list ID selected in the Route Config panel Priority Priority (Priority is 1, fixed) of the first DAD ID of a route Specify an action.
  • Page 48: Inner Route Information Panel

    Inner Route Information Panel If s is specified in AC in the Route Information panel, the Inner Route Information panel is displayed. The Inner Route Information panel displays the detailed route information that begins with the specified first DAD ID of the route. Figure 36 (page 48) shows the Inner Route Information panel.
  • Page 49: Add Route Entry Panel

    Add Route Entry Panel In the Inner Route Information panel, move the cursor to the appropriate field and press F5=Add. The Add Route Entry panel for adding a DAD ID to lengthen the selected route is displayed. Figure 37 (page 49) shows the Add Route Entry panel.
  • Page 50: Storage System Selection List Panel

    Table 28 Contents of the Add Remote Route Entry Panel Item Description Remote Device Address Domain Specify the DAD ID of the storage system to be remotely scanned. Remote Storage System S/N Specify the serial number (alphanumeric characters) of the storage system to be remotely scanned.
  • Page 51: Define Command Device Panel

    Table 29 Contents of the Storage System Selection List Panel (continued) Item Description Specify an action. s— Displays the Define Command Device panel used to select a single command device in the storage system. Storage system serial number Devn Device number of the command device If the command device is to be defined, its device number is displayed.
  • Page 52: Sort The Define Command Device Panel

    Table 30 Contents of the Define Command Device Panel (continued) Item Description The number of the CU to which the command device belongs SSID SSID of the CU to which the command device belongs CCA of the command device Device Number Device number of the command device Volume Serial Number Volume serial number of the command device...
  • Page 53: Edit Apid Panel

    Table 33 Select the Sort Key for the Sort the Define Command Device Panel Item Sorted by Number of the CU to which the command device belongs CCA of the command device Device Number Device number of the command device Volume Serial Number Volume serial number of the command device Edit APID Panel...
  • Page 54 Figure 43 Entire Route Information Panel Table 35 (page 54) describes the items in the Entire Route Information panel. Table 35 Contents of the Entire Route Information Panel Item Description Route List ID Route list ID selected in the Route Config panel Specify an action.
  • Page 55: Add Route Entry Panel

    In the initial state, the priority order is APID (hexadecimal number), followed by Route Num (decimal number) and then Lst (decimal number), and the information is displayed in ascending hexadecimal order. If d is specified for AC for the first entry of the route in the Entire Route Information panel, then all corresponding entries in the route (those that have the same value for Route Num) The Confirm Route Delete panel (see “Confirm Route Delete Panel”...
  • Page 56: Storage System/Dad Selection List Panel

    Storage System/DAD Selection List Panel If s is specified for AC in the Add Route Entry panel, the Insert Route Entry panel, or the Edit Route Entry panel, then the Storage System/DAD Selection List panel is displayed. The Storage System/DAD Selection List panel displays storage system (DKC) serial numbers and DAD IDs that can be specified for the entry.
  • Page 57: Insert Route Entry Panel

    the device numbers within the selected storage system are displayed in the Define Command Device panel. In the initial state, the entries are displayed in ascending order of EBCDIC codes, with S/N followed by Device Address Domain as the default order. Insert Route Entry Panel If i is specified for AC in the Entire Route Information panel, then the Insert Route Entry panel is displayed to add an entry to the route.
  • Page 58: Edit Remote Route Entry Panel

    Figure 47 Edit Route Entry Panel Table 39 (page 58) describes the items in the Edit Route Entry panel. Table 39 Contents of the Edit Route Entry Panel Item Description Specify an action. s—Use when you do not want to manually enter a combination of the DAD ID and storage system serial numbers, or enter a command device, but you do want to select them from a list instead.
  • Page 59: Insert Remote Route Entry Panel

    Table 40 Contents of the Edit Remote Entry Panel Item Description Remote Device Address Domain DAD ID within the route Remote Storage System S/N Serial number of the storage system to which the command device belongs Device Address for SSID SSID to which the command device belongs (modifiable) Command Device CU number to which the command device belongs (modifiable)
  • Page 60: Path Set Selection List Panel

    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.
  • Page 61: Add Path Set Panel

    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 Specify an action. e— Displays the Path Set Detail panel used to load a path set definition file d—...
  • Page 62 Figure 53 Path Set Detail Panel Table 43 (page 62) describes the items in the Path Set Detail panel. Table 43 Contents of the Path Set Detail Panel Item Description Path Set ID Path set ID Specify an action. e— Displays the Edit Logical Path Definition panel used to display or edit a logical path. d—...
  • Page 63: Edit Logical Path Definition Panel

    When you press F12=Cancel in the Path Set Detail panel, the Confirm Cancellation of Editing panel (see “Confirm Cancellation of Editing Panel” (page 177)) is displayed to confirm that the operation is to be cancelled without modifying the path set definition file. In the Path Set Detail panel, you can use the SORT command.
  • Page 64 Table 44 Contents of the Edit Logical Path Definition Panel (continued) Item Description Primary Primary storage system serial number (modifiable) Model Primary storage system model (modifiable) IFType Primary interface version (modifiable) PathID Specify the primary path ID. Specify this item only for the inter-DKC logical path. If this item is omitted for the inter-DKC logical path, 00 is assumed.
  • Page 65: Select Storage System Panel

    NOTE: When Type is DKC, make sure that you enter the values for S/N, Model, and IFType. PathID can be omitted. If PathID is not specified, 00 (hexadecimal number) is the default. If the storage system is directly connected to the host, by entering values in CU and CCA, you can specify the device to which I/O is issued during operations on the paths.
  • Page 66: Select Ssid Panel

    Figure 55 Select Storage System Panel Table 47 (page 66) describes the items in the Select Storage System panel. Table 47 Contents of the Select Storage System Panel Item Description Specify an action. s— Displays the Select SSID panel used to load a disk configuration definition file.
  • Page 67: Edit Port Definition Panel

    Table 48 Contents of the Select SSID Panel Item Description Specify an action: s: Selects a CU and SSID. When actions are entered in multiple AC columns, the top line is specified. CU number SSID SSID In the initial state, the information is displayed in ascending order by EBCDIC codes in CU. Edit Port Definition Panel If e is specified in AC in the Edit Logical Path Definition panel, the Edit Port Definition panel is displayed to edit physical paths.
  • Page 68: Assign Port Panel

    Table 49 Contents of the Edit Port Definition Panel (continued) Item Description Secondary Secondary storage system serial number Model Model of the secondary storage system IFType Secondary interface version PathID Secondary path ID Secondary CU number SSID Secondary SSID Specify an action. d—...
  • Page 69: Copy Group Selection List Panel

    Figure 59 Sort Logical Paths in Path Set Panel Table 51 (page 69) describes the items in the Sort Logical Paths in the Path Set panel. Table 51 Contents of the Sort Logical Paths in the Path Set Panel Item Description Priority Specify a number representing the position of this path according to the order of its sort key...
  • Page 70 Figure 60 Panel Transitions for the Copy Group Selection List Panel (Add Copy Group) #1: If you press F5=Add, the Copy Group Detail Definition panel is displayed, and the Add Copy Group panel is displayed on top of that panel. #2: If you press F12=Cancel, the Add Copy Group panel and the Copy Group Detail Definition panel close.
  • Page 71 Figure 61 Panel Transition for the Copy Group Selection List Panel (Browse Copy Group Information) #: Pressing the F6=Sort key sorts items on the panel. Figure 62 (page 71) shows the panel transition when e is specified for AC in the Copy Group Selection List panel.
  • Page 72: Add Copy Group Panel

    Figure 63 Copy Group Selection List Panel Table 52 (page 72) describes the items in the Copy Group Selection List panel. Table 52 Contents of the Copy Group Selection List Panel Item Description Specify an action. : Displays a copy group. If the copy group is not a CG container, the Browse Copy Group Pair Detail panel is displayed.
  • Page 73: Copy Group Detail Definition Panel

    a new copy group ID in the Add Copy Group panel and press the F12=Cancel key, display returns to the Copy Group Selection List panel, and no new copy group is registered. Figure 64 (page 73) shows the Add Copy Group pop-up) panel. Figure 64 Add Copy Group Panel Table 53 (page 73) describes the items in the Add Copy Group panel.
  • Page 74 Figure 65 Copy Group Detail Definition Panel “Items in the Copy Group Detail Definition panel” (page 74) describes the items in the Copy Group Detail Definition panel. Note that changes for each item will be applied to the storage system settings when the copy pair is reloaded (by executing the YKLOAD command) and then created.
  • Page 75 Table 54 Items in the Copy Group Detail Definition panel (continued) Item Description When effective Specify an action. e: Edits a copy pair in the copy group. This setting displays the Copy Group Pair Detail panel (this setting can be specified only in the Copy Group Detail Definition panel).
  • Page 76: Copy Group Attributes Panel

    If you press the F5=Add key in the Copy Group Detail Definition panel, the Copy Group Pair Detail panel (in which the copy pair is not defined) is displayed, and then the Setting C/T ID Attributes panel appears . In this panel, you can define a consistency group ID. If you clear Use Container and press the Enter key when only one copy group is displayed in the Copy Group Detail Definition panel, the Copy Group Pair Detail panel appears.
  • Page 77 Table 55 Panel displayed for each combination (continued) Copy type CG Container? Displayed panel Copy Group Attributes For Container (CAJ) Copy Group Attributes (CAJ) Including when no C/T group ID is specified. “Copy Group Attributes For Container (BC) Panel (for BC Copy Groups that are CG Containers)” (page 77) “Copy Group Attributes (CAJ) Panel (for CAJ Copy Groups that are not CG Containers)”...
  • Page 78 Figure 69 Copy Group Attributes (CA) Panel (for CA Copy Groups that are not CG Containers) Figure 70 Copy 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) ISPF Panels...
  • Page 79 Figure 73 Copy Group Attributes (CAJ) Panel (for CAJ Copy Groups that are not CG Containers) Table 56 (page 79) describes the items in the Copy Group Attributes panel. Note that if you change any of these items, the change does not take effect until the next time you perform an operation on the copy pair after reloading it by using the YKLOAD command.
  • Page 80 Table 56 Contents of the Copy Group Attributes Panel (continued) Item Description Copy type When effective sub C/T ID (JNLG) Specify the journal group number When the YKMAKE of the secondary site as a sub C/T command is executed. group ID (required) Specify a value between OO and NOTE: For configurations that use...
  • Page 81 Table 56 Contents of the Copy Group Attributes Panel (continued) Item Description Copy type When effective ERROR LVL Specify the error level that When the YKMAKE determines whether all of the copy command is executed pairs in the same C/T group are When the YKRESYNC suspended (required for TCA and command with the...
  • Page 82 FLOW CTL will be disregarded even if set to Y: XP12000/XP10000 Disk Array XP24000/XP20000 Disk Array For details, see the one of the following documents: HP StorageWorks P9000 Continuous Access Synchronous for Mainframe Systems User Guide HP StorageWorks P9000 Continuous Access Synchronous...
  • Page 83 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.
  • Page 84 Table 56 Contents of the Copy Group Attributes Panel (continued) Item Description Copy type When effective PROT MODE Specify the write-protect mode for When the YKSUSPND the S-VOL (required). command is executed For BC, PERMIT is the default. For CA and TCA, PROTECT is the default.
  • Page 85 I/O. Specification of Y is valid only for a CA copy group for which a consistency group ID is specified. For details on the consistency group timer type, see one of the following: HP StorageWorks P9000 Continuous Access Synchronous for Mainframe Systems User Guide HP StorageWorks P9000 Continuous Access Synchronous User Guide...
  • Page 86: Setting C/T Id Attributes Panel

    Definition panel if the copy group is a CG container; and to the Copy Group Pair Detail panel if the copy group is not a CG container. If you have already defined a copy pair during this process, a confirmation dialog (Confirm Cancellation of Editing panel) is displayed for you to confirm cancellation of the changes.
  • Page 87: Copy Group Pair Detail Panel

    Copy Group Pair Detail Panel The Copy Group Pair Detail panel, which displays details about the copy pairs in a copy group, is displayed in these cases: If Use Container in the Add Copy Group panel is cleared, and the Enter key is pressed If the copy group for which e is specified for AC in the Copy Group Selection List panel is not a CG container If e is specified for AC in the Copy Group Detail Definition panel...
  • Page 88 Table 59 Contents of the Copy Group Pair Detail Panel (continued) Item Description Copy Group Type 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.
  • Page 89: Pair Selection List (Primary) Panel

    NOTE: Even if you dissolve all of the copy pairs in a copy group, the copy group itself is not deleted. To delete the copy group itself, the corresponding copy group ID must be deleted from the Copy Group Selection List panel. If there is a copy group with no copy pairs, the copy group operation results in an error.
  • Page 90: Import Sms Storage Group Panel

    Table 60 Contents of the Pair Selection List (Primary) Panel Item Description Devn If the copy pairs to be specified are indicated by device numbers, select this item, and then specify the device number range for the copy pairs you want to select (as ascending hexadecimal numbers).
  • Page 91: Import Sms Storage Group Result Panel

    Figure 77 Import SMS Storage Group Panel Table 62 (page 91) describes the items in the Import SMS Storage Group panel. Table 62 Contents of the Import SMS Storage Group Panel Item Description SMS Storage Group Name Specify the SMS storage group name (within 8 characters) used by Business Continuity Manager.
  • Page 92 you then press the Enter key with S displayed next to AC, the devices become selected. A similar operation occurs when you select VOLSER and specify the devices by volume name. Figure 79 (page 92) shows the Pair Selection List (Secondary) Panel. Figure 79 Pair Selection List (Secondary) Panel “Contents of the Pair Selection List (Secondary) Panel”...
  • Page 93: Sort Copy Group Container Panel

    If the number of S-VOL devices selected does not match the number of P-VOL devices, this panel remains ready to accept device selections until the number matches the number of P-VOL devices. Once the number of selected devices matches the number of P-VOL devices, display transits to the Copy Group Pair Detail panel.
  • Page 94: Sort Copy Group Pairs List Panel

    Sort Copy Group Pairs List Panel When F6=Sort is pressed in the Copy Group Pair Detail panel, the Sort the Copy Group Pairs List panel is displayed to specify the sort key. Figure 81 (page 94) shows the Sort the Copy Group Pairs List panel. Figure 81 Sort the Copy Group Pairs List Panel In the Sort the Copy Group Pairs List panel, you can select the sorting order from the following items.
  • Page 95 Table 64 Contents of the Scan Copy Pair Inside Storage System Panel Item Description Device Address Primary Specify the Device Address Domain ID to which the P-VOL of the PPRC Domain copy pairs to be scanned belong (required). Use no more than 28 alphanumeric characters. If the specification exceeds 8 characters, place a period every 8 characters.
  • Page 96 Table 64 Contents of the Scan Copy Pair Inside Storage System Panel (continued) Item Description Device Num Specify the Start and End of the device number range for scanning the P-VOL of the PPRC copy pair, using hexadecimal numbers in ascending order (required).
  • Page 97: Browse Copy Group Detail Definition Panel

    NOTE: If a copy group definition file having the same name already exists, it is overwritten. When executing scan operations repeatedly, HP recommends that you change the value specified for CA Copy Group ID, TCA Copy Group ID, or BC Copy Group ID before each execution. If you specify NOCHECK for HS, do not include in the search range a CA pair volume of PPRC for which HyperSwap is enabled.
  • Page 98: Manage Route Panel (Route Management)

    Figure 84 Browse Copy Group Pair Detail Panel For the items in the Browse Copy Group Pair Detail panel, see “Copy Group Pair Detail Panel” (page 87). The Browse Copy Group Pair Detail panel is for browsing details on copy groups only, and is not for editing.
  • Page 99: Extra Command Device Direct Operation Panel

    Figure 86 Manage Route Panel “Contents of the Manage Route Panel” (page 99) describes the items in the Manage Route panel. Table 65 Contents of the Manage Route Panel Item Description Specify an action. s: Displays the Route Status panel used to display the information on the route list ID. Route List ID Route list ID Extra Command Device Direct Operation Panel...
  • Page 100: Executing Ykdelcmd

    Table 66 Contents of the Extra Command Device Direct Operation Panel Item Description Route List ID Route list ID selected in the Manage Route panel You can operate command devices on a DAD that includes command devices defined in the displayed route list ID. If you press the F5=Extra key without specifying a route list ID in the Manage Route panel, the message *** Route List is not selected *** will be displayed.
  • Page 101: Route Status Panel (Route Management)

    NOTE: When using the HP StorageWorks XP1024/XP128 Disk Array, take the target command device offline before executing the YKDELCMD command. For the following models, you can execute the YKDELCMD command regardless of whether the target command device is online or offline: HP StorageWorks XP12000/XP10000 Disk Array ◦...
  • Page 102 Figure 88 Route Status Panel (F10=DADInfo Key Pressed) Figure 89 (page 102) shows the Route Status panel when the F1 1=CCAInfo key is pressed. Figure 89 Route Status Panel (F1 1=CCAInfo key pressed) Table 67 (page 102) describes the items in the Route Status panel. Table 67 Contents of the Route Status Panel Item Description...
  • Page 103 Table 67 Contents of the Route Status Panel (continued) Item Description 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 system.
  • Page 104: Executing Ykqrydev

    NOTE: Status displays the execution result of the action 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.
  • Page 105 Figure 91 Command Device Status Panel (Command Device Not Registered/Copy Pair Defined) 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.
  • Page 106: Executing Ykbldcmd

    CCA to which the S-VOL belongs Status Copy pair status (see the table about the P-VOL/S-VOL status and copy pair status in the HP StorageWorks P9000 for Business Continuity Manager Software Users Guide. If the information cannot be obtained, N/A is displayed.
  • Page 107: Executing Ykdelcmd

    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.
  • Page 108 Figure 93 Command Device Selection List Panel Table 69 (page 108) describes the items in the Command Device Selection List panel. Table 69 Contents of the Command Device Selection List Panel Item Description Device Address Domain ID DAD ID Description Description of the storage system specified in the Host-Discovered Array structure Model...
  • Page 109: Manage Path Set Panel (Logical Path Management)

    Table 69 Contents of the Command Device Selection List Panel (continued) Item Description CCA of the detected command device (2-digit hexadecimal number) Devn Device number of the detected command device (2-digit hexadecimal number) If the specified action has been aborted, the execution result (RC) is not displayed correctly. When the route list definition has been modified or deleted, sometimes the command devices defined in the old route list remain registered in the storage system.
  • Page 110: Executing Ykload

    Table 70 Contents of the Manage Path Set Panel Item Description Specify an action. l: Executes the YKLOAD command and loads a path set. b: Executes the YKBLDPTH command, and establishes all logical paths in the selected path set. d: Executes the YKBLDPTH command, and deletes all logical paths in the selected path set.
  • Page 111: Executing Ykdelpth

    Figure 95 LOAD Option Panel (When Loading a Path Set) For Route List ID displayed in the LOAD Option panel, specify the route list ID of the route list to be loaded (no more than 8 alphanumeric characters). Hyphens cannot be used. Note that depending on the specifications for the Remote DKC Function column and the Preset RouteListID column in the Set Defaults panel, the LOAD Option panel might not be displayed.
  • Page 112 Figure 96 Path Set Status Panel Table 71 (page 112) describes the items in the Path Set Status panel. Table 71 Contents of the Path Set Status Panel Item Description Path Set ID Path set ID Specify an action. s: Displays the Logical Path Status panel used to display status details for the logical path.
  • Page 113: Logical Path Status Panel

    Table 71 Contents of the Path Set Status Panel (continued) Item Description Secondary Secondary storage system serial number Path ID of the secondary site When the path type is CU, nothing is displayed. Secondary CU number Displays the number of the CU in which a device exists to which the path operation command is issued.
  • Page 114 Figure 97 Logical Path Status Panel Table 72 (page 114) describes the items in the Logical Path Status panel. Table 72 Contents of the Logical Path Status Panel Item Description Path Set ID Path set ID Type Type of path CU: Inter-CU logical path DKC: Inter-DKC logical path Primary...
  • Page 115: Executing Ykqrypth With Restruct Specified

    If the AC in the Manage Path Set panel 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.
  • Page 116 Figure 98 Manage Copy Groups Panel Table 73 (page 117) describes the items in the Manage Copy Groups panel. 1 16 ISPF Panels...
  • Page 117 Table 73 Contents of the Manage Copy Groups Panel Item Description Specify an action. l: Executes the YKLOAD command to load copy groups. q: Executes the YKQUERY command to display the copy pair volume status. m: Executes the YKMAKE command to create copy pairs. u: Executes the YKSUSPND command to suspend copy pairs.
  • Page 118: Sort The Copy Groups Panel

    ◦ When f is specified, neither Approx. Matching % nor CTDelta is displayed on the Copy Group Status Summary panel. ◦ When f is specified, neither Match Rate% nor CT Delta DDD HH:MM:SS is displayed on the Copy Group Pair Status panel.
  • Page 119: Executing Ykload

    Figure 99 Sort the Copy Groups Panel In the Sort the Copy Groups panel, you can use the following items to select how to sort: Item Sorted by 1 Copy Group ID Copy group ID 2 Status Result of action execution Executing YKLOAD If l is specified in the AC column 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...
  • Page 120: Copy Group Status Summary Panel (Executing Ykquery)

    If m or q is specified in the AC column in the Manage Copy Groups panel without executing the YKLOAD command, the Confirm Copy Group Load panel is displayed to request the copy group load. For more information on the Confirm Copy Group Load panel, see “Confirm Copy Group Load Panel”...
  • 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)
  • Page 122 Figure 102 Copy Group Status Summary Panel “Contents of the Copy Group Status Summary Panel” (page 122) describes the items in the Copy Group Status Summary panel. Table 74 Contents of the Copy Group Status Summary Panel Item Description Copy Group ID Copy group ID Primary Device Addr.
  • Page 123: Copy Group Storage System Summary Panel

    Table 74 Contents of the Copy Group Status Summary Panel (continued) Item Description Invalid State Number of copy pairs in the INVALID status (includes the SUSPER status, HOLDER status, and CONSLOST status) No Delta Number of copy pairs in the NODELTA status The following table shows the proxy C/T delta values that are displayed: Condition Displayed value...
  • Page 124: Caa Copy Group Performance Statistics Panel

    Table 75 Contents of the Copy Group Storage System Summary Panel (continued) Item Description Secondary Device Addr. Domain Secondary DAD ID Pri-SN Serial number of the primary storage system Sec-SN Serial number of the secondary storage system State Counts Duplex Number of copy pairs in the DUPLEX status Pend Number of copy pairs in the PENDING status...
  • Page 125 Table 76 Contents of the CAA Copy Group Performance Statistics Panel Item Description Current Time Current time Copy Group ID Copy group ID Primary Device Addr. Domain Primary DAD ID in the copy group definition file Secondary Device Addr. Domain Secondary DAD ID in the copy group definition file C/T ID Consistency group ID in the copy group definition file...
  • Page 126: Sort Caa Copy Group Statistics Panel

    NOTE: 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 the copy direction is opposite from the direction specified in the copy group definition file, the secondary and primary storage system serial numbers in the copy group definition file are shown in order for Pri-SN and Sec-SN.
  • Page 127: Caj Copy Group Performance Statistics Panel

    Figure 105 Sort CAA Copy Group Statistics Panel In the Sort CAA Copy Group Statistics panel, you can select the sorting order from the following items. Item Sort Order 1. MCU Total Reserved Sidefile Rate Descending order of the Pri-SN reserved sidefile cache-usage rate 2.
  • Page 128 Figure 106 CAJ Copy Group Performance Statistics Panel Table 77 (page 128) describes the items in the CAJ Copy Group Performance Statistics panel. Table 77 Contents of the CAJ Copy Group Performance Statistics Panel Item Description Current Time Current time Copy Group ID Copy group ID Primary Device Addr.
  • Page 129 Table 77 Contents of the CAJ Copy Group Performance Statistics Panel (continued) Item Description Pri %s JNL-VOL Journal group metadata usage rate for Pri-SN. The percentage used of the Journal Metadata capacity available in the Journal Volume(s) registered to M-JNL. Journal group data usage rate for Pri-SNThe percentage used of the Journal Metadata capacity available in the Journal Volume(s) registered to M-JNL.
  • Page 130: Sort Caj Copy Group Statistics Panel

    You can specify the following fields for a sort key of the SORT command: Name of field Sorted by Direction CTID Consistency group ID of the primary journal group in the copy group definition file Ascending SUBCTID Consistency group ID of the secondary journal group in the copy group definition Ascending file Serial number of the storage system for Pri-SN...
  • Page 131: Copy Group Pair Status Panel

    Item Sort Order 5. Transfer Rate(M-JNL->R-JNL KBytes/s) In order of the data transfer rates between Pri-SN and Sec-SN (KB/s) 6. JNL-Vol Usage Rate for M-Metadata Metadata usage rate of the journal group for Pri-SN 7. JNL-Vol Usage Rate for R-Metadata Metadata usage rate of the journal group for Sec-SN 8.
  • Page 132 For CAJ, the type of consistency time to be used differs depending on the value specified in C/T TIME MODE of the Copy Group Attribute (CAJ) panel. For details about the consistency time, see the HP StorageWorks P9000 Continuous Access Synchronous for Mainframe Systems User Guide: HP...
  • Page 133 Table 78 Contents of the Copy Group Pair Status Panel (continued) Item Description Displays the following information that indicates whether the S-VOL is an external volume. +: An external volume -: Not an external volume (blank): The volume attribute is unknown because it was not requested. AC Result Action Executed action...
  • Page 134: Sort The Copy Group Pairs Status Panel

    Name of field Value in field Type Copy direction (<, >) Character string Return code from action execution Decimal PRIEX Blank, -, or + in the EX for P-VOL Character string SECEX Blank, -, or + in the EX for S-VOL Character string If you omit the field name, PDEVN will be set as a default value.
  • Page 135: Volume Query Information (Bc) Panel

    Table 79 Sort the Copy Group Pairs Status Panel (continued) Item Sort Order 10. Primary external volume information Blank, +, or - in the EX for P-VOL 1 1. Secondary external volume information 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 executed on the P-VOL and S-VOL, and the Volume Query Information (BC) panel is displayed for an BC...
  • Page 136 Figure 1 1 1 Volume Query Information (BC) Panel Table 80 (page 136) describes the items in the Volume Query Information (BC) panel. Table 80 Contents of the Volume Query Information (BC) Panel Item Description Copy Group ID Copy group ID Copy Group Type (in Configuration) Copy group type at definition Copy Group Type (from Storage System)
  • Page 137 Table 80 Contents of the Volume Query Information (BC) Panel (continued) Item Description Secondary Volume Storage system serial number of the S-VOL at definition SSID SSID of the S-VOL at definition. CU number of the S-VOL at definition CCA of the S-VOL at definition DEVN Device number of the S-VOL at definition The following volume online information is...
  • Page 138 Table 80 Contents of the Volume Query Information (BC) Panel (continued) Item Description Preset Mode Type of ATTIME suspend function used CAJ(STEADY): The CAJ ATTIME suspend function is used. The suspension is activated in STEADY mode. CAJ(QUICK): The CAJ ATTIME suspend function is used.
  • Page 139 Table 80 Contents of the Volume Query Information (BC) Panel (continued) Item Description PROT MODE Write-protect for the S-VOL PROTECT: Update of the S-VOL is prohibited after the copy pair is suspended (YKSUSPND command is executed). PERMIT: Update of the S-VOL is allowed after the copy pair is suspended (YKSUSPND command is executed).
  • Page 140: Volume Query Information (Ca) Panel

    Array. See the table (for BC) in the HP StorageWorks P9000 for Business Continuity Manager Software User Guide for details about obtaining the status of the displayed copy pair using the YKQRYDEV command. Note that when the device is a...
  • Page 141 Figure 1 12 Volume Query Information (CA) Panel Volume Query Information (TC) Command ===> 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 --------- SSID CU CCA DEVN...
  • Page 142 Table 81 Contents of the Volume Query Information (CA) Panel (continued) Item Description DEVN Device number of the S-VOL at definition The following volume online information is displayed to the right of DEVN: *: Online -: Offline Nothing is displayed when volume online information cannot be obtained.
  • Page 143 Table 81 Contents of the Volume Query Information (CA) Panel (continued) Item Description Freeze SCP : Freeze the storage system (place in SCP status) 5, 1 when a failure suspension (SUSPER) occurs. Y: Places in SCP status. N: Does not place in SCP status. If one of the following conditions is satisfied, N/A is displayed: The consistency group ID is not registered...
  • Page 144 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. Note that when the device is a command device of either of the following models,...
  • Page 145: Volume Query Information (Caa) Panel

    NOTE: In the following cases, N/A is displayed for the device information. When the YKQRYDEV command returns an error When displaying 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 and S-VOL, and the Volume Query Information (CAA) panel is displayed for a CAA...
  • Page 146 Figure 1 14 Volume Query Information (CAA) Panel “Contents of the Volume Query Information (CAA) Panel” (page 146) describes the items in the Volume Query Information (TCA) panel. Table 82 Contents of the Volume Query Information (CAA) Panel Item Description Copy Group ID Copy group ID Copy Group Type(in Configuration)
  • Page 147 Table 82 Contents of the Volume Query Information (CAA) Panel (continued) Item Description Copy direction in the copy pair Always displays > when the Status of the Primary Volume is SIMPLEX. Secondary Volume Storage system serial number of the S-VOL at definition SSID SSID of the S-VOL at...
  • Page 148 Table 82 Contents of the Volume Query Information (CAA) Panel (continued) Item Description Suspend ATTIME ATTIME suspend time and ATTIME suspend status On the first line (GMT) : ATTIME-suspend-time-in-GMT - status is displayed. ATTIME-suspend-time-in-GMT - ATTIME-suspend-status, one of the following is message displayed: Notset: ATTIME suspend time is not set.
  • Page 149 Table 82 Contents of the Volume Query Information (CAA) Panel (continued) Item Description ERROR LVL Error level VOLUME: When a failure occurs, only the affected volumes are suspended. GROUP: When a failure occurs, all volumes in the same copy group are suspended.
  • Page 150 Table 82 Contents of the Volume Query Information (CAA) Panel (continued) Item Description Other CopyPair Information Primary/Secondary Type The following information is displayed if there are any other copy pairs apart from the one specified in the Copy Group Pair Status panel: Copy type Indication of whether it is...
  • Page 151: Volume Query Information (Caj) Panel

    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. Note that when the device is a command device of either of the following models,...
  • Page 152 Figure 1 15 Volume Query Information (CAJ) Panel Table 83 (page 152) describes the items in the Volume Query Information (CAJ) panel. Table 83 Contents of the Volume Query Information (CAJ) Panel Item Description Copy Group ID Copy group ID Copy Group Type (in Configuration) Copy type at definition Copy Group Type (from Storage System)
  • Page 153 Table 83 Contents of the Volume Query Information (CAJ) Panel (continued) Item Description Copy direction in the copy pair Always displays > when the Status of the Primary Volume is SIMPLEX. Secondary Volume Storage system serial number of the S-VOL at definition SSID SSID of the S-VOL at...
  • Page 154 Table 83 Contents of the Volume Query Information (CAJ) Panel (continued) Item Description F, R (from Storage System) EXCTG ID that has been registered in a storage system F: EXCTG ID in the forward direction R: EXCTG ID in the reverse direction N/A is displayed if EXCTG is not registered, or if the...
  • Page 155 Table 83 Contents of the Volume Query Information (CAJ) Panel (continued) Item Description Other CopyPair Information Primary/Secondary Type The following information is displayed if there are any other copy pairs apart from the one specified in the Copy Group Pair Status panel: Copy type Indication of whether it is...
  • Page 156 YKQRYDEV command, in the HP StorageWorks P9000 for Business Continuity Manager Software Users Guide. Note that when the device is a command device of either of the following models, CDEV(apid) is displayed in the Status column...
  • Page 157 performed in the forward direction. This information is held by the copy source volume and flag1 may have one of the following values: 0: The journal group has not been registered in a storage system as EXCTG. 1: The journal group has been registered in a storage system as EXCTG. N/A: Unable to identify the status.
  • Page 158: Volume Query Information Panel (Executing Ykqrydev)

    If the journal group is normally registered in a storage system as EXCTG, the information will be displayed as follows: When the copy is being performed in the forward direction: active(1,1) - N/A(N/A,1) When the copy is being performed in the reverse direction: N/A(N/A,1) - active(1,1) NOTE: For flag1 and flag3, information is obtained in the following situations:...
  • Page 159: Executing Ykmake

    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 1 16 (page 159), Figure 1 17 (page...
  • Page 160: Executing Yksuspnd

    Table 84 Contents of the Make Options Panel Item Description Copy Group ID Copy group ID Initial Copy Option Specify the NOCOPY or HOLD parameter of the YKMAKE command. Full Copy: Makes a copy pair by full copy. No Copy: Makes a copy pair without copying the volume (the NOCOPY parameter is specified).
  • Page 161 Figure 1 19 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)
  • Page 162 Figure 122 CAA Copy 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 in the Suspension Options panel.
  • Page 163 Table 85 Contents of the Suspension Options Panel Item Description Copy Group ID Copy group ID Suspend Option Specify the parameter of the YKSUSPND command by using the number. Steady: Moves to SUSPOP status after copying data. Quick: Moves quickly to an SUSPOP status in the BC data copy. Drain: Suspends after reflecting the unreflected data.
  • Page 164 Table 85 Contents of the Suspension Options Panel (continued) Item Description Preset Date YYYYMMDD Specify the ATTIME parameter (ATTIME suspend time) of the YKSUSPND command. Preset Time HHMMSS Before the ATTIME parameter is specified, the current date and time Plus Minutes MMMM are displayed in Preset Data and Preset Time.
  • Page 165: Executing Ykresync

    Table 85 Contents of the Suspension Options Panel (continued) Item Description Generation ID Specify the GENID parameter of the YKSUSPND command (from 00 to FF). The specified value is used as the number for identifying backup generations. VolUnit Specify the VOLUNIT parameter of the YKSUSPND command: Y: Performs operations on a volume basis, even for an environment that supports operations on a group basis during specification.
  • 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...
  • Page 167 In the Resync Options panel, if Y is specified in the Overwrite ONLINE target volume and the F3=Exit key is pressed, the Confirm Overwrite ONLINE Target Volume panel is displayed, as shown “Confirm Overwrite ONLINE Target Volume Panel” (page 182). This panel provides a warning that the contents of the online target volume (S-VOL) will be overwritten when the YKRESYNC command is executed.
  • Page 168: Executing Ykdelete

    Table 86 Contents of the Resync Options Panel (continued) Item Description VolUnit Specify the VOLUNIT parameter of the YKRESYNC command: Y: Performs operations on a volume basis, even for an environment that supports operations on a group basis during specification. To specify this parameter after ATTIME suspend, execute the YKSUSPND command with the CANCEL parameter specified.
  • Page 169: Executing Ykwatch

    NOTE: Do not execute the YKDELETE command during planned outage operation (when switching the P-VOL and S-VOL). To dissolve the copy pair, switch the P-VOL and S-VOL again, return the P-VOL to the primary site (restore normal operation), 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 volume status transition will be executed and the Watch Options panel for specifying...
  • Page 170: Executing Ykewait

    NOTE: In some configurations, such as when BC and CA share volumes or a 1 to n (n is greater than 2) configuration of BC, the status transitions of each copy pair might not 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.
  • Page 171: Executing Ykrecver

    Table 88 Contents of the Wait Options Panel Item Description Copy Group ID Copy group ID Wait transition to Specify the waiting status for the YKEWAIT command by using the number. Duplex: Waits for the volume to change to the DUPLEX status. Suspend: Waits for the volume to change to the suspend status.
  • Page 172 Figure 132 Path Set Status of Copy Group Pair Panel Table 89 (page 172) describes the items in the Path Set Status of Copy Group Pair panel. Table 89 Contents of the Path Set Status of Copy Group Pair Panel Item Description Copy Group ID...
  • Page 173: Logical Path Status Of Copy Group Pair Panel

    The path information displayed in the Path Set Status of Copy Group Pair panel differs depending on the copy type: When the copy type is CA/CAA, path information for the inter-control unit logical path in the copy direction is displayed When the copy type is CAJ, path information for the bidirectional inter-disk controller logical path is displayed.
  • Page 174 Figure 133 Logical Path Status of Copy Group Pair Panel Table 91 (page 174) describes the items in the Logical Path Status of Copy Group Pair panel. Table 91 Contents of the Logical Path Status of Copy Group Pair Panel Item Description Copy Group ID...
  • Page 175: Confirmation Panels

    Table 91 Contents of the Logical Path Status of Copy Group Pair Panel (continued) Item Description Secondary Secondary port number Status 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 invalid.
  • Page 176: Confirm Execution Recover Panel

    Confirm Execution Recover Panel If c is specified in AC in the Manage Copy Groups panel, the Confirm Execution Recover panel is displayed, prompting you to confirm whether the copy pair is dissolved. Figure 135 (page 176) shows the Confirm Execution Recover panel. Figure 135 Confirm Execution Recover Panel “Contents of the Confirm Execution Recover Panel”...
  • Page 177: Confirm Cancellation Of Changes Panel

    “Contents of the Confirm Command Device Build Panel” (page 177)describes the items in the Confirm Command Device Build panel. Table 94 Contents of the Confirm Command Device Build Panel Item Description Route List ID Route list ID Serial Number Selected storage system serial number Set command device build Specify whether to display the Confirm Command Device confirmation off...
  • Page 178: Confirm Command Device Delete Panel

    Figure 138 Confirm Cancellation of Editing Panel Pressing the Enter key cancels the update of the copy pair definition file or path set definition file. Pressing the F12=Cancel key continues processing while keeping the update of the copy pair definition file or path set definition file. Confirm Command Device Delete Panel This panel changes depending on which of two panels it originates from.
  • Page 179: Displayed From Extra Command Device Direct Operation Panel

    Pressing the Enter key deletes the command device registered in the storage system. Pressing the F12=Cancel key cancels the deletion of the command device. Displayed from Extra Command Device Direct Operation Panel In the Extra Command Device Direct Operation panel, if you specify d for AC, the Confirm Command Device Delete panel appears to confirm that you can delete a command device registered in the storage system.
  • Page 180: Confirm Configuration File Delete Panel

    Table 96 Contents of the Confirm Command Device Delete Panel (displayed from Extra Command Device Direct Operation Panel) (continued) Item Description CCA to which the specified command device belongs APID APID of the specified command device For the HP StorageWorks XP1024/XP128 Disk Array, or when APID information cannot be obtained, N/A is displayed in the APID.
  • Page 181: Confirm Copy Group Load Panel

    Figure 142 Confirm Configuration File Update Panel If you change the definition in the Copy Group Attributes panel and then press the Enter key, any required attributes that were not entered in the Copy Group Attributes panel are displayed in a Warning.
  • Page 182: Confirm Overwrite Online Target Volume Panel

    Confirm Overwrite ONLINE Target Volume Panel In the Make Options panel, if Y is specified in the Overwrite ONLINE target volume and the Enter key is pressed, the Confirm Overwrite ONLINE Target Volume panel is displayed. Figure 144 (page 182) shows the Confirm Overwrite ONLINE Target Volume Panel Figure 144 Confirm Overwrite ONLINE Target Volume Panel This panel provides a warning that the contents of the online target volume (S-VOL) will be...
  • Page 183: Confirm Path Set Load Panel

    Table 97 Contents of the Confirm Path Delete Panel Item Description Path Set ID Path set ID Delete Option Specify whether to set the FORCE parameter when executing the YKDELPTH command by using the number. Delete only non-share paths: Do not specify the FORCE parameter. Delete all paths: Specify the FORCE parameter.
  • Page 184: Confirm Route List Edit Panel

    For details about what actions to take when an error occurs during creation of the configuration file, see the HP StorageWorks P9000 for Business Continuity Manager Software Users Guide. Figure 149 (page 184) shows the Confirm Retry of Configuration File Create panel.
  • Page 185: Confirm Open/Mf Consistency Group Suspension Panel

    Confirm Open/MF Consistency Group Suspension Panel When you suspend an Open/MF consistency group, the Confirm Open/MF Consistency 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.
  • Page 186: Cli Commands

    2 CLI Commands This chapter describes the functions of the commands available in the CLI for 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 187: Copy Types And Targets For Which Commands Can Be Executed

    Copy Types and Targets for Which Commands Can Be Executed This section explains the copy types and targets for which commands can be executed. Each command has certain copy types and targets that it can execute. The copy types and targets for which commands can be executed are indicated below.
  • Page 188: Configuration Files That Must Be Loaded Before Command Execution

    Table 99 List of Supported Functions (continued) Command Function Monitors the copy pair status transition and waits for a certain specified status. YKEWAIT Outputs the contents of a copy group definition file to a CSV file. YKEXPORT Acquires the FlashCopy information for the specified volume. YKFCSTAT Freezes the specified copy group, changes it to the SCP status, and then suspends YKFREEZE...
  • Page 189 Table 100 (page 189) shows the configuration files that must be loaded in an environment that does not contain a Non Gen'ed volume and where the following conditions exist: The P-VOL is recognized by the host. The copy type parameter is CA, CAA or CAJ, and the host does not recognize the S-VOL. The copy type parameter is BC, and the host recognizes the S-VOL.
  • Page 190 Table 100 Configuration Files That Must Be Loaded Before Command Execution (When the Environment Does Not Contain a Non Gen'ed Volume) (continued) Command name Configuration file that must be loaded Copy group definition file Route list definition file Path set definition file YKSCAN YKSLEEP YKSTATS...
  • Page 191: Command Details

    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 Copy group definition file Route list definition file Path set definition file YKMAKE YKQHPATH YKQRYDEV...
  • Page 192: Ykbldpth Command

    Parameters SN(storage system-serial-number) ~ <from 5 to 12 alphanumeric characters> Specify the storage system serial number. Only the command device with the specified storage system serial number is created. MSG(stem-name- 1 ) ~ <REXX prefix of 64 or fewer characters> Specify an optional prefix for the name of the message structure used to store the messages to be generated by this command.
  • Page 193 Format YKBLDPTH STEM(stem-name-1) MSG(stem-name-2) PSN(storage system-serial-number)[ PCU(cu-number)]] SSN(storage system-serial-number)[ SCU(cu-number)]] {FORWARD|REVERSE}] TYPE({CU|DKC})] Function This command is a TSO/E command called from REXX scripts. This command establishes logical paths for some or all of the paths identified in the path set that is stored in the path set structure with the prefix specified by the STEM parameter.
  • Page 194 If neither this parameter nor any other parameters are specified, the command establishes all logical paths. SCU(cu-number) ~ <2-digit hexadecimal number> If this parameter is specified, for each logical path within the path set stored in the path set structure specified for the STEM parameter, inter-CU logical paths will be established such that the CU number of the RCU matches the value specified for this parameter.
  • Page 195: Ykconmsg Command

    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 error. Alternatively, in the Edit Logical Path Definition panel, specify a different, valid volume on which a device scan has been performed, in CU, SSID, and CCA in the path set definition file for the command execution target.
  • Page 196 Function This 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-specified message that indicates that a HyperSwap has been completed Parameters...
  • Page 197: Ykdelcmd Command

    CLOSE This parameter terminates the EMCS console interface for message monitoring. HANDLE(X'handle') ~ <8-digit hexadecimal number> Specify the handle to be used to associate this request to an EMCS console interface that has already been established. Specify the value returned in the YKCONMSG OP(OPEN) command's completion message as the handle value.
  • Page 198 Format YKDELCMD SN(storage system-serial-number)| SN(storage system-serial-number) CU(cu-number) CCA(cca-number) APID(apid)| DEVN(device-number) APID(apid)} MSG(stem-name-1) Function This command is a TSO/E command called from REXX scripts. The command deletes, from the storage system, the command device that was specified in the route list that was loaded before this command was executed. Parameters SN(storage system-serial-number) ~ <from 5 to 12 alphanumeric characters>...
  • Page 199: Ykdelete Command

    NOTE: For the YKDELCMD command, you need to input the storage system for the Primary site and Secondary site, according to the reverse of the site order defined in the route list. Be sure to perform input in the order of the secondary site and Primary site. With the HP StorageWorks XP1024/XP128 Disk Array, be sure to take the corresponding command device offline before executing the YKDELCMD command.
  • Page 200: Ykdelete Command

    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 Commands...
  • Page 201: Ykdelpth Command

    NOTE: Do not execute the YKDELETE command during planned outage operation (when switching the P-VOL and S-VOL). To dissolve the copy pair, switch the P-VOL and S-VOL again, return the P-VOL to the primary site (restore normal operation), and then dissolve the copy pair. When operating the copy groups of a copy pair that was deleted with the DEVN parameter, for the time that the copy pair is being synchronized, be sure to specify the SELECT(COND) parameter.
  • Page 202 [FORWARD|REVERSE}] FORCE] TYPE({CU|DKC})] Function This command is a TSO/E command called from REXX scripts. This command deletes some or all of the logical paths identified in the path set that is stored in the path set structure with the prefix specified by the STEM parameter. Parameters STEM(stem-name- 1 ) ~ <REXX prefix of 64 or fewer characters>...
  • Page 203 SCU(cu-number) ~ <2-digit hexadecimal number> If this parameter is specified, out of the logical paths within the path set stored in the path set structure specified for the STEM parameter, inter-CU logical paths will be deleted in all cases where the CU number of the RCU matches the value specified for this parameter.
  • Page 204: Ykdrop Command

    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 of the error. Alternatively, in the Edit Logical Path Definition panel, specify a different, valid volume on which a device scan has been performed, in CU, SSID, and CCA in the path set definition file for the command execution target.
  • Page 205 This function can either drop all the valid REXX variable structures in the script, or drop only the REXX variable structures with a specific stem name. Parameters Drops all the valid REXX variable structures (copy group structures, route list structures, path set structures, Host-Discovered Array Index structures, and Host-Discovered Array structures) in the script.
  • Page 206: Ykenv Command

    Table 108 YKDROP Command Return Code List (continued) Return code Meaning 1012 There is an error in the specified stem name. 1016 The specified stem name is invalid. 1032 Internal information-table release processing resulted in an error. 1044 An error occurred while a REXX variable was being accessed.
  • Page 207: Output Example

    &YKSYSLG = 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...
  • Page 208: Ykercode Command

    Specify the storage system sense byte information (error code) that is included in the message displayed by Business Continuity Manager. For details on error codes, see the section that describes storage system sense byte information in the HP StorageWorks P9000 for Business Continuity Manager Software Messages.
  • Page 209: Ykewait Command

    Table 1 1 1 YKERCODE Command Return Code List (continued) Return Code Meaning Command execution terminated because of an invalid parameter. The module cannot be loaded. Possible causes are as follows: The library dataset has not been linked. The module is protected by the RACF 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...
  • Page 210 DUPLEX The command waits until all the copy pairs in the group reach the DUPLEX status. However, if the status of any copy pair changes to the SIMPLEX, SUSPCU, SUSPER, TRANS, SUSPVS, HOLDER, NODELTA, CONSLOST, or INVALID status, the YKEWAIT command terminates abnormally with return code 8.
  • Page 211 at that moment. If the status is the same as the one specified in the GOTO parameter, the command terminates normally (return code = 0). If not, it terminates abnormally with the return code 4. If 0 is specified in TIMEOUT parameter, it looks at the status of the copy group immediately, and then returns as described previously.
  • Page 212 Note that, for CG containers specified by EXCTG ID, the command checks the EXCTG registration information for all CG containers. After specifying the 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.
  • Page 213: Ykexport Command

    Table 1 13 YKEWAIT Command Return Code List (continued) Return Code Meaning An invalid or unknown element was found in the configuration. An inconsistency between a copy group definition and an actual copy group was detected. An error occurred while a REXX variable was being written. Terminating due to processing errors.
  • Page 214: Ykfcstat Command

    44 - (5 + PREFIX-length) NOTE: The execution of this command does not check if the configuration of the copy groups specified in the copy group definition file is supported. Therefore, an error could result when you specify, by using the YKIMPORT command, a CSV file created by this command. If an error occurs, check if the configuration of the copy groups in the CSV file is supported.
  • Page 215: Ykfreeze Command

    Parameters STEM(stem-name- 1 ) ~ <REXX prefix of 64 or fewer characters> Specify an optional prefix for the name of the FlashCopy information structure used to store the FlashCopy information. You must also include a trailing period character. MSG(stem-name-2) ~ <REXX prefix of 64 or fewer characters> Specify an optional prefix for the name of the message structure used to store the messages to be generated by this command.
  • Page 216: Ykfreeze Command

    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 function.
  • Page 217: Ykh2B Command

    Table 1 16 YKFREEZE Command Return Code List (continued) Return Code Meaning Terminating due to invalid parameters. The command terminated abnormally. The user does not have permission to execute this command. YKH2B Command Applies to Continuous Access Synchronous for Mainframe with the HyperSwap attribute. Format YKH2B PREFIX(prefix)
  • Page 218 CGNAME(name-of-TrueCopy-copy-group-with-HyperSwap-attribute) ~ <string of 8 or fewer characters> Specify the name of a CA copy group with the HyperSwap attribute. HS({CHECK|NOCHECK}) Specify whether to check if HyperSwaps are enabled for the detected PPRC copy pairs. CHECK Acquires the UCB information (UCBHSWAP) of the P-VOLs of detected PPRC copy pairs and checks whether HyperSwaps are enabled.
  • Page 219: Ykimport Command

    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 PREFIX(prefix) BASEGROUP(copy group–ID) NEWGROUP(copy group–ID) Function This is a TSO/E command.
  • Page 220: Ykinschk Command

    Table 1 18 YKIMPORT Command Return Code List Return Code Meaning The command terminated completed normally. A copy group definition file was created. No copy pairs were defined in the specified CSV file. No data was output to the copy group definition file. A copy group definition file was created, but there was an inconsistency in the input information.
  • Page 221 Table 120 YKINSCHK Command Output Items Output item Explanation Security Setting OK is output: The name of a profile for referencing or operations has been set. FAULTY is output: No name has been set for a profile for referencing or operations. User SVC Routine OK is output: There are no problems in the user SVC setting.
  • Page 222 Facility Class Profiles Query : STGADMIN.YKA.BCM.YKQUERY Facility Class Profiles Commands : STGADMIN.YKA.BCM.COMMANDS Directions The current setup is listed above. An unregistered profile is listed as N/A. The RACF settings are necessary in order to use CLI commands. After a profile is defined in the RACF FACILITY class, a user can use CLI commands by being given the access rights of the profile.
  • Page 223: Ykload Command

    YKLOAD Command Format YKLOAD STEM(stem-name-1) PREFIX(prefix) GROUP(copy-group-id) DAD(dad-id) ROUTE(route-list-id)]| PATH(path-set-id) DAD(dad-id) ROUTE(route-list-id)]]| ROUTE(route-list-id) DAD((dad-id)} MSG(stem-name-2) Function This command is an REXX subroutine. This command loads the configuration file defined in the ISPF panel and creates an REXX variable structure. The types of REXX variable structures that are created by this command are as follows: Copy group structure Host-Discovered Array Index structure Host-Discovered Array structure...
  • Page 224 NOTE: Regardless of the prefix specified in the STEM parameter, the Host-Discovered Array Index structure is created with the prefix HCC.HDA, and the route list structure is created with the prefix HCC.ROUTELIST. The created REXX variable structures take effect within the script. Parameters STEM(stem-name- 1 ) ~ <REXX prefix of 64 or fewer characters>...
  • Page 225 NOTE: The YKLOAD command is an REXX subroutine, so it should be called from REXX script by the REXX CALL key word instruction. When you execute the YKLOAD command more than once using the same stem-name, the system overwrites the REXX variables. The invoked script executed from CALL statement or EXEC command should not read a configuration file with the same stem-name as the one read by the invoking script.
  • Page 226: Ykmake Command

    Table 122 YKLOAD Command Return Code List (continued) Return Code Meaning Terminating due 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 STEM(stem-name-1)
  • Page 227 HP StorageWorks P9000 for Business Continuity Manager Software Users Guide. For CG containers specified by EXCTG ID, journal groups not registered in EXCTG are registered even if there is no volume that is manipulated by the command.
  • Page 228 NOTE: If ONLINE(YES) is specified, volume corruption might occur because a copy pair can be made even if the S-VOL is being used. Thus, consideration with respect to volume operation is required, such as limiting operation to periods when the S-VOL is not being used. If transition to HOLD status is not performed, this might indicate an environment in which differentials cannot be maintained in the journal.
  • Page 229: Ykqhpath Command

    YKQHPATH Command Format YKQHPATH DEVN(device-number) Function This is a TSO/E command called from REXX scripts. This command checks the connection status of the I/O path between the host and storage system. It sets in the return code the connection status of the I/O path for a specified volume. Parameters DEVN(device-number) ~ <...
  • Page 230 MSG(stem-name-2) PATH[ SSN(serial-number) [SMODEL({USP|USPV|VSP})]]] Function This command 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.
  • Page 231 SSN(serial-number) ~ <from 5 to 12 alphanumeric characters> To obtain information on an inter-DKC logical path, specify the serial number of the secondary storage system for the inter-DKC logical path you want to obtain. You can obtain information on inter-DKC logical paths whose primary storage system to which the volume specified by the DEVN parameter or the SN, CU, and CCA parameters belongs, and whose secondary storage system is one that has the serial number specified by the SSN parameter.
  • Page 232: Ykqrypth Command

    YKQRYPTH Command Applies to PTH. Format YKQRYPTH STEM(stem-name-1) MSG(stem-name-2) PSN(storage system-serial-number)[ PCU(cu-number)] SSN(storage system-serial-number)[ SCU(cu-number)] {FORWARD|REVERSE}] RESTRUCT] TYPE({CU|DKC})] Function This command is a TSO/E command called from REXX scripts. This command acquires the status of all physical paths allocated to all or some of the logical paths identified in the path set that is stored in the path set structure with the prefix specified by the STEM parameter.
  • Page 233 SSN(storage system-serial-number) ~ <from 5 to 12 alphanumeric characters> If this parameter is specified, out of the logical paths within the path set stored in the path set structure specified for the STEM parameter, inter-CU logical paths will be acquired in all cases where the paths treat CUs within storage systems (that have the serial number specified by this parameter) as RCUs, and inter-DKC logical paths will be acquired in all cases where the paths treat the storage system (that has the serial number specified by this parameter) as the secondary...
  • Page 234 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 of the error. Alternatively, in the Edit Logical Path Definition panel, specify a different, valid volume on which a device scan has been performed, in CU, SSID, and CCA in the path set definition file for the command execution target.
  • Page 235: Ykquery Command

    Table 126 YKQRYPTH Command Return Code List (continued) Return Code Meaning Command execution terminated because a dynamic change in an I/O configuration definition was detected. The command terminated abnormally. The 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 Journal for Mainframe.
  • Page 236 SIMPLEX status, and allows information to be acquired from the P-VOL. For details about the content that is checked, see the description of the copy group configuration check function in the HP StorageWorks P9000 for Business Continuity Manager Software Users Guide. NOTE:...
  • Page 237: Ykrecver Command

    Table 127 YKQUERY Command Return Code List (continued) Return Code Meaning P-VOL is in an inconsistent status. This return code appears, for example, when, in an BC copy group, the P-VOL for the copy pair for which processing is attempted already belongs to a copy pair with a third S-VOL other than the S-VOL defined for the copy group.
  • Page 238: Ykrecver Command

    that depending on the status of the primary site, the status of the volumes in the primary site do not change even after the copy pair is dissolved. The site names are for cases when the copy direction of copy pair configuration and the copy direction which is actually recognized on the storage system are the same.
  • Page 239: Ykresync Command

    Table 128 YKRECVER Command Return Code List (continued) Return Code Meaning Terminating due to invalid parameter. This return code appears, for example, when the parameter DEVN parameter is not found. The command terminated abnormally. The user does not have permission to execute this command.
  • Page 240 The pairs to be manipulated by the command depend on their volume status. 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.
  • Page 241 The following describes the relationship between the VOLUNIT parameter specification and the command execution when issuing the YKRESYNC command to reverse the copy direction. When the VOLUNIT parameter is not specified: The command is executed only when the copy pair status is SWAPPING. When the VOLUNIT parameter is specified: The command is executed even if the copy pair status is not SWAPPING.
  • Page 242 Table 129 Example Procedure Using the ERRCHK Parameter After Transition to HOLDER Status Command Description Checks if all copy pairs are in the HOLD status. YKQUERY STEM(SF.TO.LA.) MSG(MSG.) Synchronizes delta resync pairs, and checks if YKRESYNC STEM(SF.TO.LA.) MSG(MSG.) the return code is 0. DELTAJNL SELECT(COND) Checks the status of all copy pairs if the YKEWAIT STEM(SF.TO.LA.) MSG(MSG.)
  • Page 243 NOTE: If operations with a REVERSE specification such as planned outage take place, to control CA, CAA, or CAJ from the script, HP recommends that you specify explicitly the FORWARD or REVERSE parameter. When specifying the FORWARD or REVERSE parameter to change the copy direction of the copy group, be sure to execute the YKQUERY command or YKEWAIT command and obtain information for the changed copy direction before performing operation.
  • Page 244: Ykrun Command

    Table 130 YKRESYNC Command Return Code List (continued) Return Code Meaning I/O errors were encountered. A change in an I/O configuration definition was detected. Invalid or missing data in a REXX variable. An error occurred while a REXX variable was being written. Terminating due to processing errors.
  • Page 245: Ykscan Command

    Table 131 YKRUN Command Return Code List Return Code Meaning -4095 to -4040 The command terminated abnormally, possibly because the user SVC routine has not been included properly. The module cannot be loaded. Possible causes are as follows: The library dataset has not been linked. The module is protected by the RACF program control function.
  • Page 246: Ykscan Command

    The range from the FROM parameter to the TO parameter is scanned in hexadecimal ascending order. FROMVSN(volser) ~ <from 1 to 6 alphanumeric characters> Specify the volume serial number of the first volume to be scanned. This parameter and the FROM and TO parameters are mutually exclusive. TOVSN(volser) ~ <from 1 to 6 alphanumeric characters>...
  • Page 247: Yksleep Command

    Table 132 YKSCAN Command Return Code List (continued) Return Code Meaning The command skipped a volume whose I/O path was not available. The command generated the REXX variable for the volumes whose detection was successful. I/O errors were encountered. The REXX variable corresponding to the scanned volume is created.
  • Page 248: Ykstats Command

    YKSTATS Command Applies to Continuous Access Asynchronous for Mainframe and Continuous Access Journal for Mainframe. Format YKSTATS STEM(stem-name-1) MSG(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 group. If the copy type is CAJ, the command acquires journal group operating information from both the master journal and restore journal storage systems.
  • Page 249: Ykstore Command

    NOTE: Start Usage Monitor from the Remote Web Console before executing the YKSTATS command. Set the collection interval of Usage Monitor information to 10 minutes or less. If the specified copy group is a CAJ copy group and contains the following volumes, in order to obtain correct information, you must start Usage Monitor for the CU containing the journal volumes used by the copy group.
  • Page 250: Ykstore Command

    MSG(stem-name-2) PATH] UIDCHK] Function YKSTORE command is a REXX subroutine. This command writes information about the copy group or path set on which an operation is being performed to the configuration file defined in the ISPF panel. For details about configuration files, “XML Document Type Definitions”...
  • Page 251: Yksuspnd Command

    Table 135 YKSTORE Command Return Code List Return Code Meaning The command completed normally. The configuration file was not updated because the value of UpdateID in the REXX variable structure and in the configuration file did not match. Terminating due to invalid REXX variable structure. Terminating due to invalid processing.
  • Page 252 Function Copy type Parameter name Function for specifying how to Suspends the copy pair when all pending DRAIN synchronize data at the time of data is synchronized after updating has a suspension terminated. Suspends the copy pair when data up until FLUSH the time of the suspend request is synchronized.
  • Page 253 You must use the CAJ ATTIME suspend function for a copy group in which the P-VOLs are Non Gen'ed volumes. If you do not use the CAJ ATTIME suspend function, an I/O error will occur. For a copy group to which the NORMAL ATTIME suspend time has been set, do not set the CAJ ATTIME suspend time.
  • Page 254 Specify the type of CAJ ATTIME suspend function to be used. If you omit this parameter, the value specified in the ISPF panel when the BC copy pair was defined will be set. NORMAL The NORMAL ATTIME suspend function is used. The CAJ ATTIME suspend function is used.
  • Page 255 For Cnt Ac-A Z, this parameter cannot be specified for a remote storage system. Table 136 (page 255) shows the operation when the ATTIME suspend time that has been set for the CAA copy group is canceled. Table 136 Operation When the ATTIME Suspend Time Is Canceled in CAA Target storage system Setting of the ATTIME Operation when the ATTIME suspend time...
  • Page 256 ATTIME suspend function, see the HP StorageWorks P9000 Business Copy for Mainframe Systems User Guide: HP XP24000 Disk Array, HP XP20000 Disk Array or the HP StorageWorks P9000 Business Copy for z/OS User Guide: HP XP12000 Disk Array, HP XP10000 Disk Array, HP 200 Storage Virtualization System.
  • Page 257 after RESYNC. If this parameter is specified for Continuous Access Asynchronous for Mainframe or Continuous Access Journal for Mainframe, the data synchronization method during the suspension will be the same as that used when the FLUSH parameter is specified. REVERSE Applies to Continuous Access Synchronous for Mainframe, Continuous Access Asynchronous for Mainframe, and Continuous Access Journal for Mainframe.
  • Page 258 The pairs to be manipulated by the command depend on their volume status. For more information, see the table describing the copy pair statuses that are subject to the command, in the HP StorageWorks P9000 for Business Continuity Manager Software Users Guide. NOTE: If more than one of the ATTIME, CANCEL, DRAIN, PURGE, FLUSH, QUICK, FORWARD, and REVERSE parameters is specified, the last specified parameter takes effect.
  • Page 259: Ykwatch Command

    Table 138 YKSUSPND Command Return Code List Return Code Meaning -4095 to -4040 The command terminated abnormally, possibly because the user SVC routine has not been included properly. The module cannot be loaded. Possible causes are as follows: The library dataset has not been linked. The module is protected by the RACF program control function.
  • Page 260 This command monitors the copy pair status transition for a specified copy group and sends a notification message when all the copy pairs have been placed in a specified status. Parameters PREFIX(prefix) ~ <PREFIX string of 25 or fewer characters> Specify the prefix of the configuration file name.
  • Page 261: Ykwatch Command

    OPERATOR(route-code) ~ <numeric characters> ((0 to 127)) Transmits the messages issued by the YKWATCH command to the operator with the address code specified in the parameter. CN({console-id|console-name INTERNAL}) ~ <numeric characters> ((0 to 99)) (for a console ID) or <console name string from 2 to 8 characters> (for a console name) Specifies in which of the operator console queues the messages issued by the YKWATCH command are placed.
  • Page 262: Ykwtomsg Command

    Table 139 YKWATCH Command Return Code List (continued) Return Code Meaning Terminating due to invalid processing. Terminating due to invalid parameters. YKWTOMSG Command Format When outputting a single line message YKWTOMSG(type,text) When outputting a multiline message YKWTOMSG(type, text-1, text-2 [,text-3] [,text-4] [,text-5] [,text-6]...
  • Page 263: Cli Command Coding Examples

    text-2 ~ <string of 70 or fewer characters> Use this parameter when you want to output a multi-line message. For this parameter, specify the second line of the text that you want to output. text-3 through text- 1 0 ~ <string of 70 or fewer characters> Use these parameters when you want to output more than two lines for a message.
  • Page 264: Ykdemo01

    Table 141 List of Sample Scripts (continued) Sample script name Overview Uses the following CLI commands to demonstrate how to create and delete YKDEMO03 logical paths and route lists, and how to reference status information, based on the configuration file for the path set and route list: YKLOAD YKBLDCMD YKBLDPTH...
  • Page 265 /* All Rights Reserved. Copyright (C) 2007, 2010, 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 group. This sample script uses the following CLI commands. - YKLOAD - YKMAKE - YKSUSPND...
  • Page 266 address TSO "YKQUERY STEM(DEMO_INFO.) MSG(DEMO_MSG.)"; * The return code must be checked. Notice that the return code is * checked to see if it is bigger than 8, not 0. In YKQUERY, the * return code 8 indicates that one or more volumes in the given * copy group are offline, which is not necessarily a bad situation.
  • Page 267 then do call printErrorMessage; exit; end; else nop; * Use YKEWAIT to wait until "MYTCS" is fully established. * The value for TIMEOUT is arbitrary. In this example, 30 minutes is * used just for instance. address TSO "YKEWAIT STEM(DEMO_INFO.) MSG(DEMO_MSG.) GOTO(DUPLEX)", "TIMEOUT(30)";...
  • Page 268 call printErrorMessage; exit; end; else nop; call printCopyGroupStatus; * Resynchronize all suspended copy pairs in MYTCS copy group. * Use SELECT(COND) parameter to let YKRESYNC skip copy pairs which * are already DUPLEX. * Just like YKSUSPND, it is recommended to explicitly specify * FORWARD/REVERSE parameter.
  • Page 269: Ykdemo02

    nop; * Wait until all copy pairs in TCS copy group get fully dissolved. address TSO "YKEWAIT STEM(DEMO_INFO.) MSG(DEMO_MSG.) GOTO(SIMPLEX)", "TIMEOUT(30)"; * Check to see if the return code is 0 or not. if rc /= 0 then do call printErrorMessage; exit;...
  • Page 270 /**********************************************************************/ /* Sample script begins. */ say "#-- BEGIN YKDEMO02."; address TSO "YKENV" * The following piece of code attempts to detect completion of * the copy process of FlashCopy pair by using YKFCSTAT. * If the copy process has not completed yet, the value of "STATE0" * remains non-zero, so it waits for certain amount of time (in this * example, 1 minute) and re-attempt to detect completion of the * copy process.
  • Page 271: Ykdemo03

    say "#-- END YKDEMO02."; 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 = "...
  • Page 272 * YKLOAD should be called to load the information about a pathset * and a route list into the REXX environment. call "YKLOAD" "STEM(DEMO_INFO.) PREFIX(BCM.DEMO) PATH(DEMOPATH)", "DAD(PRIM) ROUTE(DEMORLST) MSG(DEMO_MSG.)"; * Make sure that YKLOAD completed successfully. If YKLOAD failed, * the return value "result" is non-zero. if result /= 0 then do call printErrorMessage;...
  • Page 273 * structure. say "-------------------------------------"; do i = 1 to DEMO_INFO.PATH.0 say "Path "i": type = " || DEMO_INFO.PATH.i.type; say "Path "i": share? = " || DEMO_INFO.PATH.i.shared; end; say "-------------------------------------"; * Build the command device in the primary storage system first. * You must specify the serial number of the storage system with * "SN"...
  • 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 "-------------------------------------";...
  • Page 275 * Please note that if the route list is available, you do not actually * have to specify CU, CCA and APID parameters. address TSO "YKDELCMD SN(#####) MSG(DEMO_MSG.) CU(##) CCA(##)", "APID(####)"; * Check the return code to see if it is 0 or not. if rc /= 0 then do call printErrorMessage;...
  • Page 276: Ykdemo04

    * 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; say "Value = "...
  • Page 277 exit; end; else nop; * As in YKDEMO01, YKEWAIT can be used to update the copy group * status information quickly. address TSO "YKEWAIT STEM(DEMO_INFO.) MSG(DEMO_MSG.) GOTO(SIMPLEX)", "TIMEOUT(0) NOINVALIDCHECK"; * Check the return code to see if it is bigger than 8. if rc >...
  • Page 278 do forever * Invoke YKCONMSG again, but this time with OP(GET) parameter * and the hander value so that IEA494I message can be * captured. dc = OUTTRAP("MyHandle."); address TSO "YKCONMSG OP(GET) HANDLE(x'"HandlerValue"')"; dc = OUTTRAP("OFF"); * Check the return code of YKCONMSG to see if it is 1 or not. * YKCONMSG with OP(GET) parameter returns the return code 1 * if it could capture the IEA494I message successfully.
  • Page 279 * Resume the host I/O. address TSO "YKRUN STEM(DEMO_INFO.) MSG(DEMO_MSG.)"; * Wait for the TC-Sync copy group to become fully * suspended. address TSO "YKEWAIT STEM(DEMO_INFO.) MSG(DEMO_MSG.)", "GOTO(SUSPEND) TIMEOUT(30)"; /* Check if the TC-Sync copy group is suspended. if rc /= 0 then do call printErrorMessage;...
  • Page 280: Ykdemo05

    * Check the return code to see if it is 6 or not. Note that the return * code for YKCONMSG with OP(CLOSE) is 6 for successful completion. if rc /= 6 then do say "YKCONMSG OP(CLOSE) failed."; exit; end; else nop;...
  • Page 281 "DAD(PRIM) MSG(DEMO_MSG.) ROUTE(DEMORLST)"; * Check the return code of YKLOAD to see if it is 0 or not. if result /= 0 then do call printErrorMessage; exit; end; else nop; * Call YKQUERY to refresh the information in the Copy Group structure * of MYTCA copy group before calling YKMAKE.
  • Page 282 end; else nop; * Call YKSTATS to obtain performance information of MYTCA. * Note that the Usage Monitor must be running for YKSTATS to obtain * performance information. address TSO "YKSTATS STEM(DEMO_INFO.) MSG(DEMO_MSG.)"; * Check the return code to see if it is 0 or not. if rc /= 0 then do call printErrorMessage;...
  • Page 283: Ykdemo06

    say "#-- END YKDEMO05."; 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 = "...
  • Page 284 address TSO "YKQUERY STEM(DEMO_INFO.) MSG(DEMO_MSG.)"; * Check the return code to see if it is bigger than 8. if rc > 8 then do call printErrorMessage; exit; end; else nop; * Establish all copy pairs in MYTCS copy group into DUPLEX. This is * for demonstration purpose only.
  • Page 285: Ykdemo07

    printErrorMessage: procedure expose DEMO_MSG. do x = 1 to DEMO_MSG.0 say "Severity = " || DEMO_MSG.x.Severity; say "Text = " || DEMO_MSG.x.Text; say "Value = " || DEMO_MSG.x.Value; end; return 0; YKDEMO07 /* REXX /**********************************************************************/ /* All Rights Reserved. Copyright (C) 2007, 2010, Hitachi, Ltd. /**********************************************************************/ /* YKDEMO07 - A sample demonstration script that illustrates how to use the Business Continuity Manager's YKRECVER command.
  • Page 286 end; else nop; * Establish all copy pairs in MYTCS copy group into DUPLEX. This is * for demonstration purpose only. In reality you may already have a * copy group up and running. address TSO "YKMAKE STEM(DEMO_INFO.) MSG(DEMO_MSG.) SELECT(COND)"; * Check the return code to see if it is 0 or not.
  • Page 287: Ykdemo08

    * 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; say "Value = "...
  • Page 288 call printErrorMessage exit else call "YKLOAD" "STEM(DEMO_INFO.MYUR1.) PREFIX(BCM.DEMO) GROUP(MYUR1)", "DAD(PRIM) MSG(DEMO_MSG.)" * Check the return code of YKLOAD. if result /= 0 then do call printErrorMessage exit else call "YKLOAD" "STEM(DEMO_INFO.MYUR2.) PREFIX(BCM.DEMO) GROUP(MYUR2)", "DAD(PRIM) MSG(DEMO_MSG.)" * Check the return code of YKLOAD. if result /= 0 then do call printErrorMessage...
  • Page 289 if rc /= 0 then do call printErrorMessage exit else * Check the status of MYUR2 to confirm the ready status for operations * in 2DC configuration with HyperSwap and UR. address TSO "YKEWAIT STEM(DEMO_INFO.MYUR2.) MSG(DEMO_MSG.)", "GOTO(HOLD) TIMEOUT(0) NOINVALIDCHECK" * Check the return code of YKEWAIT. if rc /= 0 then do call printErrorMessage...
  • Page 290 * interface. The script will exit the loop after either 120 seconds has * elapsed or the IOSHM0414I message is successfully captured. * IOSHM0414I message is successfully obtained. do forever * Invoke YKCONMSG again, but this time with the OP(GET) parameter * and the hander value so that the IOSHM0414I message can be * captured.
  • Page 291 else * Suspend the MYUR1 copy pair to change the status of * MYUR1 into one where a DeltaResync can be performed. address TSO "YKSUSPND STEM(DEMO_INFO.MYUR1.)", " MSG(DEMO_MSG.) FLUSH" * Confirm that the status of MYUR1 copy pair is in a * status where a DeltaResync can be performed.
  • Page 292 * Check the return code of YKEWAIT. if rc /= 0 then do call printErrorMessage leave /* Exit the loop. */ else * Execute a DeltaResync with the MYUR2 copy pair to * change the status of MYUR1 to HOLD, and * to change the status of MYUR2 to DUPLEX.
  • Page 293: Ykdemo09

    * Close the EMCS console interface that was opened by the previous * YKCONMSG OP(OPEN) call. Note that the return code for YKCONMSG with * the OP(CLOSE) parameter is 6 if it completed successfully. address TSO "YKCONMSG OP(CLOSE) HANDLE(x'"HandlerValue"')" * Check the return code to see if it is 6 or not. Note that the return * code for YKCONMSG with the OP(CLOSE) parameter is 6 for * successful completion.
  • Page 294 The details for this sample script are as follows: *) When the cause of a HyperSwap is a DKC failure, execute this */ sample script twice. When execution for a DKC maintenance or second execution for */ 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.
  • Page 295 exit else * Check the status of the MYUR1 copy pair * to find the cause of a HyperSwap. address TSO "YKEWAIT STEM(DEMO_INFO.MYUR1.) MSG(DEMO_MSG.)", "GOTO(HOLD) TIMEOUT(0) NOINVALIDCHECK" * Check the return code of YKEWAIT. if (rc < 0)|(rc > 8) then do call printErrorMessage exit...
  • Page 296 * Confirm that the status of the MYTCHS copy pair * has been recovered. address TSO "YKEWAIT STEM(DEMO_INFO.MYTCHS.) MSG(DEMO_MSG.)", "GOTO(DUPLEX) TIMEOUT(30)" * Check the return code of YKEWAIT. if rc /= 0 then do call printErrorMessage exit else * Execute Make(HOLD) on the MYUR1 to change * the status of MYUR1 to one where a DeltaResync * can be performed.
  • Page 297 "from planned outage configuration." * Confirm that the status of the MYTCHS copy pair is one where a * DeltaResync can be performed. address TSO "YKEWAIT STEM(DEMO_INFO.MYTCHS.) MSG(DEMO_MSG.)", "GOTO(SWAPPING) TIMEOUT(10)" * Check the return code of YKEWAIT. if rc /= 0 then do call printErrorMessage exit...
  • Page 298: Ykdemo10

    * the status of MYUR2 to HOLD. address TSO "YKRESYNC STEM(DEMO_INFO.MYUR1.) MSG(DEMO_MSG.)", "DELTAJNL" * Check the return code of YKRESYNC. if rc /= 0 then do call printErrorMessage exit else * Wait for completion of copying from the primary site to * the remote site.
  • Page 299: Ykdemo1S

    /* Summary of the procedure is following steps. 1) Issuing YKQRYDEV to retrieve the volume information. 2) Depending on result of YKQRYDEV, either USR000I or USR001E message will be written to MCS console by YKWTOMSG. If the command is terminated successfully, the script writes */ USR000I message with some command device related attributes.
  • Page 300: Ykdemo1 1

    //********************************************************************* //YKDEMO1S EXEC PGM=IKJEFT01,TIME=1440,REGION=4096K, PARM='YKDEMO10 DEVN(&DEVN)' //SYSTSPRT DD SYSOUT=* //SYSTSIN DD DUMMY //SYSABEND DD SYSOUT=* //SYSEXEC DD DSN=HDSYK.Vnnnnnn.HDSYSAMT,DISP=SHR Samplib PEND NOTE: The nnnnnn portion of Vnnnnnn in the sample-cataloged procedure, which differs depending on the version. YKDEMO1 1 /* REXX /**********************************************************************/ All Rights Reserved.
  • Page 301 Say '1) Host ID = ' HostID Say '2) License info DSN prefix = ' LicDSN Say '3) BCM log output method = ' BCMLog Say '4) CLI log output settings = ' CLILog Exit save_retc Command details 301...
  • Page 302: Ykdemo12

    YKDEMO12 302 CLI Commands...
  • Page 303 /* REXX /**********************************************************************/ All 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, deletes them, and then re-creates them.
  • Page 304 * If the status of pair is CONSLOST, execute recovering process. If DEMO_INFO.CopyGroup.1.ConslostCt > 0 Then Do i = 1 To DEMO_INFO.CopyGroup.1.Pair.0 If DEMO_INFO.CopyGroup.1.Pair.i.State == "CONSLOST" Then * Delete the CONSLOST pair in MYTCS. P_DEVN = DEMO_INFO.CopyGroup.1.Pair.i.Pri.Devn S_DEVN = DEMO_INFO.CopyGroup.1.Pair.i.Sec.Devn Address TSO "YKDELETE STEM(DEMO_INFO.) MSG(DEMO_MSG.)", "DEVN("P_DEVN","S_DEVN")"...
  • Page 305 If rc /= 0 Then Call PrintErrorMessage Exit Else Else Else Say "#-- 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 = "...
  • Page 306: Data Objects

    3 Data Objects This chapter describes the dataset formats and required disk capacity for the configuration file, the XML document type definitions, and REXX variable structures. “Saving and Converting Objects” (page 306) “Dataset Formats and Required Disk Capacity for the Configuration File” (page 307) “XML Document Type Definitions”...
  • Page 307: Dataset Formats And Required Disk Capacity For The Configuration File

    NOTE: In the scope of the copy group, the prefix of the file names should be same. Dataset Formats and Required Disk Capacity for the Configuration File This section describes the dataset formats and required disk capacity for the configuration file. Table 142 (page 307) describes the meaning of the symbols used in the formulas of this section.
  • Page 308: Xml Document Type Definitions

    Table 144 Required Disk Space for the Configuration File Type of the configuration file Size (bytes) Copy group definition file + A x 710 + B x 230 Disk configuration definition file + E x 180 Route list definition file + F x 90 + G x 90 Command device definition file...
  • Page 309 NOTE: If a file exists in an ASCII character coding, the header must be rewritten as shown: <?xml version="1.0" encoding="UTF-8"?> The element names, attribute names, and attribute values are case-sensitive during configuration file read processing in Business Continuity Manager. API Information All XML data objects in Business Continuity Manager should be within the APIInfo elements.
  • Page 310 The following table gives the meanings of the attributes of the PairState elements. Attribute name Meaning Copy pair status State C/T delta value CTDelta Copy pair matching rate MatchingPerCent Whether direction is reverse from Secondary to Primary Reversed Copy Pair <!ELEMENT CopyPair(PairState,DiskDevice,DiskDevice)>...
  • Page 311 Attribute name Meaning C/T group timer type for Forward F_Timer_Type C/T group timer type for Reverse R_Timer_Type BC Option <!ELEMENT BC_Options(EMPTY)> <!ATTLIST BC_Options GroupID CDATA#IMPLIED PresetMode (NORMAL|UR)#IMPLIED AttimeSplitMode (STEADY|QUICK)#IMPLIED > The following table gives the meanings of the attributes of the BC_Options elements. Attribute name Meaning Consistency group ID...
  • Page 312 The following table gives the meanings of the attributes of the Related elements. Attribute name Meaning Related ID CopyGroupID Related type Type DKCState <!ELEMENT DKCState(EMPTY)> <!ATTLIST DKCState SerialNum CDATA#REQUIRED WPR_All CDATA#REQUIRED RSF_All CDATA#REQUIRED RSF_CT CDATA#REQUIRED JNL_Meta CDATA#REQUIRED JNL_Data CDATA#REQUIRED JNL_Trfr CDATA#REQUIRED JNL_Cache_Capacity CDATA#REQUIRED...
  • Page 313 Attribute name Meaning Copy pending timer Copy_Pending_Timer Data transmission speed between MCU-RCU (Kbps) MCU_TO_RCU_KBPS Copy Group <!ELEMENT CopyGroup((TC_Options|TCA_Options|BC_Options|UR_Options), Related?,RelatedDKCState*,CopyPair*,ExctgDefDKC?)> <!ATTLIST CopyGroup ID#REQUIRED PrimaryDADID ID#REQUIRED SecondaryDADID ID#REQUIRED SimplexCt CDATA#IMPLIED DuplexCt CDATA#IMPLIED PendingCt CDATA#IMPLIED RevresyncCt CDATA#IMPLIED SuspendOpCt CDATA#IMPLIED SuspendVSCt CDATA#IMPLIED SuspendCuCt CDATA#IMPLIED SuspendErCt CDATA#IMPLIED SwappingCt...
  • Page 314 Attribute name Meaning Count of copy pairs with reverse direction from Secondary to Primary ReversedCt HOLD count HoldCt HOLDER count HoldErCt CHKJNL count ChkJnlCt HOLDTRNS count HoldTrnsCt NODELTA count NoDeltaCt ConslostCt CONSLOST count Current time in local time CurrentTime Copy pair matching rate MatchingPercent Copy pace InitPace...
  • Page 315 Attribute name Meaning PENDING count PendingCt DUPLEX count DuplexCt TRANS count TransitionCt SUSPCU count SuspendCuCt SUSPOP count SuspendOpCt SUSPVS count SuspendVSCt SUSPER count SuspendErCt INVALID count InvalidCt SWAPPING count SwappingCt REVRSY count RevresyncCt Count of copy pairs with reverse direction from Secondary to Primary ReversedCt HOLD count HoldCt...
  • Page 316 Attribute name Meaning Supervisor DKC serial number during a forward operation FwdSuper_SerialNum Supervisor DKC serial number during a reverse operation RevSuper_SerialNum ExctgDefDKC <!ELEMENT ExctgDefDKC(EX_DefDKC)> EX_DefDKC <!ELEMENT EX_DefDKC(EMPTY)> <!ATTLIST EX_DefDKC FwdModel CDATA#IMPLIED RevModel CDATA#IMPLIED FwdSerialNum CDATA#IMPLIED RevSerialNum CDATA#IMPLIED FwdArbCmdNo CDATA#IMPLIED RevArbCmdNo CDATA#IMPLIED >...
  • Page 317 The following table gives the meanings of the attributes of the SoftwareKeys elements. Attribute name Meaning TC key BC key TCA key UR key Logical Path Paths(CUPath*, DKCPath*)> <!ATTLIST Paths CDATA#REQUIRED > <!ELEMENT CUPath(Ports*)> <!ATTLIST CUPath Shared (Y|N)#IMPLIED PriModel CDATA#IMPLIED SecModel CDATA#IMPLIED PriIFType...
  • Page 318 Attribute name Meaning Secondary storage system model SecModel Primary storage system interface version PriIFType Secondary storage system interface version SecIFType Primary storage system serial number PriSerialNum Secondary storage system serial number SecSerialNum Primary SSID PriSSID Secondary SSID SSID SecSSID Primary CU number PriCUNum Secondary CU number SecCUNum...
  • Page 319 Status CDATA#IMPLIED > The following table gives the meanings of the attributes of the Ports elements. Attribute name Meaning Direction of defined physical path Direction Channel type of a physical path Type The following table gives the meanings of the attributes of the Port elements. Attribute name Meaning The initiator port number of the primary site of the logical path...
  • Page 320 Host-Discovered Array <!ELEMENT HostDiscoveredArray (SoftwareKeys, DKCPaths?, HostAddressedDisk*)> <!ATTLIST HostDiscoveredArray Description CDATA#REQUIRED DADID ID#REQUIRED <<NGDADIDEnable NGDADIDEnable SerialNum CDATA#REQUIRED Model (7700E|9900|9900V|USP|USPV|VSP)#REQUIRED Microcode CDATA#REQUIRED IFType CDATA#REQUIRED PhysicalSerialNum CDATA#IMPLIED > The following table gives the meanings of the attributes of the HostDiscoveredArray elements. Attribute name Meaning Descriptions added by the user Description...
  • Page 321: Configuration File Examples

    RouteList <!ELEMENT RouteList(Route*)> <!ATTLIST RouteList ID#REQUIRED > The following table gives the meaning of the attribute of the RouteList elements. Attribute name Meaning Route list ID Configuration File Examples This section provides examples for each of the following configuration file types: Copy group definition file Disk configuration definition file Route list definition file...
  • Page 322: Example Contents Of Disk Configuration Definition File

    <CopyPair> <PairState Reversed="0"/> <DiskDevice SerialNum="14011" CUNum="00" SSID="1350" CCA="18"/> <DiskDevice SerialNum="14012" CUNum="00" SSID="1340" CCA="18"/> </CopyPair> <ExctgDefDKC> <EX_DefDKC FwdModel="USPV" RevModel="USPV" FwdSerialNum="14012" RevSerialNum="14011" FwdArbCmdNo="1112" RevArbCmdNo="2222"/> </ExctgDefDKC> </CopyGroup> </CopyGroupContainer> </APIInfo> Example Contents of Disk Configuration Definition File The example of the contents of the disk configuration definition file, prefix.DSK.SNnnnnn.dad-id, is shown: ?xml version="1.0"...
  • Page 323: Example Contents Of Path Set Definition File

    </CDEVGRP> </APIInfo> Example Contents of Path Set Definition File An example of the contents of the path set definition file, prefix.PATH.path-set-id, is shown: <?xml version="1.0" encoding="ebcdic-cp-us"?> <APIInfo Level="6.0.1"> <Paths ID="PATHSET.ID"> <CUPath Shared="N" PriSerialNum="11111" PriModel="9900V" PriIFType="0405" PriSSID="1234" PriCUNum="00" PriCCA="00" SecSerialNum="22222" SecModel="9900V" PriIFType="0405" SecSSID="5678"...
  • 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-specified-in-STEM-parameter.
  • Page 325 Table 146 Copy Group Structure (continued) REXX variables Description Proxy C/T delta value for the entire copy CTDelta group Copy pair matching rate (average value of MatchingPerCent CopyGroup.n.MatchingPerCent) Minimum primary interface version value PriIFMin (minimum value of IFType in the Host-Discovered Array structure of the storage system at the primary site) Primary CA key (minimum value of Key.TC...
  • Page 326 Table 146 Copy Group Structure (continued) REXX variables Description EXCTG ID (0 to 3) ExctgID Supervisor DKC model Super_Model XP10000 or XP12000 XP20000 or XP24000 P9500 Supervisor DKC serial number Super_SerialNum Number of copy pairs (sum value of Pair CopyGroup.n.Pair.0) Number of copy groups (number of n) CopyGroup Copy group ID...
  • Page 327 Table 146 Copy Group Structure (continued) REXX variables Description Copy type CopyType Copy pace InitPace SLOW NORMAL Protect mode ProtectMode When Y, makes SCP if SUSPER. CA_FreezeScpMode When Y, the timestamp transfer mode is CA_TimeStampMode enabled. Consistency group ID or master journal CTGroupID group ID Restore journal group ID...
  • Page 328 Table 146 Copy Group Structure (continued) REXX variables Description CAJ Consistency time mode CAJ_CTTimeMode JOURNAL VOLUME ASIS Related ID Related_ID Related type Related_Type Whether to use the CAJ ATTIME suspend PresetMode function NORMAL: Do not use CAJ: Use AttimeSplitMode Suspend mode used by the CAJ ATTIME suspend function.
  • Page 329 Table 146 Copy Group Structure (continued) REXX variables Description Model Model XP10000 or XP12000 XP20000 or XP24000 P9500 Serial number SerialNum Arbitration command device ArbCmdNo 16, 17 Arbitration count time ArbCTTime (yyyymmdd hh:mm:ss.nnnnnn) Journal group registration status JNLGValid 0: not registered in EXCTG (when an error occurs) 1: EXCTG registration complete 2: EXCTG registration in progress...
  • Page 330 Table 146 Copy Group Structure (continued) REXX variables Description Data % used rate in master journal volume. Pri_JNL_Data The percentage used of the Journal Data capacity available in the Journal Volume(s) registered to M-JNL. Metadata % used rate in restore journal Sec_JNL_Meta volume.
  • Page 331 Table 146 Copy Group Structure (continued) REXX variables Description Primary storage system Model Model XP256 XP48 or XP512 XP128 or XP1024 XP10000 or XP12000 XP20000 or XP24000 P9500 Secondary device number Devn Secondary storage system serial number SerialNum Secondary CU number CUNum Secondary SSID SSID...
  • Page 332: Host-Discovered Array Index Structure

    Information can be acquired only when the EXCTG function is used during a reverse operation. For supervisor DKC, the value is null. The value is null when information cannot be acquired. Displayed in GMT. The details for the journal status are shown in the following table: Cause code Details (hexadecimal)
  • Page 333: Host-Discovered Array Structure

    NOTE: You can use the YKDROP command to drop the REXX variables in any Host-Discovered Array Index structure that was loaded by using the YKLOAD command. Table 147 (page 333) shows the Host-Discovered Array Index structure. The prefix for the name of the Host-Discovered Array Index structure is one of the following: When the YKLOAD command is used for creating the structure: HCC.HDA.
  • Page 334 Table 148 (page 334) shows the Host-Discovered Array structure. The prefix for the name of the Host-Discovered Array structure is one of the following: When the YKLOAD command is used for creating the structure: stem-name-specified-in-STEM-parameter and dad-id When the YKSCAN command is used for creating the structure: stem-name-specified-in-opSTEM-parameter Each REXX variable is preceded by a period (.).
  • Page 335: Route List Structure

    Information for the physical DKC serial number can be obtained when Business Continuity Manager 5.2 or later scans a device. Information for the logical DKC serial number can be obtained when Business Continuity Manager 5.2 or later scans a device. When Business Continuity Manager scans a device that exists in either of the following models, a value of 0 is set: HP StorageWorks XP12000/XP10000 Disk Array HP StorageWorks XP24000/XP20000 Disk Array...
  • Page 336: Message Structure

    Table 149 Route List Structure (continued) REXX variables Description Storage system interface version IFTYPE Device number of the command device in the storage system CDEV Devn Volume serial number of command device in DKC Volser CU number of the command device in the storage system CUNum SSID of the command device in the storage system SSID...
  • Page 337 Table 151 Device Information Structure (continued) REXX variables Description Status of host connection HostStatus ONLINE OFFLINE Storage system Model Model XP256 XP48 or XP512 XP128 or XP1024 XP10000 or XP12000 XP20000 or XP24000 P9500 DKCMAIN microcode version Microcode Interface version IFType information for installed program product PPInfo...
  • Page 338 Table 151 Device Information Structure (continued) REXX variables Description Status of CA copy pair State PENDING (01) DUPLEX (02) SUSPOP (03) SUSPOP (04) SWAPPING (04) SUSPOP (05) SUSPCU (06) SUSPER (07) SUSPCU (08) SUSPER (09) SUSPER (50) TRANS (60) TRANS (61) SUSPER (62) SUSPER (A0) Data inconsistency in the Cnt Ac-S copy pair...
  • Page 339 Table 151 Device Information Structure (continued) REXX variables Description Copy mode Mode Sync Async Unit of difference management Protect mode ProtectMode PROTECT PERMIT Flow control FlowControl 2, 3, 1 1 Freeze SCP FreezeSCPMode Copy pace InitPace SLOW NORMAL 4, 5 Consistency group ID C/T group timer type TimerType...
  • Page 340 Table 151 Device Information Structure (continued) REXX variables Description ATTIME suspend status Status Notset: The ATTIME suspend time is not set. PRESET: The ATTIME suspend time is set, but suspend has not been performed. SUSPEND (TIMESTAMP): Suspend was performed because the ATTIME suspend time elapsed.
  • Page 341 Table 151 Device Information Structure (continued) REXX variables Description Consistency group ID Existence of ATTIME suspend information (Valid) Info Generation ID GenID ATTIME suspend time (yyyymmdd Time hh:mm:ss.nnnnnn) Tout Timeout value (minutes) ATTIME status Status Notset: The ATTIME suspend time is not set. PRESET: The ATTIME suspend time is set, but suspend has not been performed.
  • Page 342 Table 151 Device Information Structure (continued) REXX variables Description SplitMode Suspend mode used by the CAJ ATTIME suspend function. (This indicates whether secondary volumes transitioning to the suspend status can be accessed or updated.) STEADY: Volumes can be accessed or updated after the copy operation is completed.
  • Page 343 Table 151 Device Information Structure (continued) REXX variables Description Existence of CAJ copy pair State PENDING (01) DUPLEX (02) SUSPOP (03) SUSPOP (04) SUSPOP (05) SUSPCU (06) SUSPER (07) SUSPCU (08) SUSPER (09) SUSPER (50) TRANS (60) TRANS (61) SUSPER (62) HOLD (70) HOLDER (71) HOLDTRNS (72)
  • Page 344 Table 151 Device Information Structure (continued) REXX variables Description Storage system serial number Serialnum CU number CUNum SSID SSID Storage system serial number Serialnum CU number CUNum Master journal number Restore journal number subID C/T group timer type TimerType SYSTEM LOCAL NONE C/T status...
  • Page 345 Table 151 Device Information Structure (continued) REXX variables Description Status of physical path Status NO PATH ESTABLISHED INIT FAILED TIME OUT NO RESOURCES AT PRI NO RESOURCES AT SEC SERIAL# MISMATCH CONFIG ERROR Initiator port number (for ESCON, link address) Pri.Port Target port number (for ESCON, link address) Sec.Port...
  • Page 346: Path Set Structure

    Information can be acquired for the following models: HP StorageWorks XP12000/XP10000 Disk Array HP StorageWorks XP24000/XP20000 Disk Array HP StorageWorks P9500 Disk Array Information can be acquired for CA. Information can be acquired for TCA. Information can be acquired for CA with consistency group ID specified. Displayed in GMT.
  • Page 347 Table 152 Path Set Structure (continued) REXX variables Description Type of primary storage system Model XP48 or XP512 XP128 or XP1024 XP10000 or XP12000 XP20000 or XP24000 P9500 Interface version of primary storage system IFType Primary path ID PathID Primary SSID SSID Primary CU number CUNum...
  • Page 348: Flashcopy Information Structure

    Table 152 Path Set Structure (continued) REXX variables Description The number of physical paths from the primary site to the Setting secondary site set in the storage system (0 to 8) The number of defined physical paths from the secondary site to the primary site (0 to 8) Status of a logical path Status...
  • Page 349: Rexx Variables Updated By Ykquery And Ykewait Commands

    Table 153 FlashCopy Information Structure (continued) REXX variables Description Hardware information State3 Hardware information State4 Hardware information State5 Existence of a failure suspension during FlashCopy: State6 0: No 1: Yes Existence of an incremental FlashCopy relationship: State7 0: No 1: Yes When the information is acquired, Valid is stored.
  • Page 350 Table 154 REXX Variables Updated by YKQUERY and YKEWAIT (continued) REXX variables YKQUERY YKEWAIT DEVN DEVN not DEVN DEVN not specified specified specified specified CopyGroup SimplexCt DuplexCt InvalidCt PendingCt SuspendOpCt SuspendCuCt SuspendVSCt SuspendErCt TransitionCt ReversedCt SwappingCt RevrsyncCt HoldCt HoldErCt HoldTrnsCt NoDeltaCt ConslostCt CurrentTime...
  • Page 351: Rexx Variables Updated By Ykquery Command With The To Parameter Specified

    Table 154 REXX Variables Updated by YKQUERY and YKEWAIT (continued) REXX variables YKQUERY YKEWAIT DEVN DEVN not DEVN DEVN not specified specified specified specified other- pairs State CTDelta MatchingPerCent Reversed CTTime Diagnosis Legend: Y: Updated. N: Not updated. --: Not 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...
  • Page 352 Table 155 REXX Variables Updated by YKQUERY Command with the TO Parameter Specified (continued) REXX variables Copy direction: Copy direction: Reverse Forward PRIMARY SECONDARY PRIMARY SECONDARY specified specified specified specified ConslostCt CTDelta 2, 5 MatchingPerCent CopyGroup SimplexCt DuplexCt InvalidCt PendingCt SuspendOpCt SuspendCuCt SuspendVSCt...
  • Page 353: Rexx Variables Updated By The Ykewait Command With The To Parameter Specified

    Table 155 REXX Variables Updated by YKQUERY Command with the TO Parameter Specified (continued) REXX variables Copy direction: Copy direction: Reverse Forward PRIMARY SECONDARY PRIMARY SECONDARY specified specified specified specified JNLState ErrorCode Pair State CTDelta 2, 5 MatchingPerCent Reversed CTTime 6, 7 6, 7 Diagnosis...
  • Page 354 Table 156 REXX Variables Updated by the YKEWAIT Command with the TO Parameter Specified (continued) REXX variables Copy direction: Forward Copy direction: Reverse PRIMARY SECONDARY PRIMARY SECONDARY specified specified specified specified SuspendCuCt SuspendVSCt SwappingCt ReversedCt SuspendErCt InvalidCt RevrsyncCt HoldCt HoldErCt HoldTrnsCt NoDeltaCt ConslostCt...
  • Page 355: Csv Files Used By The Copy Group Definition File Generation Function

    Table 156 REXX Variables Updated by the YKEWAIT Command with the TO Parameter Specified (continued) REXX variables Copy direction: Forward Copy direction: Reverse PRIMARY SECONDARY PRIMARY SECONDARY specified specified specified specified State Reversed Because information cannot be acquired, 0 is set. Legend: Y: Updated F: Updated to a fixed value...
  • Page 356: Specification Format For A Pair Information Csv File

    CSV files used by the YKIMPORT 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 group definition file.
  • Page 357 Item name Value to be specified Data type Length (characters) Consistency group ID Hexadecimal for other than 1 - 2 CTID CAJ: Specify in the range from 00 to 7F For CAJ: Specify in the range from 00 to FF. Subconsistency group ID Hexadecimal 1 - 2...
  • Page 358: Specification Format For An Exctg Information Csv File

    If there is no volume at a consecutive address, that address is skipped. In this example, if there is no volume whose device number is 7312, then the volumes with device numbers 731 1, 7313, and 7314 are defined for the P-VOL. Specification format for an EXCTG Information CSV File Specify an EXCTG information CSV file in the following format: PSN,SSN,CTID,SubCTID,FEXCTG,FSpDKC,FarbCDEV,REXCTG,RSpDKC,RarbCDEV...
  • Page 359: Examples Of Csv Files

    NOTE: You must specify either the supervisor DKC or the arbitration command device on the first line. They cannot both be specified on the same line. Make sure that only one copy direction (forward direction only, reverse direction only, or forward and reverse directions) is used in the file.
  • Page 360: Calling Hp Technical Support

    4x4 Configuration Defined by the YKIMPORT Command” (page 359). command when the copy group has the configuration. The first line is always a header line (comment). Pair information CSV file //*PDEVN,PSN,PCU,PCCA,SDEVN,SSN,SCU,SCCA,CTID,SubCTID,Number-Of-Pairs F101,14002,01,01,A101,14001,01,01,01,02,1 F201,64501,01,01,A201,64050,01,01,03,04,1 EXCTG information CSV file //*PSN,SSN,CTID,SubCTID,FEXCTG,FSpDKC,FarbCDEV,REXCTG,RSpDKC,RarbCDEV 14002,14001,01,02,1,S, , , , 64051,64050,03,04,1, ,002F, , , Calling HP Technical Support If you need to call HP technical support, be sure to provide as much information about the problem...
  • Page 361: Bcm Monitor Parameter Files

    4 BCM Monitor Parameter Files This chapter describes the BCM Monitor Parameter Files and the YKMONOPT and YKMONCG files. “ Overview of BCM Monitor Parameter Files” (page 361) “ YKMONOPT File” (page 362) “ YKMONCG File” (page 364) Overview of BCM Monitor Parameter Files This section describes the parameter files used with BCM Monitor.
  • Page 362: Maximum Number Of Characters Per Line

    Table 161 Types of Continuation Symbols Continuation symbol Continuation handling method Minus sign (-) Except for when another continuation symbol follows this symbol, the specification is continued from the leftmost column of the next line, including any consecutive spaces. Plus sign (+) Except for when another continuation symbol follows this symbol, the specification is continued from the leftmost column of the next line, excluding any consecutive spaces.
  • Page 363 If the same parameter is specified multiple times, the last time the parameter is specified takes effect. Format [CYCLETIME=cycle-time] [WAITTIMEOUT=timeout-value] [MSGLEVEL=SYSTSPRT-message-level,console-message-level] [ONACTIONERROR={SKIPONLY|STOP|EXIT(return-code)}] Information to be set This parameter file sets the option information required for starting BCM Monitor. Parameters CYCLETIME=cycle-time ~ <numeric character>((10 to 999999))<<300>> Specifies the cycle time in seconds for monitoring the copy group status.
  • Page 364: Ykmoncg File

    The messages that are output are as follows: YK80nnZ: These are messages that are output regardless of the specified message level. However, note that some messages might be output only to SYSTSPRT or the console. YK81nnZ: These are messages with the highest level of importance. YK82nnZ: These are error messages.
  • Page 365: Structure Of The Ykmoncg File

    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...
  • Page 366: Copy Group Parameters

    NOTE: The parameters can be specified for each copy group (CGID). If a copy group parameter that is not a CGID parameter is specified more than once under a single CGID parameter, the last time the parameter is specified takes effect. You can specify more than one STATUS parameter under a single CGID parameter.
  • Page 367 Monitors the copy group. If you specify ACTIVE for more than one copy group, the first copy group that is specified will be monitored. When the status of this copy group changes to INACTIVE while BCM Monitor is running, the next copy group for which ACTIVE is specified is placed in the monitoring status. INACTIVE Does not montior the copy group.
  • Page 368: Processing For Changing To The Startup Status

    Processing depends on the status of copy pairs in the copy group. For details on the processing for changing the status to the startup status, see “Processing for Changing to the Startup Status” (page 368). NOCANCEL Does not execute the YKSUSPND command with the CANCEL parameter specified. You can specify this value only if you specified DUPLEX as the startup status.
  • Page 369 Table 164 Processing for the Specified Startup Status (continued) Specified startup status Copy pair status Processing DUPLEX All DUPLEX Does nothing. PENDING SIMPLEX Places the monitoring status of all copy groups specified in the CGID parameter SWAPPING to INACTIVE. SUSPER TRANS HOLD HOLDER...
  • Page 370 Table 164 Processing for the Specified Startup Status (continued) Specified startup status Copy pair status Processing SIMPLEX Places the monitoring status of all copy groups specified in the CGID parameter DUPLEX to INACTIVE. PENDING SWAPPING SUSPOP SUSPCU SUSPER TRANS HOLDTRNS INVALID SUSPVS REVRSY...
  • Page 371 Table 165 Combinations of Target Statuses and Actions That Can Be Specified (continued) Target status Action CONSLOST SUSPER NODELTA HOLDER SUSPCU SIMPLEX PENDING TRANS HOLDTRNS REVRSY SUSPVS SUSPOP HOLD SWAPPING DUPLEX Legend Y = This combination can be specified. N = This combination cannot be specified. Parameters target-status Specifies the status of the copy group on which the action is to be executed.
  • Page 372 Table 166 Values That Can Be Specified as Actions (continued) Specifiable value Overview Executes the YKEWAIT command. WAITFOR(copy-group-ID, {DUPLEX|SUSPEND|SIMPLEX|SUSPVS|HOLD}[,timeout-value]) Executes the YKRESYNC command. RESYNC(copy-group-ID,command-wait-time[,command-parameter]) Executes the YKSUSPND command. SUSPEND(copy-group-ID[,command-parameter]) Executes the YKDELETE command. DELETE(copy-group-ID) Executes the YKMAKE command. MAKE(copy-group-ID[,command-parameter]) Outputs the specified character string as a SENDMSG(output-message,{CONS|ERROR|STATUS|INFO}) message.
  • Page 373 reached before the specified status is obtained or if an invalid status results, the error action is executed. For details on invalid statuses, see “Invalid Status for Each Value Specifiable in the 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.
  • Page 374 Executes the YKMAKE command with the specified command parameter on the specified copy group. command-parameter ~ <up to 256 characters of command parameter string> Specifies the YKMAKE command parameters. The STEM and MSG parameters are ignored even if they are specified. For details on the specifiable parameters, see the description of parameters in “YKMAKE Command”...
  • Page 375 When there are multiple copy pair statuses in a copy group If there are multiple copy pair statuses in a copy group, one of the copy pair statuses is used as the copy group status to be monitored. If there is a copy pair with one of the high priority levels shown in the table below, that copy pair status is used for the copy group.
  • Page 376 Example 2 Example The following is an example of the STATUS parameter: STATUS=SUSPOP,ACTION=RESYNC(SICG,0,’FORWARD’); EXIT(64); NOTE: If a specified value contains a comment symbol, enclose the entire value in single quotation marks. For example, to set the value #CG1 for CGID, specify the following value: CGID=’#CG1’...
  • Page 377: Support And Other Resources

    HP StorageWorks P9000 for Business Continuity Manager Software Messages HP StorageWorks P9000 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...
  • Page 378 HP StorageWorks P9000 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- 1 762 MVS Setting Up a Sysplex, GC28- 1 779...
  • Page 379: Hp Websites

    Conventions for storage capacity values P9000 disk arrays use the following values to calculate physical storage capacity values (hard disk drives): 1 KB (kilobyte) = 1,000 bytes 1 MB (megabyte) = 1,000 bytes 1 GB (gigabyte) = 1,000...
  • Page 380 Table 168 Document conventions (continued) Convention Element Bold text Keys that are pressed Text typed into a GUI element, such as a box GUI elements that are clicked or selected, such as menu and list items, buttons, tabs, and check boxes Italic text Text emphasis Monospace text...
  • Page 381: A Example Of The Scan Results Of Pprc Copy Pairs

    A Example of the Scan Results of PPRC Copy Pairs This appendix provides an example of the scan results of PPRC copy pairs. Example of the scan results of PPRC 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 group definition file.
  • Page 382 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 message for details.
  • Page 383: B Symbols Used In Syntax Explanations

    B Symbols Used in Syntax Explanations (page 383) shows the symbols used in syntax explanations. (page 383) shows the syntax elements that are used. Table 169 Symbols Used in Syntax Explanations Example font or symbol Convention database-name This font style marks a placeholder that indicates where appropriate characters are to be entered in an actual command.
  • Page 384 Table 170 Syntax Elements (continued) Syntax element Specifiable characters Example PREFIX string A string consisting of one or more parts, joined by periods. Each part A12.B34.CDE consists of upper-case alpha-numeric characters. Note that the first character of each part must be an upper-case alphabetic character. Each part can contain from 1 to 8 characters.
  • Page 385: C Acronyms And Abbreviations

    HP StorageWorks P9000 for Business Continuity Manager Basic HP StorageWorks P9000 for Business Continuity Manager Extended CT Group Software HP StorageWorks P9000 for Bus Cont Mgr Continuous Access Journal 4x4 Ext CT Software Continuous Access Synchronous for Mainframe Continuous Access Journal for Mainframe...
  • Page 386 Table 171 Acronyms and Abbreviations (continued) P-VOL primary volume program status word R-JNL restore journal RACF resource access control facility RAID redundant array of independent disks remote control unit RECFM record format Replication Manager HP Replication Manager Software REXX restructured extended executor S-VOL secondary volume System Authorization Facility...
  • Page 387: Glossary

    Glossary APID An ID for identifying the first DAD ID of a route. The same APID value is used for the primary DKC and secondary DKC on the same route. arbitration A command device used by remote DKCs in a 4x4 configuration to communicate with each other command device for arbitration processing arbitration path...
  • Page 388 copy pair A designated relationship between a primary volume (P-VOL) and a secondary volume (S-VOL) in Business Continuity Manager. copy pair matching Rate at which pair P-VOL data matches pair S-VOL data rate copy pair status The status of a P-VOL and an S-VOL copy pair, for example SIMPLEX, DUPLEX, SUSPOP, or PENDING copy pair structure Combination of a P-VOL (primary device) and an S-VOL (secondary device), and their connection...
  • Page 389 EXCTG information A CSV file in which EXCTG information in a 4x4 configuration copy group container is described CSV file external dataset A sequential dataset for the log data output from the system logger service external volume See the HP StorageWorks XP24000/XP20000 External Storage Software User’s Guide. failback See failover .
  • Page 390 local DKC One of the two disk controllers connected to the primary host in a 2DC configuration with HyperSwap and UR. local scan A function to acquire disk configuration information about the volumes on the local disk controller that are recognized by the operating system (the Gen'ed volume). log dataset A dataset which the log is written to log level...
  • Page 391 3DC Multi-Target A configuration to perform remote copying with a nearby local site and a distant remote site, in configuration which TCs and URs are applied from the primary site to the local site, and from the primary site to the remote site 4x4 configuration A configuration in which both the primary and secondary sites consist of multiple disk controllers and remote copy is performed to preserve consistency in those multiple disk controllers.
  • Page 392 remote scan A function to acquire disk configuration information about the volumes on a disk controller that has no channel connection to the host. REPORT command An operator command used to display the information about copy groups monitored by BCM Monitor.
  • Page 393 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.
  • Page 394: Index

    Index Command Control Address (CCA) Selection List panel, Command Device Selection List panel, Add APID panel, Command Device Status panel Add Copy Group Panel, for command device, Add Path Set panel, for command device but not a pair, Add Remote Route Entry panel, for pair, Add Route Entry panel, 49, common displays among panels,...
  • Page 395 Copy Group Selection List panel, path set definition file, Copy Group Status Summary panel, route list definition file, copy group structure, example of scan result copy pace, PPRC copy pair, CU parameter Exception Message Panel, YKDELCMD command, executing YKQRYDEV command, YKBLDCMD command, CU Selection List for Remote Storage Array panel, YKDELCMD,...
  • Page 396 format of command explanation, FORWARD Parameter Main Menu panel, YKMAKE command, Manage Copy Groups panel, 1 15 FORWARD parameter Manage Licenses panel, YKBLDPTH command, Manage Path Set panel, YKDELPTH command, Manage Route panel, YKQRYPTH command, Message Panel, YKRESYNC command, message structure, YKSUSPND command, MIN parameter FROM parameter...
  • Page 397: Ykbldpth Command

    YKLOAD command, YKRUN command, YKQRYDEV command, YKSCAN command, YKSTORE command, YKSLEEP command, Path Set Detail panel, YKSTATS command, Path Set Selection List panel, YKSTORE command, Path Set Status panel, 1 1 1 YKSUSPND command, path set structure, YKWATCH command, PCU parameter REVERSE parameter YKBLDPTH command, YKBLDPTH command,...
  • Page 398 Select SSID panel, Select Storage System panel, technical support, Set Defaults panel, setting service locator website, ISPF panel, text parameter Setting Information panel, YKWTOMSG command, sidefile flow restriction, text symbols, SMODEL parameter text- 1 parameter YKQRYDEV command, YKWTOMSG command, SN parameter text-2 parameter YKBLDCMD command, YKWTOMSG command,...
  • Page 399 DAD parameter, DEVN parameter, XML document type definition, HS parameter, PREFIX parameter, YKINSCHK command, YKBLDCMD command, YKLOAD command, executing, YKMAKE command, YKBLDPTH command, YKQRYDEV command, YKCONMSG command, executing, MSGID parameter, YKQRYPTH command, TIMEOUT parameter, YKQRYPTH with RESTRUCT specified YKDELCMD command, executing, 1 15 executing,...

This manual is also suitable for:

Xp p9500

Table of Contents