Download Print this page

HP XP P9500 Reference Manual

Hp p9000 for business continuity manager software reference guide
Hide thumbs Also See for XP P9500:

Advertisement

HP
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
P9000 for Business Continuity Manager Basic and HP P9000 for Business Continuity Manager Continuous Access Journal 4x4
Extended CTG.
HP Part Number: T5253-96068
Published: April 2012
Edition: Thirteenth

Advertisement

loading

Summary of Contents for HP XP P9500

  • Page 1 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 P9000 for Business Continuity Manager Basic and HP P9000 for Business Continuity Manager Continuous Access Journal 4x4 Extended CTG.
  • Page 2 © Copyright 2007, 2012 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......................12 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..............14 Common Displays Among Panels....................15...
  • Page 4 Add Route Entry Panel....................52 Storage System Selection List Panel................54 Edit Route Entry Panel....................54 Path Set Selection List Panel....................55 Add Path Set Panel......................57 Path Set Detail Panel......................57 Edit Logical Path Definition Panel..................58 Select Storage System Panel....................61 Select SSID Panel......................62 Edit Port Definition Panel....................63 Assign Port Panel......................64 Sort Logical Paths in Path Set Panel..................64 Copy Group Selection List Panel...................65...
  • Page 5 Volume Query Information (CAJ) Panel................146 Volume Query Information Panel (Executing YKQRYDEV)..........153 Executing YKMAKE......................154 Executing YKSUSPND.......................155 Executing YKRESYNC.......................160 Executing YKDELETE......................163 Executing YKWATCH......................163 Executing YKEWAIT......................164 Executing YKRECVER......................166 Path Set Status of Copy Group Pair Panel (YKQRYDEV with PATH Parameter Specified)....166 Logical Path Status of Copy Group Pair Panel...............168 Confirmation Panels......................169 Confirm Execution Dissolve Panel..................169 Confirm Execution Recover Panel..................170...
  • Page 6 YKQRYDEV Command......................226 YKQRYPTH Command......................228 YKQUERY Command......................232 YKRECVER Command......................234 YKRESYNC Command......................236 YKRUN Command......................241 YKSCAN Command......................242 YKSLEEP Command......................244 YKSTATS Command......................245 YKSTORE Command......................246 YKSUSPND Command.....................247 YKWATCH Command......................256 YKWTOMSG Command....................258 CLI Command Coding Examples..................260 YKDEMO01.......................261 YKDEMO02.......................266 YKDEMO03.......................267 YKDEMO04.......................272 YKDEMO05.......................277 YKDEMO06.......................279 YKDEMO07.......................281 YKDEMO08.......................283 YKDEMO09.......................290 YKDEMO10.......................295 YKDEMO1S.......................296 YKDEMO1 1........................296 YKDEMO12.......................297...
  • Page 7 Specification format for an EXCTG Information CSV File...........353 Examples of CSV Files......................354 CSV Files Used by the YKIMPORT Command..............354 CSV Files Used by the YKEXPORT Command..............355 4 BCM Monitor Parameter Files..............356 Overview of BCM Monitor Parameter Files................356 Content of the BCM Monitor Parameter Files................356 Dataset Format........................356 Format of Parameter Explanations..................356 Specifying parameters....................356...
  • Page 8: Ispf Panels

    1 ISPF Panels This chapter explains how to move between ISPF panels and perform operations on them, and the nature and function of displayed items. “Overview of ISPF Panels” (page 8) “Common Displays Among Panels” (page 15) “Main Menu Panel” (page 21) “Installation Verification Summary Panel (Environment Settings Verification)”...
  • Page 9: Ispf Panel System

    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. Figure 1 ISPF Panel System (1 of 2) Overview of ISPF 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

    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: Sort Command

    Table 1 SELECT Parameters (continued) Parameter Explanation character-string* *character-string To specify a field value that contains spaces or commas (,), enclose the specified field value in single quotation marks ('). If a value has not been specified for the VOLSER or LABEL field, specify a space.
  • Page 13: Scanpair Command

    Format SORTΔ[field-name] Parameter field-name For details about the specifiable field names and sort order, see the descriptions for each panel. If you omit the field name, a pop-up panel will appear and you can specify the sort key. NOTE: If you specify a field name, you cannot sort on multiple items. If you specify an invalid field name, a pop-up panel for specifying the sort key is displayed.
  • Page 14: Ispf Settings

    Table 2 Commands that Can Be Used on the Command Line (continued) Panel Name Command Name LOCATE SELECT SORT SCANPAIR ERRCODE Exception Message Panel — — — — Manage Copy Groups — Pair Selection List (Primary) — — — Pair Selection List (Secondary) —...
  • Page 15: Common Displays Among Panels

    Start Business Continuity Manager. Type PFSHOW TAILOR on the command line, and then press the Enter key. The ISPF Settings panel appears. Set a value in Number of keys. NOTE: If the value set is reached with the keys between F1 and F12, the F17=DispConf key is not displayed.
  • 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

    In the following example, the details for the error code 6A13 are displayed in the Error Code Help panel. When the cursor is located on a space: Cancellation Warning Panel If an error occurs during a creation or update of the configuration file, and you attempt to cancel the creation or update, the Cancellation Warning panel is displayed and asks if you want to cancel the creation or update.
  • Page 19: Update Warning Panel

    Figure 7 Error Code Help Panel Table 5 (page 19) describes the items in the Error Code Help panel. Table 5 Items in the Error Code Help Panel Item Description Error code For specifying or displaying an error code whose details will be displayed. Error details Displays the error code details.
  • Page 20: Capacity Warning Panel

    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: Main Menu Panel

    Main Menu Panel Transitions between operating panels starting from the Main Menu are shown in Figure 10 (page 21). Figure 10 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.
  • 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 14 (page 25) shows the User SVC Information panel. Figure 14 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: Set Defaults Panel (Prefix And Dad Id Settings)

    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 When using the Remote DKC Control Function, a route list ID, and a route label. The parameters for the YKWATCH command, which monitors volume status, and the JCL for background jobs. The Set Defaults panel is shown in Figure 15 (page 27) (values in the figure are samples only).
  • Page 28 Table 10 Contents of the Set Defaults Panel (continued) Item Description If Remote DKC Function is set to Y and Preset RouteListID is not specified, and YKLOAD is executed in the Manage Copy Groups panel, then the LOAD Option panel to query the route list ID is shown. Preset Route Label Specify the ROUTE parameter value (the route label) for the YKLOAD command.
  • Page 29: Manage Licenses Panel (License Management)

    Figure 16 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 17 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)

    Figure 18 Message Panel Discover/Define Configuration Panel (Configuration File Definition) The Discover/Define Configuration panel is displayed when 3 Discover/Define Configuration is selected in the Main Menu panel. The Discover/Define Configuration panel displays the menu related to volume scans, route list definitions, path set definitions, and copy group definitions. The Discover/Define Configuration panel is shown in Figure 19 (page 31).
  • 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 21 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 23 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 25 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 28 (page 41).
  • Page 42: Scan Remote Device Address Extent Panel

    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. Figure 29 (page 42) shows the Scan Device Address Extent panel.
  • Page 43 Figure 30 Panel Transitions from the Route Config Panel #1: Displayed only when the leftmost AC has been specified. #2: Displayed for a storage system when 1 is specified for the selection field of the storage system in the Add Route Entry panel or the Edit Route Entry panel. Displayed for a storage system when 2 is specified for the selection field of the storage system in the Add Route Entry panel or the Edit Route Entry panel.
  • Page 44: Add Route List Id Panel

    The route list definition is required when using the Remote DKC Control Function and the Cnt Ac-S consistency preservation function. It defines routes between devices and command devices so that these devices are available. The route list ID list is displayed in the Route Config panel. To create a route list ID, place the cursor on the field and press F5=Add.
  • Page 45 Figure 33 Route List Information Panel Page 1 If there are multiple routes with the same first storage system, = appears for the first storage system of the second and subsequent routes. If the list of storage systems continues beyond the displayable area, > is displayed to the right of the header.
  • Page 46: Command Device Information Panel

    Table 24 Contents of the Route List Information panel Item Description Route List Route list ID selected in the Route Config panel. Specify an action. Actions are not accepted in the AC column for which no storage system is defined. s: Displays the command devices defined for the specified route.
  • Page 47 If the list of command devices continues beyond the displayable area, > appears to the right of the header. Pressing the F1 1 key displays the command devices that could not be displayed. Figure 36 (page 47) shows the Command Device Information panel that appears when the F1 1 key is pressed.
  • Page 48: Define Command Device Panel

    Table 25 Contents of the Command Device Information Panel (continued) Item Description leftmost Actions are not accepted in the AC column for which no storage system is defined in the Route List Information panel. e: Edits the command device information. Either of the following panels are displayed: ◦...
  • Page 49 Figure 37 Define Command Device Panel Table 26 (page 49) describes the items in the Define Command Device panel. Table 26 Contents of the Define Command Device Panel Item Description DADID DAD ID to which the devices belong. Serial number of the storage system to which the devices belong. Current If a command device has already been defined, information about the already-defined command device Selection...
  • Page 50: Sort The Define Command Device Panel

    You can specify the following fields for a sort key of the SORT command: Name of field Sorted by Direction Number of the control unit to which the command device belongs Ascending Command control address of the command device Ascending Device number of the command device Ascending DEVN...
  • Page 51: Add Attribute Panel

    Figure 39 Define Remote Command Device Panel Table 28 (page 51) describes the items in the Define Remote Command Device panel. Table 28 Contents of the Define Remote Command Device Panel Item Description DADID The Device Address Domain ID to which the device belongs. The serial number of the storage system to which the device belongs.
  • Page 52: Edit Attribute Panel

    Table 29 Contents of the Add Attribute Panel Item Description Label Specify a route label for the command device line by using no more than 8 alphanumeric characters. The specification of the route label is optional. APID Specify an APID for the command device. Use a 4-digit hexadecimal number (0000 to FFFF).
  • Page 53 Figure 42 Add Route Entry Panel In the selection field, specify a relevant value based on the status of the storage system to be added. How to specify the storage system varies depending on the value specified in the selection field. The following table describes the values to specify in the selection field and how to specify a storage system.
  • Page 54: Storage System Selection List Panel

    Storage System Selection List Panel In the Add Route Entry or Edit Route Entry panel, if you specify 1 in the selection field and then press the Enter key, the Storage System Selection List panel appears. The serial numbers and Device Address Domain IDs of storage systems appear in the Storage System Selection List panel.
  • Page 55: Path Set Selection List Panel

    Figure 44 Edit Route Entry Panel In the selection field, specify a relevant value based on the status of the storage system whose information is to be updated. How to specify the storage system varies depending on the value specified in the selection field. The following table describes the values to specify in the selection field and how to specify the storage system.
  • Page 56 Figure 45 (page 56) shows the transition of the operation panel starting from the Path Set Selection List panel. Figure 45 Panel Transitions from the Path Set Selection #1: Pressing the F6=Sort key sorts items on the panel. #2: If CU is specified in Type on the Edit Logical Path Definition panel, the Select SSID panel is displayed.
  • Page 57: Add Path Set Panel

    Table 34 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— Deletes a path set definition file When actions are entered in multiple AC columns, each is processed in the order displayed.
  • Page 58: Edit Logical Path Definition Panel

    Table 35 Contents of the Path Set Detail Panel Item Description Path Set ID Path set ID Description A description of the path set (can be edited) Specify an action. e— Displays the Edit Logical Path Definition panel used to display or edit a logical path. d—...
  • Page 59 Figure 49 Edit Logical Path Definition Panel Table 36 (page 59) describes the items in the Edit Logical Path Definition panel. Table 36 Contents of the Edit Logical Path Definition Panel Item Description Path Set ID Path set ID Description A description of the path set Type Type of path...
  • Page 60 Table 36 Contents of the Edit Logical Path Definition Panel (continued) Item Description Model Secondary storage system model (modifiable) IFType Secondary interface version (modifiable) PathID Specify the secondary 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 61: 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 62: Select Ssid Panel

    Figure 50 Select Storage System Panel Table 39 (page 62) describes the items in the Select Storage System panel. Table 39 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 63: Edit Port Definition Panel

    Table 40 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 64: Assign Port Panel

    Table 41 Contents of the Edit Port Definition Panel (continued) Item Description Secondary CU number SSID Secondary SSID Specify an action. d— Deletes a physical path. When actions are entered in multiple AC columns, each is processed in the order displayed. Port Primary Port number of the physical path of the primary site...
  • Page 65: Copy Group Selection List Panel

    Figure 54 Sort Logical Paths in Path Set Panel Table 43 (page 65) describes the items in the Sort Logical Paths in the Path Set panel. Table 43 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 66 Figure 55 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 67 Figure 56 Panel Transition for the Copy Group Selection List Panel (Browse Copy Group Information) #: Pressing the F6=Sort key sorts items on the panel. Figure 57 (page 67) shows the panel transition when e is specified for AC in the Copy Group Selection List panel.
  • Page 68: Add Copy Group Panel

    Figure 58 Copy Group Selection List Panel Table 44 (page 68) describes the items in the Copy Group Selection List panel. Table 44 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 69: Copy Group Detail Definition Panel

    C/T ID Attributes panel appears. In this panel, you can define a consistency group ID. If you enter 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 59 (page 69) shows the Add Copy Group pop-up) panel.
  • Page 70 Figure 60 Copy Group Detail Definition Panel “Items in the Copy Group Detail Definition panel” (page 70) 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 71 Table 46 Items in the Copy Group Detail Definition panel (continued) Item Description When effective can be specified only in the Copy Group Detail Definition panel). d: Deletes a copy group (this setting can be specified only in the Copy Group Detail Definition panel). s: Displays a copy pair in the copy group.
  • Page 72: Copy Group Attributes Panel

    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. In this panel, you can change the copy group so that it is no longer a CG container. If you define a new copy group in the Add Copy Group panel, and you then return to the Copy Group Detail Definition panel and press the F12=Cancel key, display returns to the Copy Group Selection List panel.
  • Page 73 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 73) “Copy Group Attributes (CAJ) Panel (for CAJ Copy Groups that are not CG Containers)” (page 74) show the Copy Group Attributes panels.
  • Page 74 Figure 65 Copy Group Attributes For Container (CAA) Panel (for CAA Copy Groups that are CG Containers) Figure 66 Copy Group Attributes (CAA) Panel (for CAA Copy Groups that are not CG Containers) Figure 67 Copy Group Attributes For Container (CAJ) Panel (for CAJ Copy Groups that are CG Containers) Figure 68 Copy Group Attributes (CAJ) Panel (for CAJ Copy Groups that are not CG Containers) Table 48 (page 75)
  • Page 75 because Business Continuity Manager cannot perform copy pair operations, if you change the definitions of the items that require the YKMAKE or YKRESYNC command to make changes, the changes will not be applied to the storage system settings. Table 48 Contents of the Copy Group Attributes Panel Item Description Copy type...
  • Page 76 Table 48 Contents of the Copy Group Attributes Panel (continued) Item Description Copy type When effective FENCE LVL Specify the fence level (required for When the YKMAKE CA). command is executed DATA: Places P-VOL in fence When the YKRESYNC status (updates suppressed) when command is executed updates in P-VOL cannot be copied to S-VOL due to a...
  • Page 77 Table 48 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 78 Table 48 Contents of the Copy Group Attributes Panel (continued) Item Description Copy type When effective FLOW CTL Specify the sidefile flow restriction When the YKMAKE (required for TCA). command is executed Y: Restricts the flow of host When the YKRESYNC update I/O on the S-VOL command is depending on the usage amount...
  • Page 79 Table 48 Contents of the Copy Group Attributes Panel (continued) Item Description Copy type When effective when setting an ATTIME suspend time. NORMAL: Uses the NORMAL ATTIME suspend function. CAJ(STEADY): Uses the CAJ ATTIME suspend function. The suspension is activated in STEADY mode.
  • Page 80 Table 48 Contents of the Copy Group Attributes Panel (continued) Item Description Copy type When effective TIMESTAMP Specify whether to transfer the When the YKMAKE writing timestamp to the S-VOL command is executed when the copy type is CA When the YKRESYNC (timestamp transfer mode).
  • Page 81: Setting C/T Id Attributes Panel

    Table 49 Default values for each copy type (continued) Copy type Default value COPY PACE=NORMAL Linkage Option=NONE FENCE LVL=NEVER FREEZE SCP=Y PROT MODE=PROTECT COPY PACE=NORMAL TIMESTAMP=N OPEN/MF=N ERROR LVL=GROUP FLOW CTL=Y DIF UNIT=CYL PROT MODE=PROTECT COPY PACE=NORMAL MIRROR ID=1 ERROR LVL=GROUP PROT MODE=PROTECT C/T TIME MODE=ASIS If you define a new copy group in the Add Copy Group panel, and you then return to the Copy...
  • Page 82: Copy Group Pair Detail Panel

    Table 50 Contents of the Setting C/T ID Attributes Panel Item Description Specifiable copy types C/T ID (JNLG) If the copy type is BC, CA, or CAA, specify the C/T group ID (required for CAA). Specify a value between 00 and 7F (depending on the storage system type).
  • Page 83 The Copy Group Pair Detail panel is shown in Figure 70 (page 83). Figure 70 Copy Group Pair Detail Panel Table 51 (page 83) describes the items in the Copy Group Pair Detail panel. Table 51 Contents of the Copy Group Pair Detail Panel Item Description Copy Group ID...
  • Page 84: Pair Selection List (Primary) Panel

    Table 51 Contents of the Copy Group Pair Detail Panel (continued) Item Description SSID Storage subsytem number CU number The two leftmost characters indicate the CCA of the device in hexadecimal. The rightmost character indicates, as follows, whether the CCA is an external volume.
  • Page 85 Figure 71 Pair Selection List (Primary) Panel “Contents of the Pair Selection List (Primary) Panel” (page 85) describes the items in the Pair Selection List (Primary) panel. Table 52 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 86: Import Sms Storage Group Panel

    “Specifying fields for a condition of the SELECT command” (page 86) lists how you can specify the fields for a condition of the SELECT command: Table 53 Specifying fields for a condition of the SELECT command Name of field Value in field Type DEVN Device Number...
  • Page 87: Pair Selection List (Secondary) Panel

    Figure 73 Import SMS Storage Group Result Panel Pair Selection List (Secondary) Panel If you press the F5=Second key in the Pair Selection List (Primary) panel, the Pair Selection List (Secondary) panel is displayed on top of the Pair Selection List (Primary) panel. In the Pair Selection List (Secondary) panel, you specify the S-VOL of the copy pair.
  • Page 88: Sort Copy Group Container Panel

    Table 55 Contents of the Pair Selection List (Secondary) Panel (continued) Item Description SSID SSID CU number The two leftmost digits indicate the device CCA (in hexadecimal) The rightmost digit indicates whether the CCA is an external volume. +: External volume : Not an external volume (blank): The volume attribute is unknown because it could not be acquired Cyls...
  • Page 89: Sort Copy Group Pairs List Panel

    In the Sort Copy Group Container panel, you can select the sorting order from the following items. Item Sort Order 1. C/T Group ID Consistency group ID order. 2. sub C/T Group ID Subconsistency group ID order. 3. Primary-Storage System Serial Primary storage system serial number order.
  • Page 90: Scan Copy Pair Inside Storage System Panel

    Scan Copy Pair Inside Storage System Panel When SCANPAIR is entered on the command line and the Enter key is pressed on the Copy Group Selection List panel, the display switches to the Scan Copy Pair Inside Storage System panel for scanning the P-VOL of the PPRC copy pair and generating a copy group definition file.
  • Page 91 Table 56 Contents of the Scan Copy Pair Inside Storage System Panel (continued) Item Description Two-digit serial numbers beginning with 00 are assigned in ascending order to the copy group names specified by this parameter (for example, 00, 01, 02...). You can specify a maximum of six characters for a copy group name.
  • Page 92: Browse Copy Group Detail Definition Panel

    Where: gggggg: Copy group name nn: 2-digit serial number beginning with 00 A copy group definition file is created as follows: CA copy groups: A single copy group definition file is created for all searched copy pairs. TCA copy groups: A copy group definition file is created for each C/T group. BC copy groups: A single copy group definition file is created for all searched copy pairs.
  • Page 93: Browse Copy Group Pair Detail Panel

    Browse Copy Group Pair Detail Panel The Browse Copy Group Pair Detail panel will display if: The copy group for which b is specified for the AC in the Copy Group Selection List panel is not a CG container, or If s is specified for the AC of a copy group that you want to display in the Browse Copy Group Detail Definition panel In this panel you can view the details on the copy pairs in the copy group selected for display.
  • Page 94: Extra Command Device Direct Operation Panel

    Figure 80 Panel Transitions from the Manage Route Panel The Manage Route panel is shown in Figure 81 (page 94). Figure 81 Manage Route Panel “Contents of the Manage Route Panel” (page 94) describes the items in the Manage Route panel. Table 57 Contents of the Manage Route Panel Item Description...
  • Page 95 Figure 82 Extra Command Device Direct Operation Panel Table 58 (page 95) describes the items displayed in the Extra Command Device Direct Operation panel. Table 58 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.
  • Page 96: Executing Ykdelcmd

    If the specified action has been aborted, the execution result (RC) is not displayed correctly. When you change or delete the route list, command devices defined in the list can remain registered in the storage system. You can use this panel to directly operate such devices by entering the appropriate DAD ID and storage system serial number to specify the storage system, as well as the device number of the command device.
  • Page 97 Figure 83 (page 97) shows the Route Status panel when the F10=DADInfo key is pressed. Figure 83 Route Status Panel (When the F10=DADInfo Key is Pressed) Figure 84 (page 97) shows the Route Status panel when the F1 1=CCAInfo key is pressed. Figure 84 Route Status Panel (When the F1 1=CCAInfo Key is Pressed) Table 59 (page 97) describes the items in the Route Status panel.
  • Page 98 Table 59 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 99: 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 100 Figure 85 Command Device Status Panel (Command Device is Registered) 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), meanwhile it is also defined as a copy pair.
  • Page 101 Table 60 (page 101) describes the items in the Command Device Status panel. Table 60 Contents of the Command Device Status Panel Item Description Model Model of the storage system to which the specified volume belongs uCODE Microcode information for the storage system to which the specified volume belongs.
  • Page 102: Executing Ykbldcmd

    Executing YKBLDCMD When b is specified in the AC column in the Route Status panel, the YKBLDCMD command is executed to register a command device to storage system. The Confirm Command Device Build panel (see “Confirm Command Device Build Panel” (page 171)) will be displayed.
  • Page 103: Command Device Selection Panel

    NOTE: If you are using the HP 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: ◦...
  • Page 104: Manage Path Set Panel (Logical Path Management)

    Table 61 Contents of the Command Device Selection List Panel (continued) Item Description USPV: HP XP24000/XP20000 Disk Array VSP: HP P9500 Disk Array uCode Microcode information IFType Interface version Storage system serial number Specify an action. q: Displays the Command Device Status panel used to display the command device information, which is registered in the storage system.
  • Page 105 Figure 89 Manage Path Set Panel Pressing the F1 1=NextInfo key displays Description. Pressing the F10=PrevInfo key returns to the previous display. Figure 90 (page 105) shows the Manage Path Set panel displayed when the F1 1=NextInfo key is pressed. Figure 90 Manage Path Set Description Panel Table 62 (page 105) describes the items in the Manage Path Set panel.
  • Page 106: Executing Ykload

    Table 62 Contents of the Manage Path Set Panel (continued) Item Description LOADED: Loading the path set was successful. Action-name SUCCESSFULLY: The action indicated by action-name was successful. Action-name WARNINGS command-name RC= xx: A warning occurred with the command indicated by command-name, in the action indicated by action-name. Action-name WITH WARNINGS command-name RC=xx: The command indicated by command-name within the action indicated by action-name generated an error message.
  • Page 107: Executing Ykdelpth

    Table 63 Contents of the LOAD Option Panel When Loading a Path Set (continued) Item Description If * is specified, the information for all command devices is loaded regardless of whether they have a route label. If this item is omitted, the information about the command devices with no route label is loaded. 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).
  • Page 108 Figure 92 Path Set Status Panel Table 64 (page 108) describes the items in the Path Set Status panel. Table 64 Contents of the Path Set Status Panel Item Description Path Set ID Path set ID Description A description of the path set Specify an action.
  • Page 109: Logical Path Status Panel

    Table 64 Contents of the Path Set Status Panel (continued) Item Description 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 110 Figure 93 Logical Path Status Panel Table 65 (page 110) describes the items in the Logical Path Status panel. Table 65 Contents of the Logical Path Status Panel Item Description Path Set ID Path set ID Description A description of the path set Type Type of path CU: Inter-CU logical path...
  • Page 111: Executing Ykqrypth With Restruct Specified

    Table 65 Contents of the Logical Path Status Panel (continued) Item Description Secondary Secondary port number Status Status of a physical path NO PATH: No physical path defined. ESTABLISHED: The physical path has been established. INIT FAILED: An initialization error has occurred. TIME OUT: A timeout has occurred.
  • Page 112 Figure 94 Manage Copy Groups Panel Pressing the F1 1=NextInfo key displays Description. Pressing the F10=PrevInfo key returns to the previous display. The following figure shows the Manage Copy Groups panel when the F1 1=NextInfo key is pressed. Figure 95 Manage Copy Groups Description Panel Table 66 (page 112) describes the items in the Manage Copy Groups panel.
  • Page 113 Table 66 Contents of the Manage Copy Groups Panel (continued) Item Description v: Execute the YKQUERY command with the VERIFY parameter specified. f: Executes the YKEWAIT command with the TIMEOUT(0) parameter specified. If there are many copy pairs, you can obtain the volume status more quickly by 2, 3 specifying f in AC, rather than by specifying q.
  • Page 114: Sort The Copy Groups Panel

    If you specify f for a CA copy group with a consistency group ID, use a route list that includes the storage system where the CA copy group is defined. If f is specified and a route list is used that does not include the storage system where the CA group is defined, the counts displayed for each copy pair status on the Copy Group Status Summary and Copy Group Storage System Summary panels, and the copy pair statuses displayed on the Copy Group Pair Status panel will not be correct.
  • Page 115: Executing Ykload

    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 parameters is displayed.
  • Page 116: Copy Group Status Summary Panel (Executing Ykquery)

    The LOAD Option panel might not be displayed depending on the settings of the Remote DKC Function column and Preset RouteListID column in the Set Defaults panel. Settings of the Remote Settings of the Preset Display of the LOAD Option Panel DKC Function RouteListID Specified...
  • Page 117 Figure 98 Panel Transitions from the Copy Group Status Summary Panel The Copy Group Status Summary panel is shown in Figure 99 (page 118). Manage Copy Groups Panel (Copy Group Operation) 1 17...
  • Page 118 Figure 99 Copy Group Status Summary Panel “Contents of the Copy Group Status Summary Panel” (page 118) describes the items in the Copy Group Status Summary panel. Table 68 Contents of the Copy Group Status Summary Panel Item Description Copy Group ID Copy group ID Description A description of the copy group...
  • Page 119: Copy Group Storage System Summary Panel

    Table 68 Contents of the Copy Group Status Summary Panel (continued) Item Description Swapping Number of copy pairs in the SWAPPING status 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 If you specify f for AC in the Manage Copy Groups panel, N/A is displayed.
  • Page 120: Caa Copy Group Performance Statistics Panel

    Table 69 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 121 Table 70 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 122: 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 123: Caj Copy Group Performance Statistics Panel

    Figure 102 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 124 Figure 103 CAJ Copy Group Performance Statistics Panel Table 71 (page 124) describes the items in the CAJ Copy Group Performance Statistics panel. Table 71 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 125 Table 71 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 126: 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 127: 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 128 Table 72 Contents of the Copy Group Pair Status Panel (continued) Item Description d: Executes the YKDELETE command to dissolve copy pairs. See “Executing YKDELETE” (page 163). c: Executes the YKRECVER command to dissolve copy pairs from the secondary site. See “Executing YKRECVER”...
  • Page 129: Sort The Copy Group Pairs Status Panel

    If you perform operations for a copy group belonging to a pair dissolved on a copy pair basis, by the time the copy pair is remade, be sure to specify the SELECT(COND) parameter. If the correct value could not be acquired from the primary site, 000 is displayed. If f is specified in the Manage Copy Groups panel, N/A is displayed.
  • Page 130: Volume Query Information (Bc) Panel

    Figure 106 Sort the Copy Group Pairs Status Panel “Sort the Copy Group Pairs Status Panel” (page 130)describes the items in the Sort the Copy Group Pairs Status panel. Table 73 Sort the Copy Group Pairs Status Panel Item Sort Order 1.
  • Page 131 Figure 107 Volume Query Configuration Example (BC) Figure 108 Volume Query Information (BC) Panel Table 74 (page 131) describes the items in the Volume Query Information (BC) panel. Table 74 Contents of the Volume Query Information (BC) Panel Item Description Copy Group ID Copy group ID Copy Group Type (in Configuration)
  • Page 132 Table 74 Contents of the Volume Query Information (BC) Panel (continued) Item Description SSID SSID of the P-VOL at definition CU number of the P-VOL at definition CCA of the P-VOL at definition DEVN Device number of the P-VOL at definition The following volume online information is displayed to the right of DEVN: *: Online...
  • Page 133 Table 74 Contents of the Volume Query Information (BC) Panel (continued) Item Description pair was in the suspend status at the ATTIME suspend time. ATTIME-suspend-time NO I/O TRIGGERED: A suspension was performed because no-update journal was detected. N/A: This Copy pair is not the BC copy pair specified with the consistency group ID.
  • Page 134 Table 74 Contents of the Volume Query Information (BC) Panel (continued) Item Description ◦ MM: Minutes are displayed. ◦ SS.NNNNNN: Seconds are displayed. UNEXPECTED: When the BC copy pair was suspended, some CAJ copy pairs were not in DUPLEX status. ERROR(0001): Since the BC copy pair status is invalid, suspend processing for the BC copy pair was abnormally terminated.
  • Page 135 Table 74 Contents of the Volume Query Information (BC) Panel (continued) Item Description For Primary: storage system serial number for P-VOL of the Copy pair specified in the Copy Group Pair Status panel For Secondary: storage system serial number for S-VOL of the copy pair specified in the Copy Group Pair Status panel DEVN For Primary: Device number for P-VOL of...
  • Page 136: Volume Query Information (Ca) Panel

    NOTE: N/A displays in the Device Information (DEVN) field in the following cases: 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 When displaying information about a Non Gen'ed volume, and the route list has not been loaded or the target storage system is not included in the route list.
  • Page 137 Table 75 Contents of the Volume Query Information (CA) Panel (continued) Item Description The following volume online information is displayed to the right of DEVN: *: Online -: Offline Nothing is displayed when volume online information cannot be obtained. Status Copy pair status Copy direction in the copy pair Always displays >...
  • Page 138 Table 75 Contents of the Volume Query Information (CA) Panel (continued) Item Description be copied to S-VOL due to a problem such as a failure. STATUS: Places P-VOL in fence status (updates suppressed) when updates in P-VOL cannot be copied to S-VOL due to a problem such as a failure.
  • Page 139 Table 75 Contents of the Volume Query Information (CA) Panel (continued) Item Description For Primary: storage system serial number for the P-VOL of the copy pair specified in the Copy Group Pair Status panel For Secondary: storage system serial number for the S-VOL of the copy pair specified in the Copy Group Pair Status panel DEVN...
  • Page 140: 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 141 Figure 1 1 1 Volume Query Information (CAA) Panel “Contents of the Volume Query Information (CAA) Panel” (page 141) describes the items in the Volume Query Information (TCA) panel. Table 76 Contents of the Volume Query Information (CAA) Panel Item Description Copy Group ID Copy group ID...
  • Page 142 Table 76 Contents of the Volume Query Information (CAA) Panel (continued) Item Description 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 definition CU number of the S-VOL at definition...
  • Page 143 Table 76 Contents of the Volume Query Information (CAA) Panel (continued) Item Description On the second line: (LOCAL): ATTIME-suspend-time-in-local-time Format of the ATTIME suspend time: YYYYMMDD HH:MM :SS.NNNNNN YYYY: The year is displayed. MM: The month is displayed. DD: The date is displayed.
  • Page 144 Table 76 Contents of the Volume Query Information (CAA) Panel (continued) Item Description 4, 1 COPY PACE Pace of copying NORMAL: The speed of the copy operation improves. However, update I/O load on P-VOL is high, and this might affect the I/O performance of the host.
  • Page 145 Table 76 Contents of the Volume Query Information (CAA) Panel (continued) Item Description For Primary: storage system serial number for P-VOL of the copy pair specified in the Copy Group Pair Status panel For Secondary: storage system serial number for S-VOL of the copy pair specified in the Copy Group Pair Status panel...
  • Page 146: Volume Query Information (Caj) Panel

    The timing for when the defined values are reflected is as shown in Table 48 (page 75), in the item When effective. It is displayed if P-VOL or S-VOL is shared with other copy pairs in the definition (for example, in a 1:n BC copy pair configuration or when S-VOL for CAA is used as P-VOL for BC).
  • Page 147 Table 77 Contents of the Volume Query Information (CAJ) Panel (continued) Item Description Primary Volume Storage system serial number of the P-VOL at definition SSID SSID of the P-VOL at definition CU number of the P-VOL at definition CCA of the P-VOL at definition DEVN Device number of the P-VOL...
  • Page 148 Table 77 Contents of the Volume Query Information (CAJ) Panel (continued) Item Description The type of consistency time used differs depending on the value specified in C/T TIME MODE in the Copy Group Attribute (CAJ) panel. N/A is displayed for the delta resync pair, or when the consistency time is invalid.
  • Page 149 Table 77 Contents of the Volume Query Information (CAJ) Panel (continued) Item Description timer type cannot be obtained 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...
  • Page 150 Table 77 Contents of the Volume Query Information (CAJ) Panel (continued) Item Description For Primary: storage system serial number of the P-VOL of the copy pair specified in the Copy Group Pair Status panel For Secondary: storage system serial number of the S-VOL of the copy pair specified in the Copy Group Pair Status...
  • Page 151 The timing for when the defined values are reflected is as described in Table 48 (page 75), in the table item of When effective. Not displayed when the command has been executed for the HP XP1024/XP128 Disk Array. For details about the status of the displayed copy pair, see the table (for CAJ) that shows the copy pair statuses of volumes obtained by using the YKQRYDEV command, in the HP P9000 for Business Continuity Manager Software Users Guide.
  • Page 152 the reverse direction. The characters displayed in status2 are determined according to the values for flag3 and flag4 and status2 may have one of the following values: active: The journal group has been registered in a storage system as EXCTG. This copy pair is ready to be used by 4x4 CAJ in the reverse direction.
  • Page 153: 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 154: 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 13 (page 154), Figure 1 14 (page...
  • Page 155: Executing Yksuspnd

    Table 78 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 156 Figure 1 16 BC Copy Group Suspension Options Panel Figure 1 17 BC with C/T Copy Group Suspension Options Panel Figure 1 18 CA Copy Group Suspension Options Panel 156 ISPF Panels...
  • Page 157 Figure 1 19 CAA Copy Group Suspension Options Panel Figure 120 CAJ Copy Group Suspension Options Panel Displayed from the Manage Copy Groups Panel Figure 121 CAJ Copy Group Suspension Options Panel Displayed from the Copy Group Pair Status Panel “Contents of the Suspension Options Panel”...
  • Page 158 Table 79 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 159 Table 79 Contents of the Suspension Options Panel (continued) Item Description Format of the ATTIME suspend time is as follows: YYYY: Specify the year (1970 to 2042) MM: Specify the month (01 to 12) DD: Specify the date (01 to 31) HH: Specify the time (00 to 23) MM: Specify the minute (00 to 59) SS: Specify the second (00 to 59)
  • Page 160: Executing Ykresync

    The ATTIME parameter can be added or cancelled for BC and TCA copy groups with a consistency group ID. The YKSUSPND command terminates successfully when the instruction to the copy pair succeeded. Even if the command has terminated successfully, make sure that the transition of the copy pair status was performed, using the YKQUERY command or the YKEWAIT command.
  • Page 161 Figure 124 CAJ Copy Group Resync Options Panel Displayed from the Manage Copy Groups Panel Figure 125 CAJ Copy Group Resync Options Panel Displayed from the Copy Group Pair Status Panel 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 162 Table 80 Contents of the Resync Options Panel (continued) Item Description AS-IS performs differential copying of the copy pairs that are in the suspend status without changing the currently specified copy direction. Forward: Copies the contents of the P-VOL to the S-VOL. Reverse: Copies the contents of the S-VOL to the P-VOL.
  • Page 163: Executing Ykdelete

    Table 80 Contents of the Resync Options Panel (continued) Item Description Overwrite ONLINE target volume When the S-VOL is online, specify whether to make or resynchronize a copy pair (default is N): Y: Makes or resynchronizes the copy pair even if the S-VOL is online. N: Does not make or resynchronize the copy pair if the S-VOL is online.
  • Page 164: Executing Ykewait

    Figure 126 Watch Options Panel “Contents of the Watch Options Panel” (page 164) describes the items in the Watch Options panel. Table 81 Contents of the Watch Options Panel Item Description Copy Group ID Copy group ID Watch transition to Specify the waiting status for the YKWATCH command by using the number.
  • Page 165 Figure 127 Wait Options Panel (for BC, CA, or CAA) Figure 128 CAJ Copy Group Wait Options Panel “Contents of the Wait Options Panel” (page 165) describes the items in the Wait Options panel. Table 82 Contents of the Wait Options Panel Item Description Copy Group ID...
  • Page 166: Executing Ykrecver

    Table 82 Contents of the Wait Options Panel (continued) Item Description Timeout Minutes Specify the value for the TIMEOUT parameter (timeout value) in minute (0 to 9999). NOINVALIDCHECK Specify whether to specify the NOINVALIDCHECK parameter. Y: The NOINVALIDCHECK parameter is specified. The detection of invalid statuses is disabled.
  • Page 167 Table 83 Contents of the Path Set Status of Copy Group Pair Panel Item Description Copy Group ID Copy group ID Specify an action. s: Displays the Logical Path Status of Copy Group Pair panel used to display the status of physical paths in the logical path. Type Path type CU: Inter-control unit logical path...
  • Page 168: Logical Path Status Of Copy Group Pair Panel

    Table 84 Return codes displayed in the Copy Group Pair Status panel (continued) Return Code Meaning If no path information is displayed, then there is no path used by the copy pair selected in the Copy Group Pair Status panel. Path information cannot be displayed for one of the following reasons: The device information during definition, as indicated by Primary Volume/Secondary Volume in the Copy Group Pair Status panel, differs...
  • Page 169: Confirmation Panels

    Table 85 Contents of the Logical Path Status of Copy Group Pair Panel Item Description Copy Group ID Copy group ID Type Path type CU: Inter-control unit logical path DKC: Inter-disk controller logical path Primary Primary storage system serial number PathID Primary path ID When the path type is CU, nothing is displayed.
  • Page 170: Confirm Execution Recover Panel

    Figure 131 Confirm Execution Dissolve Panel “Contents of the Confirm Execution Dissolve Panel” (page 170) describes the item in the Confirm Execution Dissolve panel: Table 86 Contents of the Confirm Execution Dissolve Panel Item Description Set dissolve execution confirmation Specify whether to display the Confirm Execution Dissolve panel. This setting remains in effect until you return to the Main Menu.
  • Page 171: Confirm Command Device Build Panel

    Table 87 Contents of the Confirm Execution Recover Panel Item Description Set recover execution confirmation Specify whether to display the Confirm Execution Recover panel. This setting remains in effect until you return to the Main Menu panel. Selected: Do not display the Confirm panel when c is specified. Cleared: Display the Confirm panel.
  • Page 172: Confirm Cancellation Of Changes Panel

    Confirm Cancellation of Changes Panel When you attempt to cancel an update of the configuration file, the Confirm Cancellation of Changes panel is displayed asking you whether you want to cancel the update. However, after an error occurred during an update of the configuration file, if you attempt to cancel the update, the Cancellation Warning panel is displayed instead of the Confirm Cancellation of Changes panel.
  • Page 173: Displayed From Route Status Panel

    Displayed from Route Status Panel When d is specified in AC in the Route Status panel, the Confirm Command Device Delete panel will be displayed to confirm that you can delete a command device registered in the storage system. Figure 136 (page 173) shows the Confirm Command Device Delete panel.
  • Page 174: Confirm Configuration File Delete Panel

    Figure 137 Confirm Command Device Delete Panel (Displayed from Extra Command Device Direct Operation Panel) “Contents of the Confirm Command Device Delete Panel (displayed from Extra Command Device Direct Operation Panel)” (page 174) lists the items displayed in the Confirm Command Device Delete panel.
  • Page 175: Confirm Configuration File Update Panel

    Figure 138 Confirm Configuration File Delete Panel Pressing the Enter key deletes the configuration file. Pressing the F12=Cancel key cancels the deletion of the configuration file. Confirm Configuration File Update Panel When you attempt to update a configuration file for the following operations, the Confirm Configuration File Delete panel is displayed asking you whether you want to perform the update: When changing the copy group definition.
  • Page 176: Confirm Copy Group Load Panel

    during an update of the configuration file, if you press the F12=Cancel key, the Cancellation Warning panel is displayed. When you moved to the Add Copy Group panel by pressing F5=Add in the Copy Group Selection List panel, if you press F12=Cancel in the Confirm Configuration File Update panel, the display returns to the Copy Group Selection List panel.
  • Page 177: Confirm Path Delete Panel

    Confirm Path Delete Panel If d is specified in AC in the Manage Path Set panel or Path Set Status panel, the Confirm Path Delete panel is displayed to confirm whether you can delete the logical path. Figure 142 (page 177) shows the Confirm Path Delete panel.
  • Page 178: Confirm Route Delete Panel

    Figure 143 Confirm Path Set Load Panel Pressing the Enter key loads the path set. Pressing the F12=Cancel key cancels the loading of the path set. Confirm Route Delete Panel If d is specified for AC in the Route List Information panel, the Confirm Route Delete panel appears to confirm whether to delete the route.
  • Page 179: Confirm Retry Of Configuration File Create Panel

    Figure 145 Confirm Route List Edit Panel Pressing the Enter key changes the route list definition. Pressing the F12=Cancel key cancels the changes to the route list definition. If Y is specified and the Enter key is pressed, the route list definition is changed. If N is specified and the Enter key is pressed, the route list definition is not changed.
  • Page 180 Figure 147 Confirm Open/MF Consistency Group Suspension Panel “Contents of the Confirm Open/MF Consistency Group Suspension Panel” (page 180) lists and describes the items in the Confirm Open/MF Consistency Group Suspension panel. Table 92 Contents of the Confirm Open/MF Consistency Group Suspension Panel Item Description Do not confirm suspension of...
  • Page 181: 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 182) “List of Functions” (page 182) “Configuration Files That Must Be Loaded Before Command Execution” (page 183) “YKBLDCMD Command”...
  • Page 182: 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 183: Configuration Files That Must Be Loaded Before Command Execution

    Table 93 List of Supported Functions (continued) Command Function 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 update I/O for the P-VOL.
  • Page 184 Table 94 (page 184) 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 185 Table 94 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 186: Command Details

    Table 95 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 187 The command registers, into 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> When you register the command devices for a storage system in the route list, specify the storage system serial number.
  • Page 188: Ykbldpth Command

    NOTE: Execute the YKBLDCMD command only once after turning on the storage system. Even if this command is entered multiple times, only the first time is effective, and entry after the first time does not take effect. However, before this command is entered, make sure that storage system control with the corresponding command device did not take place.
  • Page 189 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. Parameters STEM(stem-name- 1 ) ~ <REXX prefix of 64 or fewer characters>...
  • Page 190 If neither this parameter nor any other parameters are specified, the command establishes all inter-CU logical paths. {FORWARD|REVERSE} Specify the direction in which the logical path is to be established. If neither is specified, the command will establish a bidirectional logical path. FORWARD The command establishes the logical paths that are identified in the path set stored in the path set structure specified by the STEM parameter.
  • Page 191: Ykconmsg Command

    Table 97 YKBLDPTH 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 192 Parameters MSGID({IEA494|IOSHM0414I|user-specified-message-ID}) Specifies the message to be monitored. IEA494 Monitors for IEA494I messages. IOSHM0414I Monitors for IOSHM0414I messages. user-specified-message-ID ~ <from 6 to 10 alphanumeric characters> Monitors for a user-specified message that indicates that a HyperSwap has been completed. TIMEOUT (timeout-value) ~ <numeric characters> ((0-60))<<15>> (timeout-value) ~ <numeric characters>...
  • Page 193: Ykdelcmd Command

    NOTE: In some configurations such as when BC and CA share volumes or a 1 to n (n is greater than 1) configuration of BC, the status transitions of each copy pair might not be correctly monitored. When using a copy pair on a remote site (a site that is not channel-connected directly from the local host), there are the following restrictions: ◦...
  • Page 194 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> When you delete the command device for a storage system in the route list, specify the storage system serial number.
  • Page 195: 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. If you delete command devices for a storage system for which multiple command devices have been defined, processing continues even if an error occurs for one or more of the command devices.
  • Page 196: Ykdelete Command

    Format YKDELETE STEM(stem-name-1) MSG(stem-name-2) DEVN(p-vol-device-number,s-vol-device-number)] 1SELECT({ALL|COND})] Function This command is a TSO/E command called from REXX scripts. This command dissolves a copy pair for the specified copy group and changes the volume status to the SIMPLEX status. When dissolving copy pairs in an EXCTG container, if all copy pairs are dissolved from a journal group, that journal group will be deleted from the EXCTG.
  • Page 197: 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 198 [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 199 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 200: Ykdrop Command

    NOTE: Before executing the command, create and load the path set definition file. If a message that contains sense information for the storage system is output, see the list of error codes in the HP P9000 for Business Continuity Manager Software Messages and then eliminate the cause of the error.
  • Page 201 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 202: Ykenv Command

    Return codes The table below lists and describes the return codes that are returned when the YKDROP command terminates. Table 102 YKDROP Command Return Code List Return code Meaning The command terminated normally. The caller is not a REXX environment (environment error). 1004 There is an error in the specified process classification.
  • Page 203 Table 103 YKENV Command Return Code List Return code Meaning The command terminated normally. —2 A module could not 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 204: Ykercode Command

    Table 104 Items Output by the YKENV Command (continued) Output item Description Value of the system symbol &YKLOGPT. If &YKLOGPT is &YKLOGPT = not set, N/A is displayed. Value of the Business Continuity Manager environment SYSLOG = variable SYSLOG, which was set by the YKSETENV command.
  • Page 205: Ykewait Command

    READY YKERCODE 6A13 Error details: The command could not be executed because a remote command was executed while the command device was not defined. Type of error: Others. Return codes Table 105 (page 205) lists the return codes that are returned when the YKERCODE command terminates.
  • Page 206: Ykewait Command

    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. You must also include a trailing period character. The message structure is initialized when the CLI command with the same name as the MSG parameter is specified.
  • Page 207 SWAPPING Applies to Continuous Access Synchronous for Mainframe, Continuous Access Synchronous for Mainframe with the HyperSwap attribute, Continuous Access Asynchronous for Mainframe, and Continuous Access Journal for Mainframe. The command waits until all copy pairs in the group reach the SWAPPING status. However, if the status of any copy pair changes to the SIMPLEX, HOLD, HOLDER, HOLDTRNS, NODELTA, CONSLOST, or INVALID status, the YKEWAIT command terminates abnormally with return code TIMEOUT(timeout-value) ~ <numeric characters>...
  • Page 208 When the command monitors the status of a copy pair in an BC copy group to which the CAJ ATTIME suspend time has been set, the check operation differs depending on whether the NOINVALIDCHECK parameter is specified: If the NOINVALIDCHECK parameter is not specified The status of the CAJ copy pair at the time of BC copy pair suspension will be checked.
  • Page 209: Ykexport Command

    Table 107 YKEWAIT Command Return Code List (continued) Return Code Meaning The command completed normally. The timeout interval expired before the group status changed to the requested group status. For CG containers specified by EXCTG ID, a timeout occurred before all journal groups were registered in EXCTG.
  • Page 210: Ykfcstat Command

    Before you execute this command, allocate datasets for the CSV files under the following DD names and catalog the files: Pair information CSV file: OUTPAIR EXCTG information CSV file: OUTEXCTG For details about CSV files, see “CSV Files Used by the Copy Group Definition File Generation Function”...
  • Page 211 Function This is a TSO/E command called from REXX scripts. This command acquires the FlashCopy information related to the specified volume from the storage system, and stores the information into the FlashCopy information structure that was specified by the STEM parameter. If the specified volume is not found, or an I/O error occurred and the storage system information cannot be acquired, this command creates an error message in the command return configuration structure, and then returns a return code other than 0.
  • Page 212: Ykfreeze Command

    Table 109 YKFCSTAT Command Return Code List (continued) Return Code Meaning Terminating due to processing errors. Terminating due to invalid parameters. The command terminated abnormally. The user does not have permission to execute this command. YKFREEZE Command Applies to Continuous Access Synchronous for Mainframe. Format YKFREEZE STEM(stem-name-1)
  • Page 213: Ykh2B Command

    Table 1 10 YKFREEZE 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 214 definition file created using the YKH2B command on the ISPF panel, the maximum length of the prefix that can be specified is 16 characters. DEVN(device-number- 1 , device-number-2) ~ <4-digit hexadecimal number> Specify the first and last device numbers for the range for searching for copy pairs. For device-number- 1 , specify the starting DEVN for the search range.
  • Page 215: Ykimport Command

    Table 1 1 1 YKH2B Command Return Code List Return Code Meaning The command terminated normally. A copy group definition file was created. The command terminated normally. No copy pairs were detected within the specified device number range. Although a copy group definition file was generated, undefined volume information was detected in the disk configuration definition file at the site specified by the DAD parameter for a pair that is within the range specified by the DEVN parameter.
  • Page 216: Ykimport Command

    For details about CSV files, see “CSV Files Used by the Copy Group Definition File Generation Function” (page 350). Parameters PREFIX(prefix) ~ < prefix of 25 or fewer characters> Specify the prefix of the copy group definition file BASEGROUP(copy-group-ID) ~ < GROUP string> Specify the name of the copy group definition file without the prefix.GRP part that is to be used as the base.
  • Page 217: Ykinschk Command

    YKINSCHK Command Format YKINSCHK Function This command is a TSO/E command called from REXX scripts. This command verifies whether the settings required during an installation and setup have been specified correctly. Then, this command outputs a verification-result message and the setting information to the TSO/E panel.
  • Page 218 Table 1 14 YKINSCHK Command Output Items (continued) Output item Explanation Outputs the user SVC version that is currently enabled. If version information cannot be Current User SVC: acquired, N/A is output. Version Outputs the SVC number of the user SVC that was registered dynamically by the Dynamic registered YKALCSVC command.
  • Page 219: Ykload Command

    The current users SVC routine registration number and version are listed above. User SVC numbers and versions that have not been acquired are listed as N/A. If a Dynamic registered User SVC exists, the Dynamic registered User SVC will become the Current User SVC. If a Dynamic registered User SVC does not exist and a Static installed User SVC exists, the Static installed User SVC will become the Current User SVC.
  • Page 220 Which configuration file is loaded and which REXX variable structure is created depends on the specified parameters. For details about REXX variable structures, see “About REXX Variable Structures” (page 319). Table 1 15 (page 220) describes which configuration files result in which REXX variable structures for each parameter.
  • Page 221 This parameter should be specified in the following cases: When using the Cnt-Ac S Z Consistency Preservation function When the Remote DKC Control function is used. route-list-ID ~ <ROUTE character string of eight or fewer characters> Specify the route list ID. {route-label|*} ~ <ROUTELABEL character string of eight or fewer characters>...
  • Page 222 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 223: Ykmake Command

    Table 1 16 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 224 NOCOPY Applies to Continuous Access Synchronous for Mainframe, Continuous Access Asynchronous for Mainframe, and Continuous Access Journal for Mainframe. The command makes a copy pair without copying between P-VOL and S-VOL. The command is used only when the two volume status are exactly the same. HOLD Applies to Continuous Access Journal for Mainframe.
  • Page 225 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 226: 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 227 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 228: Ykqrypth Command

    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. If this parameter is omitted, even if the PATH parameter is specified, the command will only acquire inter-CU logical path information (without acquiring inter-DKC logical path information).
  • Page 229 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 230 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 acquired in all cases where the CU number of the RCU matches the value specified for this parameter. Inter-DKC logical paths are not affected by this parameter.
  • Page 231 NOTE: Before executing the command, create and load the path set definition file. If a message that contains sense information for the storage system is output, see the list of error codes in the HP P9000 for Business Continuity Manager Software Messages and then eliminate the cause of the error.
  • Page 232: Ykquery 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. Format YKQUERY STEM(stem-name-1) MSG(stem-name-2) DEVN(device-number)] TO({PRIMARY|SECONDARY})]|VERIFY}] Function This command is a TSO/E command called from REXX scripts.
  • Page 233 VERIFY If this parameter is specified, the command checks the copy group structure, provided that the copy pair is not in the 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 P9000 for Business Continuity Manager Software Users Guide.
  • Page 234: Ykrecver Command

    Table 121 YKQUERY Command Return Code List (continued) Return Code Meaning An error occurred when the suspend processing was performed by using the CAJ ATTIME suspend function. The status of the CAJ copy pair was invalid when the suspend processing was performed by using the CAJ ATTIME suspend function.
  • Page 235: Ykrecver Command

    When dissolving copy pairs in a CG container specified by EXCTG ID, if all copy pairs are dissolved from a journal group, that journal group will be deleted from the EXCTG. In addition, if all journal groups are deleted from the EXCTG, the EXCTG data will be deleted. Parameters STEM(stem-name- 1 ) ~ <REXX prefix of 64 or fewer characters>...
  • Page 236: Ykresync Command

    YKRESYNC Command Applies to Business Copy for Mainframe, Continuous Access Synchronous for Mainframe, Continuous Access Synchronous for Mainframe with the HyperSwap attribute, Continuous Access Asynchronous for Mainframe, and Continuous Access Journal for Mainframe. Format YKRESYNC STEM(stem-name-1) MSG(stem-name-2) SELECT({ALL|COND})] {QUICK|NORMAL}]}[ {FORWARD|REVERSE}][ DEVN(p-vol-device-number, s-vol-device-number)][ VOLUNIT]...
  • Page 237 Specify the copy mode. QUICK Transit to the DUPLEX status quickly. NORMAL Transit to the DUPLEX status after copy completion. {FORWARD|REVERSE} Specify the copy direction. Based on the information updated since transiting to the SUSPOP status, the differences are copied for tracks and cylinders, and the DUPLEX status is recovered.
  • Page 238 Perform a delta resync. Copy to S-VOL only the journals on the P-VOL side that have a differential with the journals on the S-VOL side. After copying the differential, perform a transition to the DUPLEX status. ALLJNL Applies to Continuous Access Journal for Mainframe. Perform a delta resync with full copy to resynchronize delta resync pairs.
  • Page 239 Table 123 Example Procedure Using the ERRCHK Parameter After Transition to HOLDER Status (continued) Command Description When this command is executed, the message YKRESYNC STEM(SF.TO.LA.) MSG(MSG.) that displays the cause is output, so you need to DELTAJNL ERRCHK SELECT(COND) identify and fix the error. Recovers pairs in failure status to HOLD status.
  • Page 240 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 241: Ykrun Command

    Table 124 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 242: Ykscan Command

    Table 125 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 243: 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 244: Yksleep Command

    Table 126 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 245: 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 246: Ykstore Command

    Return Codes Table 128 (page 246) lists the return codes to be returned when the YKSTATS command terminates. Table 128 YKSTATS 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.
  • Page 247: Yksuspnd Command

    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. You must also include a trailing period character. The message structure is initialized when the CLI command with the same name as the MSG parameter is specified.
  • Page 248 s-vol-device-number)][ VOLUNIT]| FLUSH[ SVOL({PROTECT|PERMIT})][ DEVN(p-vol-device-number, s-vol-device-number)][ VOLUNIT]| QUICK[ SVOL({PROTECT|PERMIT})][ DEVN(p-vol-device-number, s-vol-device-number)][ VOLUNIT]| FORWARD[ SVOL({PROTECT|PERMIT})][ DEVN(p-vol-device-number, s-vol-device-number)][ VOLUNIT]| REVERSE[ SVOL({PROTECT|PERMIT})][ DEVN(p-vol-device-number, s-vol-device-number)][ VOLUNIT]} SELECT({ALL|COND})] Function This command is a TSO/E command called from REXX scripts. This command suspends a copy pair for the specified copy group and changes the volume status to the SUSPOP status.
  • Page 249 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. You must also include a trailing period character. The message structure is initialized when the CLI command with the same name as the MSG parameter is specified.
  • Page 250 This value means that the specified time is in GMT. NOTE: When you specify the time using ATTIME parameter, note the following: Do not specify a time value earlier than the command execution time. The processing might be suspended when the specified time is reached during command execution.
  • Page 251 elapsed, suspension will take place. In this case, data consistency is guaranteed, however, suspend processing might be delayed. GENID(generation-id) ~ <2-digit hexadecimal number><<00>> Applies to Business Copy for Mainframe, Continuous Access Asynchronous for Mainframe. Specify a generation ID. The default value (used when this parameter is omitted) is 00. Generation IDs can be used as a generation number used for identifying the generation of backups.
  • Page 252 Table 131 Operation When the ATTIME Suspend Time Is Canceled in BC (continued) Target storage system Setting of the ATTIME suspend time Operation when the ATTIME suspend time is or copy group canceled CAJ ATTIME NORMAL ATTIME CAJ ATTIME suspend NORMAL ATTIME suspend time suspend time...
  • Page 253 The S-VOL can be read or written even when data is being copied. When this parameter is not specified, the S-VOL can be read or written after data copying, and transition to the SUSPOP status have finished. For details on what happens when the ATTIME parameter is specified for the NORMAL ATTIME suspend function, see the HP P9000 Business Copy for Mainframe Systems User Guide: HP XP24000 Disk Array, HP XP20000 Disk Array or the HP P9000 Business Copy for z/OS User Guide: HP XP12000 Disk Array, HP XP10000 Disk Array, HP 200 Storage Virtualization System.
  • Page 254 SVOL ({PROTECT|PERMIT}) Specify whether writing to the S-VOL is permitted or protected after a volume is suspended (SUSPOP). When this parameter is not specified, the value specified in the ISPF panel is assumed. If the ATTIME parameter or CANCEL parameter are both specified, this specification is disregarded, and the write permissions for the S-VOL during the suspend are canged as follows, depending on the copy type: Copy type...
  • Page 255 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. The YKSUSPND command terminates successfully when the instruction to the copy pair succeeded. Even if the YKSUSPND command has terminated with return code 0, the copy pair might not be in the SUSPOP or SWAPPING status.
  • Page 256: Ykwatch Command

    Table 132 YKSUSPND Command Return Code List (continued) Return Code Meaning When the copy pair corresponding to the device number specified with the DEVN parameter is not found. When the VOLUNIT parameter or DEVN parameter, and the PURGE parameter are specified for a CAJ at the same time. For a CAA, when an attempt to cancel the ATTIME suspend time for the remote storage system was made.
  • Page 257 SUSPEND The command waits until all the copy pairs in the group reach the SUSPOP status. However, if the status of any copy pair changes to a status other than a suspend status (SUSPOP, SUSPCU, or SUSPER) or TRANS, the YKWATCH command terminates abnormally with return code 8. SIMPLEX The command waits until the copy pairs reach the SIMPLEX status.
  • Page 258: Ykwtomsg Command

    NOTE: In some configurations such as when CA and BC 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. When using a copy pair on a remote site (a site that is not channel-connected directly from the local host), the YKWATCH command cannot monitor the status transition of the copy pair on the remote site.
  • Page 259 Function This is a REXX function that is called from within a REXX script. This command outputs the specified message ID and message text to the OS console. Parameters type Specify the type of message to be output. The message is output by using the destination indicating a code that corresponds to the specified type.
  • Page 260: Cli Command Coding Examples

    Table 134 YKWTOMSG Command Return Code List (continued) Return code Meaning A system error occurred. 2000 Other than above Refer to the return code of the WTO macro. For details, see the IBM documentation MVS Programming: Assembler Services Reference. CLI Command Coding Examples Coding examples for each CLI command are stored in the sample library HPQYSAMT as sample scripts.
  • Page 261: Ykdemo01

    Table 135 List of Sample Scripts (continued) Sample script name Overview Uses the following CLI commands to demonstrate acquiring information YKDEMO05 about copy pairs in a copy group, and acquiring operating information: YKLOAD YKQUERY YKSTATS Shows an example of using the YKWATCH command. YKDEMO06 Shows an example of using the YKRECVER command.
  • Page 262 /**********************************************************************/ /* Sample script begins. */ say "#-- BEGIN YKDEMO01."; address TSO "YKENV" * YKLOAD should always be called to make information about a copy * group available from the REXX environment. In this YKLOAD calling, * the information about "MYTCS" in "BCM.DEMO" is loaded and stored * into the REXX variable structure beginning with "DEMO_INFO.".
  • Page 263 * YKQUERY and YKEWAIT update the Copy Group structure. * To use YKEWAIT for the purpose of simply updating the Copy Group * structure, make sure the following parameter specification. - TIMEOUT parameter should have the value zero ("0") for immediate completion of YKEWAIT.
  • Page 264 end; else nop; call printCopyGroupStatus; * Suspend all copy pairs in MYTCS copy group. * Like YKMAKE, use SELECT(COND) to let YKSUSPND skip a copy pair * which is already being suspended. * Although you can omit specification of FORWARD/REVERSE parameter, * it is strongly recommended to specify the parameter to clarify * your intention.
  • Page 265 exit; end; else nop; * Wait until all copy pairs in MYTCS copy group become DUPLEX. address TSO "YKEWAIT STEM(DEMO_INFO.) MSG(DEMO_MSG.) GOTO(DUPLEX)", "TIMEOUT(30)"; * Check the return code to see if it is 0 or not. if rc /= 0 then do call printErrorMessage;...
  • Page 266: Ykdemo02

    * 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 267: Ykdemo03

    address TSO "YKFCSTAT STEM(DEMO_INFO.) MSG(DEMO_MSG.) DEVN(####)"; /* Check the return code of YKFCSTAT to see if it is 0 or not. if rc /= 0 then do call printErrorMessage; exit; end; else nop; * DEMO_INFO.TARGET.STATE0 shows the status of a FlashCopy pair. * STATE0 = 0 means that there is no FlashCopy relationship so that * the TrueCopy pairs can be resynchronized.
  • Page 268 /* YKDEMO03 - A sample demonstration script that illustrates how to use the Business Continuity Manager's REXX CLI commands for establishing and deleting routes (command devices) and logical paths between two storage systems. This sample script first establishes logical paths from the primary storage system to the secondary storage system.
  • Page 269 * Check the return code to see if it is 0 or not. if rc /= 0 then do call printErrorMessage; exit; end; else nop; * Query for the information of the logical paths that were built * in the previous call of YKBLDPTH. The updated information will be * stored in the REXX variable under "DEMO_INFO.PATH".
  • Page 270 else nop; * Build the command device in the secondary storage system. * You must specify the serial number of the storage system with * "SN" parameter such as "SN(12345)". address TSO "YKBLDCMD SN(#####) MSG(DEMO_MSG.)"; * Check the return code to see if it is 0 or not. if rc /= 0 then do call printErrorMessage;...
  • Page 271 * STEM parameter. * The following code shows one way to use YKQRYDEV with SN, CU, and * CCA parameters, such as follows: "SN(12345) CU(10) CCA(20)" address TSO "YKQRYDEV STEM(DEMO_CDEVS.) SN(#####) CU(##) CCA(##)", "MSG(DEMO_MSG.)"; * Check the return code to see if it is 0 or not. if rc /= 0 then do call printErrorMessage;...
  • Page 272: Ykdemo04

    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; exit; end; else nop; * Delete the logical paths to clean up the configuration. * If a logical path is defined and built as a "shared"...
  • Page 273 use the Business Continuity Manager's REXX CLI commands for using Extended C/T Group feature of TrueCopy Synchronous. This script will continue monitoring for IEA494I message for a suspended copy pair in the given TC-Sync copy group for 120 seconds. This sample script uses the following CLI commands. - YKLOAD - YKEWAIT - YKCONMSG...
  • Page 274 * Use YKCONMSG with OP(OPEN) parameter to establish the EMCS console * interface for monitoring IEA494I message. Use OUTTRAP instruction * of REXX to acquire the handler value that needs to be referenced * in the subsequent YKCONMSG calls. The return code for successful * completion of YKCONMSG with OP(OPEN) is 0.
  • Page 275 * Check to see if the captured IEA494I message is * generated due to the relevant copy pair in the TC-Sync * copy group becoming suspended. * Modify the value of 'myDevn' below to the device number * of a volume of a relevant copy pair to run this script. myDevn = "####";...
  • Page 276 "HANDLE(x'"HandlerValue"')"; * 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 say "YKCONMSG OP(CLOSE) failed."; else nop;...
  • Page 277: Ykdemo05

    say "Value = " || DEMO_MSG.x.Value; end; return 0; YKDEMO05 /* REXX /**********************************************************************/ /* All Rights Reserved. Copyright (C) 2007, 2010, Hitachi, Ltd. /**********************************************************************/ /* YKDEMO05 - A sample demonstration script that illustrates how to use the Business Continuity Manager's REXX CLI commands for obtaining various copy group information.
  • Page 278 call printErrorMessage; exit; end; else nop; * Establish all copy pairs in MYTCA 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 279: Ykdemo06

    * YKSTATS are shown here. Refer to the Business Continuity Manager * Reference Guide for the list of all information items that you can * obtain via YKQUERY and YKSTATS. * For C/T Delta value, this sample script shows the value from just * one copy pair.
  • Page 280 /* YKDEMO06 - A sample demonstration script that illustrates how to use the Business Continuity Manager's YKWATCH command. This sample script assumes the following settings. 1) The definition files are stored in the dataset with the prefix "BCM.DEMO". 2) TC-Sync copy group is used. The copy group ID is "MYTCS". 3) The route list ID is "DEMORLST".
  • Page 281: Ykdemo07

    if rc /= 0 then do call printErrorMessage; exit; end; else nop; * Use YKWATCH to let BC Manager notify the state transition of MYTCS * when it became DUPLEX. You may use YKWATCH for other copy group * statuses, too. * In this example, YKWATCH monitors MYTCS copy group to become * DUPLEX for 30 minutes, and notifies a user about such status * transition by sending a notification message to the current user's...
  • Page 282 3) The route list ID is "DEMORLST". 4) The primary Device Address Domain ID is "PRIM". /**********************************************************************/ /* Sample script begins. */ say "#-- BEGIN YKDEMO07."; address TSO "YKENV" * YKLOAD should be called before manipulating MYTCS to make definition * information of MYTCS available on the REXX environment.
  • Page 283: Ykdemo08

    address TSO "YKEWAIT STEM(DEMO_INFO.) MSG(DEMO_MSG.) GOTO(DUPLEX)", "TIMEOUT(30)"; * Check the return code to see if it is 0 or not. if rc /= 0 then do call printErrorMessage; exit; end; else nop; * The line below shows how to execute YKRECVER. * The situation in which you have to use this command is rare, but * this command is useful when the primary site failed and a copy * group between the primary and the secondary sites cannot be...
  • Page 284 perform fail-over operations in a 2DC configuration with HyperSwap and UR. This script can be used when storage system at the primary site has been stopped for a storage system maintenance or because a storage system failure has occurred. This sample script assumes the following settings: 1) The definition files are stored in the dataset with the prefix "BCM.DEMO".
  • Page 285 * Check the return code of YKLOAD. if result /= 0 then do call printErrorMessage exit else * Check the status of MYTCHS to confirm the ready status for operations * in 2DC configuration with HyperSwap and UR. address TSO "YKEWAIT STEM(DEMO_INFO.MYTCHS.) MSG(DEMO_MSG.)", "GOTO(DUPLEX) TIMEOUT(0) NOINVALIDCHECK"...
  • Page 286 else * Use YKCONMSG with the OP(OPEN) and MSGID(IOSHM0414I) parameters * to establish the EMCS console interface to monitor the IOSHM0414I * message. Use the REXX instruction OUTTRAP to acquire the handler * value that needs to be referenced in subsequent YKCONMSG calls. * The return code for the successful completion of YKCONMSG with the * OP(OPEN) parameter is 0.
  • Page 287 * Extract the message body from the captured IOSHM0414I string. parse var MyHandle.1 . IOSHM0414Imsg * Check to see if the captured IOSHM0414I message is * generated due to the relevant copy pair in the MYTCHS * copy group performing a planned or unplanned HyperSwap. PlannedFound = pos("Planned", IOSHM0414Imsg) UnplannedFound = pos("Unplanned", IOSHM0414Imsg) * If a HyperSwap has occurred in the relevant copy pair,...
  • Page 288 " MSG(DEMO_MSG.) GOTO(SWAPPING)", " TIMEOUT(0)" * Check the return code of YKEWAIT. if rc /= 0 then do call printErrorMessage leave /* Exit the loop. */ 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.)", "...
  • Page 289 call printErrorMessage leave /* Exit the loop. */ else * Wait for completion of copying from the local site to * the remote site. address TSO "YKEWAIT STEM(DEMO_INFO.MYUR2.) MSG(DEMO_MSG.)", "GOTO(DUPLEX) TIMEOUT(30)" * Check the return code of YKEWAIT. if rc /= 0 then do call printErrorMessage leave /* Exit the loop.
  • Page 290: Ykdemo09

    * 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 291 call "YKLOAD" "STEM(DEMO_INFO.MYTCHS.) PREFIX(BCM.DEMO) GROUP(MYTCHS)", "DAD(PRIM) MSG(DEMO_MSG.) ROUTE(DEMORLST)" * Check the return code of YKLOAD. if result /= 0 then do 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...
  • Page 292 say "recover to ready state for DeltaResync", "from failure configuration." * Delete the MYUR1 copy pair when a failure occurs. address TSO "YKDELETE STEM(DEMO_INFO.MYUR1.) MSG(DEMO_MSG.)" * Check the return code of YKDELETE. if rc /= 0 then do call printErrorMessage else * Confirm that the status of the MYUR1 copy pair is one where * the copy pair can be copied.
  • Page 293 address TSO "YKMAKE STEM(DEMO_INFO.MYUR1.) MSG(DEMO_MSG.) HOLD" * Check the return code of YKMAKE. if rc /= 0 then do call printErrorMessage else * Confirm that the status of the MYUR1 copy pair is one where a * DeltaResync can be performed. address TSO "YKEWAIT STEM(DEMO_INFO.MYUR1.) MSG(DEMO_MSG.)", "GOTO(HOLD) TIMEOUT(10)"...
  • Page 294 * Suspend the MYUR2 copy pair to change the status of MYUR2 * to one where a DeltaResync can be performed. address TSO "YKSUSPND STEM(DEMO_INFO.MYUR2.)", "MSG(DEMO_MSG.) FLUSH" * Check the return code of YKSUSPND. if rc /= 0 then do call printErrorMessage exit else...
  • Page 295: Ykdemo10

    * Check the return code of YKEWAIT. if rc /= 0 then do call printErrorMessage exit else say "#-- END YKDEMO09." exit * printErrorMessage: This procedure prints all of the error messages in the Message structure when a CLI command failed. printErrorMessage: procedure expose DEMO_MSG.
  • Page 296: Ykdemo1S

    address TSO "YKQRYDEV STEM(DEMO.) DEVN("op_devn") MSG(MSG.)"; retcode = rc; * Check the return code of YKQRYDEV. if retcode /= 0 then do * Found errors during YKQRYDEV. Writing USR001E message with * return code of the command to MCS console. Then, terminate * the script.
  • Page 297: Ykdemo12

    /* Below is a list of local variables that store BCM environment /* variables. The default value for each is "N/A". Local Variable Description -------------------------------------------------------------- HostID Host ID LicDSN Prefix of the license information dataset BCMLog Output method of the BCM log CLILog Output setting for the CLI command-execution logs /**********************************************************************/...
  • Page 298 This sample script assumes the following settings. 1) The definition files are stored in the dataset with the prefix "BCM.DEMO". 2) TC-Sync copy group is used. The copy group ID is "MYTCS". 3) The route list ID is "DEMORLST". 4) The primary Device Address Domain ID is "PRIM". The details for this sample script are as follows: 1) Call YKLOAD to load a configuration definitions.
  • Page 299 Address TSO "YKDELETE STEM(DEMO_INFO.) MSG(DEMO_MSG.)", "DEVN("P_DEVN","S_DEVN")" * Check the return code of YKDELETE. If rc /= 0 Then Call PrintErrorMessage Exit Else * Confirm that the status of the deleted pair is one where * the copy pair can be copied. Address TSO "YKEWAIT STEM(DEMO_INFO.) MSG(DEMO_MSG.)", "GOTO(SIMPLEX) TIMEOUT(1) NOINVALIDCHECK", "DEVN("P_DEVN","S_DEVN")"...
  • Page 300 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 = " || DEMO_MSG.x.Severity Say "Text = "...
  • Page 301: 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 301) “Dataset Formats and Required Disk Capacity for the Configuration File” (page 301) “XML Document Type Definitions”...
  • Page 302 Table 136 (page 302) describes the meaning of the symbols used in the formulas of this section. Table 136 Meaning of the Symbols Used in the Formulas Symbol Meaning Number of copy groups included in the copy group definition file Number of copy pairs included in the copy group definition file Size to be increased when the EXCTG attribute is defined.
  • Page 303: Xml Document Type Definitions

    Table 138 Required Disk Space for the Configuration File (continued) Type of the configuration file Size (bytes) + E x 180 Route list definition file + F x 90 + G x 90 Command device definition file + H x 200 + K x 200 Path set definition file + I x 1,240...
  • Page 304 The XML data objects described here are valid within the APIInfo elements with the attribute Level = 6.7.1. <!ELEMENT APIInfo(CopyGroupContainer|HostDiscoveredArray|RouteList|CDEVContainer|CDEVGRP|Paths)> <!ATTLIST APIInfo Level (6.7.1)#REQUIRED UpdateID CDATA#IMPLIED > The following table gives the meaning of the attribute of the APIInfo elements. Attribute name Meaning API level...
  • Page 305 Attribute name Meaning Copy pair matching rate MatchingPerCent Whether direction is reverse from Secondary to Primary Reversed Copy Pair <!ELEMENT CopyPair(PairState,DiskDevice,DiskDevice)> TC Option <!ELEMENT TC_Options(EMPTY)> <!ATTLIST TC_Options GroupID CDATA#IMPLIED FenceLevel (DATA|STATUS|NEVER)#REQUIRED FreezeScpMode (Y|N)#IMPLIED TimeStampMode (Y|N)#IMPLIED (CYL|TRK)#IMPLIED OpenMF (Y|N)#IMPLIED The following table gives the meanings of the attributes of the TC_Options elements. Attribute name Meaning Consistency group ID...
  • Page 306 <!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 GroupID Whether to use the UR ATTIME suspend function PresetMode Suspend mode used by the UR ATTIME suspend function.
  • Page 307 RSF_CT CDATA#REQUIRED JNL_Meta CDATA#REQUIRED JNL_Data CDATA#REQUIRED JNL_Trfr CDATA#REQUIRED JNL_Cache_Capacity CDATA#REQUIRED JNL_Data_Capacity CDATA#REQUIRED > The following table gives the meanings of the attributes of the DKCState elements. Attribute name Meaning Storage system serial number SerialNum Write pending rate WPR_All Reserve sidefile cache-usage rate RSF_All Reserve sidefile cache-usage rate for C/T RSF_CT...
  • Page 308 SuspendCuCt CDATA#IMPLIED SuspendErCt CDATA#IMPLIED SwappingCt CDATA#IMPLIED TransitionCt CDATA#IMPLIED InvalidCt CDATA#IMPLIED ReversedCt CDATA#IMPLIED HoldCt CDATA#IMPLIED HoldErCt CDATA#IMPLIED ChkJnlCt CDATA#IMPLIED HoldTrnsCt CDATA#IMPLIED NoDeltaCt CDATA#IMPLIED ConslostCt CDATA#IMPLIED CurrentTime CDATA#IMPLIED MatchingPercent CDATA#IMPLIED InitPace (SLOW|NORMAL)#IMPLIED ProtectMode (PROTECT|PERMIT)#REQUIRED LinkageOption (NONE|HS)#IMPLIED > The following table gives the meanings of the attributes of the CopyGroup elements. Attribute name Meaning Copy group ID...
  • Page 309 Attribute name Meaning Protect mode ProtectMode Linkage option LinkageOption CG Container <!ELEMENT CopyGroupContainer(ExctgDef?,CopyGroup*)> <!ATTLIST CopyGroupContainer ContainerID ID#REQUIRED Format (SIMPLE)#IMPLIED Description CDATA#IMPLIED MatchingPerCent CDATA#IMPLIED SimplexCt CDATA#IMPLIED PendingCt CDATA#IMPLIED DuplexCt CDATA#IMPLIED TransitionCt CDATA#IMPLIED SuspendCuCt CDATA#IMPLIED SuspendOpCt CDATA#IMPLIED SuspendVSCt CDATA#IMPLIED SuspendErCt CDATA#IMPLIED InvalidCt CDATA#IMPLIED SwappingCt CDATA#IMPLIED...
  • Page 310 Attribute name Meaning REVRSY count RevresyncCt 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 CONSLOST count ConslostCt Whether to use the EXCTG function ExctgEnable ExctgDef <!ELEMENT ExctgDef(EX_DefInfo)>...
  • Page 311 FwdArbCmdNo CDATA#IMPLIED RevArbCmdNo CDATA#IMPLIED > The following table gives the meanings of the attributes of the EX_DefDKC elements. Attribute name Meaning Storage system model during a forward operation FwdModel Storage system model during a reverse operation RevModel Storage system serial number during a forward operation FwdSerialNum Storage system serial number during a reverse operation RevSerialNum...
  • Page 312 Shared (Y|N)#IMPLIED PriModel CDATA#IMPLIED SecModel CDATA#IMPLIED PriIFType CDATA#IMPLIED SecIFType CDATA#IMPLIED PriSerialNum CDATA#REQUIRED SecSerialNum CDATA#REQUIRED PriSSID CDATA#REQUIRED SecSSID CDATA#REQUIRED PriCUNum CDATA#REQUIRED SecCUNum CDATA#REQUIRED PriCCA CDATA#IMPLIED SecCCA CDATA#IMPLIED > <!ELEMENT DKCPath(Ports*)> <!ATTLIST DKCPath Shared (Y|N)#IMPLIED PriModel CDATA#IMPLIED SecModel CDATA#IMPLIED PriIFType CDATA#IMPLIED SecIFType CDATA#IMPLIED PriSerialNum CDATA#REQUIRED...
  • Page 313 Attribute name Meaning The CCA of the device to which I/Os are issued when path operations PriCCA are performed on the primary site where the path is used. The CCA of the device to which I/Os are issued when path operations SecCCA are performed on the secondary site where the path is used.
  • Page 314 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 PriPort The target port number of the secondary site of the logical path SecPort Status of a logical path Status...
  • Page 315 The following table gives the meanings of the attributes of the CDEV elements. Attribute name Meaning Device number of the command device in the storage system Devn Volume serial number of the command device in the storage system Volser DAD ID to which a command device belongs DADID Host-Discovered Array <!ELEMENT HostDiscoveredArray...
  • Page 316: Configuration File Examples

    priority CDATA#IMPLIED > The following table gives the meanings of the attributes of the Route elements. Attribute name Meaning Device Address Domain ID DADID Route priority (fixed value of 1) priority 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...
  • Page 317: Example Contents Of Disk Configuration Definition File

    <ExctgDefDKC> <EX_DefDKC FwdModel="USPV" RevModel="USPV" FwdSerialNum="FGHK2" RevSerialNum="ABCD1"/> </ExctgDefDKC> </CopyGroup> <CopyGroup ID="LOS.TO.NY" PrimaryDADID="LOS" SecondaryDADID="NY" SimplexCt="0" DuplexCt="0" PendingCt="0" SuspendOpCt="0" SuspendCuCt="0" SuspendVSCt="0" SuspendErCt="0" TransitionCt="0" SwappingCt="0" RevresyncCt="0" InvalidCt="0" ReversedCt="0" HoldCt="0" HoldErCt="0" HoldTrnsCt="0" NoDeltaCt="0" InitPace="NORMAL" ProtectMode="PROTECT"> <CAJ_Options GroupID="03" subGroupID="04" MirrorID="1" ErrorLevel="GROUP"/> <CopyPair> <PairState Reversed="0"/> <DiskDevice SerialNum="14011" CUNum="00" SSID="1350" CCA="18"/> <DiskDevice SerialNum="14012"...
  • Page 318: Example Contents Of Path Set Definition File

    <?xml version="1.0" encoding="ebcdic-cp-us"?> <APIInfo Level="6.7.1"> <CDEVContainer DADID="LOS"> <CDEVGRP DADID="LOS" APID="0000"> <CDEV Devn="7355" DADID="LOS"> <DiskDevice SerialNum="ABCD1" CUNum="00" SSID="2350" CCA="15"/> </CDEV> <CDEV Devn="7315" DADID="NY"> <DiskDevice SerialNum="FGHK2" CUNum="00" SSID="2340" CCA="15"/> </CDEV> </CDEVGRP> <CDEVGRP DADID=LOS" APID="0001"> <CDEV Devn="7356" DADID="LOS"> <DiskDevice SerialNum="ABCD1" CUNum="00" SSID="2350" CCA="16"/> </CDEV>...
  • Page 319: About Rexx Variable Structures

    <Port PriPort="01" SecPort="01" /> </Ports> </DKCPath> </Paths> </APIInfo> About REXX Variable Structures The XML format configuration files in “XML Document Type Definitions” (page 303) are loaded to the REXX variable structures by YKLOAD command that Business Continuity Manager processes with the REXX variable structure. This section describes the REXX variable structures used in Business Continuity Manager.
  • Page 320 Table 140 Copy Group Structure (continued) REXX variables Description Count of copy pairs with reverse direction ReversedCt from Secondary to Primary (sum value of CopyGroup.n.ReversedCt) SUSPER count (sum value of SuspendErCt CopyGroup.n.SuspendErCt) INVALID count (sum value of InvalidCt CopyGroup.n.InvalidCt) REVRSY count (sum value of RevrsyncCt CopyGroup.n.RevrsyncCt) HOLD count (sum value of...
  • Page 321 Table 140 Copy Group Structure (continued) REXX variables Description Secondary TCA key (minimum value of SecTCAKeys Key.TCA in the Host-Discovered Array structure of the DKC at the secondary site) Secondary BC key (minimum value of SecBCKeys Key.BC in the Host-Discovered Array structure of the DKC at the secondary site) EXCTG function ExctgEnable...
  • Page 322 Table 140 Copy Group Structure (continued) REXX variables Description SUSPVS count SuspendVSCt SUSPER count SuspendErCt TRANS count TransitionCt Count of copy pairs with reverse direction ReversedCt from Secondary to Primary SWAPPING count SwappingCt REVRSY count RevrsyncCt HOLD count HoldCt HOLDER count HoldErCt CHKJNL count ChkJnlCt...
  • Page 323 Table 140 Copy Group Structure (continued) REXX variables Description Handling of P-VOL after suspending CA_FenceLevel NEVER STATUS DATA Unit of difference management CA_Map When Y, the Open/MF Consistency CA_OpenMF Preservation Function is used. Unit for suspending TCA_ErrorLevel GROUP VOLUME Flow Control TCA_FlowControl Unit of difference management TCA_Map...
  • Page 324 Table 140 Copy Group Structure (continued) REXX variables Description Model Exctg 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 325 Table 140 Copy Group Structure (continued) REXX variables Description Primary storage system serial number Pri_Serialnum Primary write pending rate Pri_WPR_All Primary reserve sidefile cache-usage rate Pri_RSF_All Primary reserve sidefile cache-usage rate Pri_RSF_CT for C/T Secondary storage system serial number Sec_Serialnum Secondary write pending rate Sec_WPR_All 9, 19...
  • Page 326 Table 140 Copy Group Structure (continued) REXX variables Description 1, 8, 19 C/T delta value CTDelta Volume serial number Volser Copy pair matching rate MatchingPerCent Whether direction is reverse from Reversed Secondary to Primary 1, 8, 19 Consistency time CTtime Diagnosis information Diagnosis Primary device number...
  • Page 327 Created for each CopyGroup information item. This value is the copy group number. Average matching rate of copy pairs in a copy group. Created for each Stats information item. Created for each Pair information item. The value is the copy pair number. The value acquired from the primary site is set.
  • Page 328: Host-Discovered Array Index Structure

    The following table shows the C/T delta values stored in the REXX variable. Condition Value that is set Copy group container that is not EXCTG Maximum C/T delta value for the entire consistency group EXCTG Minimum C/T delta value for the entire consistency group Copy group contains one or more consistency null...
  • Page 329: Host-Discovered Array Structure

    Created for each SN (storage system serial number), thus index information for each device connected to the host is created. Created for each CU, thus the device index information is created for each defined CU (CU number). The xx in CUxx is a hexadecimal value.
  • Page 330 Table 142 Host-Discovered Array Structure (continued) REXX variables Description Interface version IFType Physical DKC serial number PhysicalSerialNum Logical DKC number LDKCNum BC key Key.BC CA key Key.CA CAJ key Key.CAJ TCA key Key.TCA Non Gen'ed function flag NGDADIDEnable 0: Not a Non Gen'ed DAD ID 1: Non Gen'ed DAD ID One of the storage system IDs of a CU CUxx...
  • Page 331: Route List Structure

    Route List Structure Table 143 (page 331) shows the route list structure. The prefix for the name of the route list structure is HCC.ROUTELIST.dad-id. NOTE: You can use the YKDROP command to invalidate all the REXX variables in any route list structure that was loaded by using the YKLOAD command.
  • Page 332: Message Structure

    The information for the first command device in the storage system is set. This variable can be used if the MultiAccessEnable value is 0. In Business Continuity Manager 6.7.1 or later, however, HP recommends that you use a variable indicated by #5, even if the MultiAccessEnable value is 0.
  • Page 333 Table 145 Device Information Structure (continued) REXX variables Description 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 Existence of volume attribute information (Valid) Info Volume attribute...
  • Page 334 Table 145 Device Information Structure (continued) REXX variables Description Data inconsistency in the Cnt Ac-S copy pair CONSLOST (CONSLOST status) Y: The copy process of the related FlashCopy was interrupted. N: Normal status Status of path Path Active Inactive Fence level FenceLevel NEVER STATUS...
  • Page 335 Table 145 Device Information Structure (continued) REXX variables Description Copy pace InitPace SLOW NORMAL 6, 8 Consistency group ID C/T group timer type TimerType SYSTEM LOCAL NONE 6, 9 C/T status Status Consistency time (yyyymmdd hh:mm:ss.nnnnnn) Time Use of the Open/MF Consistency Preservation OpenMF Function.
  • Page 336 Table 145 Device Information Structure (continued) REXX variables Description SUSPVS (07) REVRSY (08) TRANS (09) Protect mode ProtectMode PROTECT PERMIT Copy pace InitPace SLOW NORMAL Copy pair matching rate MatchingPerCent SSID of P-VOL SSID Storage system serial number of P-VOL Serialnum CU number of P-VOL CUNum...
  • Page 337 Table 145 Device Information Structure (continued) REXX variables Description Number of Duplex copy pairs in the C/T group DuplexCt to which the specified device belongs Number of Resync copy pairs in the C/T group ResyncCt to which the specified device belongs Existence of CAJ ATTIME suspend information AT_CAJ Info...
  • Page 338 Table 145 Device Information Structure (continued) REXX variables Description Timeout value since the ATTIME suspend time Tout2 (minutes) Time remaining until timeout (minutes) Trem Consistency time for the CAJ copy group at CTTime suspension (yyyymmdd hh:mm:ss.nnnnnn) Existence of copy pair information (Valid) Info Number of CAJ copy pairs Existence of CAJ copy pair...
  • Page 339 Table 145 Device Information Structure (continued) REXX variables Description volume of the applicable volume, has been registered in EXCTG. Error level in CAJ ErrorLevel GROUP VOLUME EXCTG ID ExctgID SSID SSID Storage system serial number Serialnum CU number CUNum SSID SSID Storage system serial number Serialnum...
  • Page 340 Table 145 Device Information Structure (continued) REXX variables Description SSID1 of secondary storage system SSID1 SSID2 of secondary storage system SSID2 SSID3 of secondary storage system SSID3 SSID4 of secondary storage system SSID4 Number of physical paths in inter-CU logical path (0 to 8) Status of physical path Status...
  • Page 341: Path Set Structure

    Table 145 Device Information Structure (continued) REXX variables Description Target port number Sec.Port Existence of PSN information (Valid) Info Physical DKC serial number PhysicalSerialNum Logical DKC number LDKCNum When the information is acquired, Valid is stored. For Non Gen'ed volumes or remote storage system volumes, information cannot be obtained for the following storage system models: XP12000/XP10000 Disk Array XP24000/XP20000 Disk Array...
  • Page 342 Table 146 Path Set Structure REXX variables Description UpdateID Last update ID Path set ID Descriptions added by the user Description Number of logical paths used in path set Path type type Existence of sharing shared Serial number of primary storage system SerialNum Type of primary storage system Model...
  • Page 343: Flashcopy Information Structure

    Table 146 Path Set Structure (continued) REXX variables Description The CCA of the device to which I/Os are issued when path operations are performed on the secondary site where the path is used. The device number of the device to which I/Os are issued DEVN when path operations are performed on the secondary site where the path is used.
  • Page 344: Rexx Variables Updated By Ykquery And Ykewait Commands

    Table 147 FlashCopy Information Structure (continued) REXX variables Description Hardware information State5 Hardware information State6 Hardware information State7 Existence of a FlashCopy relationship: Target State0 0: No 1: Yes (copying) Existence of a FlashCopy in COPY mode relationship: State1 0: No 1: Yes (Copying in COPY mode) Existence of a FlashCopy in NOCOPY mode relationship: State2...
  • Page 345 Table 148 REXX Variables Updated by YKQUERY and YKEWAIT (continued) REXX variables YKQUERY YKEWAIT DEVN DEVN not DEVN specified DEVN not specified specified specified ReversedCt SuspendErCt InvalidCt RevrsyncCt HoldCt HoldErCt HoldTrnsCt NoDeltaCt ConslostCt CTDelta MatchingPerCent CopyGroup SimplexCt DuplexCt InvalidCt PendingCt SuspendOpCt SuspendCuCt SuspendVSCt...
  • Page 346: Rexx Variables Updated By Ykquery Command With The To Parameter Specified

    Table 148 REXX Variables Updated by YKQUERY and YKEWAIT (continued) REXX variables YKQUERY YKEWAIT DEVN DEVN not DEVN specified DEVN not specified specified specified JNLGValid JNLGType JNLState ErrorCode Pair specified- State pairs CTDelta MatchingPerCent Reversed CTtime Diagnosis other-pairs State CTDelta MatchingPerCent Reversed CTTime...
  • Page 347 Table 149 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 SuspendOpCt SuspendCuCt SuspendVSCt SwappingCt ReversedCt SuspendErCt InvalidCt RevrsyncCt HoldCt HoldErCt HoldTrnsCt NoDeltaCt ConslostCt...
  • Page 348 Table 149 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 CurrentTime CTTime CTDelta 2, 5 MatchingPerCent Exctg ArbCTTime JNLGValid JNLGType JNLState ErrorCode ArbCTTime...
  • Page 349: Rexx Variables Updated By The Ykewait Command With The To Parameter Specified

    REXX Variables Updated by the YKEWAIT Command with the TO Parameter Specified Table 150 (page 349) shows the copy group structure's REXX variables that are updated by the YKEWAIT command with the TO parameter specified. The table omits REXX variables that are not affected by the YKEWAIT command.
  • Page 350: Csv Files Used By The Copy Group Definition File Generation Function

    Table 150 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 HoldCt HoldErCt HoldTrnsCt NoDeltaCt ConslostCt CurrentTime Pair State Reversed Because information cannot be acquired, 0 is set.
  • Page 351: Specification Format For Csv Files

    Table 152 Disk Requirements for CSV Files Type of CSV file Size (bytes) Pair information CSV file 90 x number of copy pairs EXCTG information CSV file 70 x number of copy groups Specification Format for CSV Files Coding Rules This section describes the format to follow when writing a CSV file.
  • Page 352 Item name Value to be specified Data type Length (characters) Storage system serial Alphanumeric 1 - 5 number of the secondary site CU number of the secondary Hexadecimal 1 - 2 site CCA number of the Hexadecimal 1 - 2 SCCA secondary site Consistency group ID...
  • Page 353: 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 354: Examples Of Csv Files

    This item is mandatory for operation in the reverse direction. Indicates that the DKC specified in PSN is to be specified as the supervisor DKC of the primary site. 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.
  • Page 355: Csv Files Used By The Ykexport Command

    CSV Files Used by the YKEXPORT Command This example presents the pair information CSV file and EXCTG information CSV file that are created by the YKEXPORT command given the copy group configuration shown in “Example of a 4x4 Configuration Defined by the YKIMPORT Command” (page 354).
  • Page 356: 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 356) “ YKMONOPT File” (page 357) “ YKMONCG File” (page 360) Overview of BCM Monitor Parameter Files This section describes the parameter files used with BCM Monitor.
  • Page 357: Maximum Number Of Characters Per Line

    Table 155 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 358 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 359 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 360: Ykmoncg File

    YKMONCG File This section describes the YKMONCG file. Structure of the YKMONCG File “Structure of Parameters in the YKMONCG File” (page 360) shows the structure of parameters in the YKMONCG file. Figure 150 Structure of Parameters in the YKMONCG File 360 BCM Monitor Parameter Files...
  • Page 361: 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 362 If * is specified, all command devices are used regardless of whether they have the route label. If both the route label and * are omitted, command devices with no route label are used. CGMONSTAT={ACTIVE|INACTIVE} Specifies the monitoring status of the copy group (whether to monitor the copy group). ACTIVE Monitors the copy group.
  • Page 363: Processing For Changing To The Startup Status

    STOP Changes the monitoring status of all the copy groups specified in the CGID parameter to INACTIVE. ADJUST Changes the copy pair status to the specified 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 364 Table 158 Processing for the Specified Startup Status (continued) Specified startup status Copy pair status Processing TRANS HOLD HOLDER HOLDTRNS NODELTA REVRSY INVALID CONSLOST Executes the following commands: SUSPOP YKRESYNC SUSPCU YKEWAIT GOTO(DUPLEX) SUSPVS All SUSPOP Does nothing. SUSPOP SUSPVS Places the monitoring status of all copy SIMPLEX groups specified in the CGID parameter...
  • Page 365 Table 158 Processing for the Specified Startup Status (continued) Specified startup status Copy pair status Processing SUSPER TRANS HOLDTRNS INVALID SUSPVS REVRSY NODELTA CONSLOST Executes the following commands: HOLDER YKRESYNC PREPARE KEWAIT GOTO(HOLD) Action Parameters An action parameter specifies an action for the copy group. Format [STATUS=target-status,ACTION=action;[error-action;]]...
  • Page 366 Table 159 Combinations of Target Statuses and Actions That Can Be Specified (continued) Target Action status 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 367 Table 160 Values That Can Be Specified as Actions (continued) Specifiable value Overview Outputs the specified character string as a SENDMSG(output-message,{CONS|ERROR|STATUS|INFO}) message. Specifies the point at which BCM Monitor is to STOPPOINT(label-name) be stopped or sleeped. Sleeps BCM Monitor. PAUSE(sleep-time) Below are details about the values that can be specified as actions.
  • Page 368 Specifies (in minutes) the timeout value that is specified in the TIMEOUT parameter in the YKEWAIT command. If you omit this value, the value specified for the WAITTIMEOUT parameter in the YKMONOPT file is used. For details on this value, see the description of the TIMEOUT parameter “YKEWAIT Command”...
  • Page 369 output-message ~ <up to 65 characters of MESSAGE string enclosed in single quotation marks> Specifies the message to be output. To output a single quotation mark, specify two consecutive single quotation marks. CONS Outputs as the YK8100I message with the highest level of importance. ERROR Outputs as a YK8200I message, which indicates an error.
  • Page 370 Table 161 Copy Pair Status Priority Priority Copy pair status INVALID CONSLOST SUSPER NODELTA HOLDER SUSPCU SIMPLEX PENDING TRANS HOLDTRNS REVRSY SUSPVS SUSPOP HOLD SWAPPING DUPLEX 370 BCM Monitor Parameter Files...
  • Page 371 Example 2 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 372: Support And Other Resources

    5 Support and other resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.com/support Before contacting HP, collect the following information: Product model names and numbers Technical support registration number (if applicable) Product serial numbers Error messages Operating system type and revision level Detailed questions Subscription service...
  • Page 373 Communications Server: IP User's Guide and Commands, GC31-8514 Program Directory for IBM Library for REXX on zSeries Alternate Library, GI10-3243 DFSMSdfp Utilities, SC26-7343 MVS Initialization and Tuning Reference, SC28- 1 752 SecureWay Security Server RACF Security Administrator's Guide, SC28- 1 915 TSO/E Customization, SC28- 1 965 TSO/E Programming Services, SC28- 1 971 TSO/E System Programming Command Reference, SC28- 1 972...
  • Page 374: Hp Websites

    HP websites For additional information, see the following HP websites: http://www.hp.com http://www.hp.com/go/storage http://www.hp.com/service_locator http://www.hp.com/support/manuals http://www.hp.com/support/downloads http://www.hp.com/storage/whitepapers 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 375 Table 162 Document conventions (continued) Convention Element Monospace text File and directory names System output Code Commands, their arguments, and argument values Monospace, italic text Code variables Command variables Monospace, bold text Emphasized monospace text WARNING! Indicates that failure to follow directions could result in bodily harm or death. CAUTION: Indicates that failure to follow directions could result in damage to equipment or data.
  • Page 376: Documentation Feedback

    6 Documentation feedback HP is committed to providing documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation Feedback (docsfeedback@hp.com). Include the document title and part number, version number, or the URL when submitting your feedback.
  • Page 377: 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 378 The scan results of PPRC copy pairs are displayed. For details on the displayed messages, see HP 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 379: B Symbols Used In Syntax Explanations

    B Symbols Used in Syntax Explanations (page 379) shows the symbols used in syntax explanations. (page 379) shows the syntax elements that are used. Table 163 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 380 Table 164 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 381: C Acronyms And Abbreviations

    C Acronyms and Abbreviations Table 165 Acronyms and Abbreviations application program application programming interface Business Copy for Mainframe Business Continuity Manager A generic name for the following products: HP P9000 for Business Continuity Manager Basic HP P9000 for Business Continuity Manager Extended CT Group Software HP P9000 for Business Continuity Manager Continuous Access Journal 4x4 Extended CT Software...
  • Page 382 Table 165 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 383: 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 384 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 385 external dataset A sequential dataset for the log data output from the system logger service external volume See the HP XP24000/XP20000 External Storage Software User’s Guide. failback See failover . failover The process that occurs when one device assumes the workload of a failed companion device. Failovers can be planned or unplanned.
  • Page 386 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 387 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 388 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 389 system logger A function that writes, displays, and deletes the MVS standard log service target port A Fibre Channel interface port on the RCU. This port is connected to the MCU by a Fibre Channel interface (FIBRE) cable. TrueCopy, a function that remotely creates and manages volume copies between storage subsystems.
  • Page 390: Index

    Index Command Device Selection List panel, Command Device Status panel Add Attribute panel, for command device, Add Copy Group Panel, for command device but not a pair, Add Path Set panel, for pair, Add Route Entry panel, common displays among panels, Add Route List ID panel, configuration file ALLJNL parameter...
  • Page 391 Copy Group Status Summary panel, 1 16 example of scan result copy group structure, PPRC copy pair, copy pace, Exception Message Panel, CU parameter executing YKDELCMD command, YKBLDCMD command, YKQRYDEV command, YKDELCMD, CU Selection List for Remote Storage Array panel, YKDELCMD command, YKDELETE, YKDELPTH,...
  • Page 392 YKMAKE command, Message Panel, FORWARD parameter message structure, YKBLDPTH command, MIN parameter YKDELPTH command, YKSLEEP command, YKQRYPTH command, MSG parameter YKRESYNC command, YKBLDCMD command, YKSUSPND command, YKBLDPTH command, FROM parameter YKDELCMD command, YKSCAN command, YKDELETE command, FROMVSN parameter YKDELPTH command, YKSCAN command, YKEWAIT command, YKFCSTAT command,...
  • Page 393: Ykbldcmd Command

    path set structure, YKWATCH command, PCU parameter REVERSE parameter YKBLDPTH command, YKBLDPTH command, YKDELPTH command, YKDELPTH command, YKQRYPTH command, YKMAKE command, PPRC Copy Pair YKQRYPTH command, scan result, YKRESYNC command, PREFIX parameter YKSUSPND command, YKEXPORT command, REXX variable structure, YKIMPORT command, REXX variable updated by YKQUERY command and YKLOAD command, YKEWAIT command,...
  • Page 394 sidefile flow restriction, text- 1 parameter SMODEL parameter YKWTOMSG command, YKQRYDEV command, text-2 parameter SN parameter YKWTOMSG command, YKBLDCMD command, TIMEOUT parameter YKDELCMD command, YKCONMSG command, YKQRYDEV command, YKEWAIT command, Sort CAA Copy Group Statistics panel, YKFREEZE command, Sort CAJ Copy Group Statistics panel, YKSUSPND command, SORT command, YKWATCH command,...
  • Page 395 YKDELCMD command, YKQRYPTH with RESTRUCT specified executing, executing, 1 1 1 YKDELETE command, YKQUERY command, YKDELPTH command , YKRECVER command, YKDEMO01 YKRESYNC command, overview of sample script, OPENMFUPDATE parameter, sample script, YKRUN command, YKDEMO02 YKSCAN command, overview of sample script, YKSLEEP command, sample script, YKSTATS command,...

This manual is also suitable for:

P9000 for business continuity manager 6.6.1