HP XP7 for Business Continuity Manager Reference Guide Abstract This manual is a reference guide for the following program products, known collectively as Business Continuity Manager: HP XP7 for Business Continuity Manager Basic and HP XP7 for Business Continuity Manager Continuous Access Journal 4x4 Extended CTG.
© Copyright 2007, 2014 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 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. The information contained herein is subject to change without notice.
Contents 1 ISPF panels................................................................................................9 Overview of ISPF panels............................................................................................................9 ISPF panel system.................................................................................................................9 Operating procedures........................................................................................................
Edit Attribute panel...................................................................................................51 Add Route Entry panel..............................................................................................51 Storage System Selection List panel.............................................................................53 Edit Route Entry panel...............................................................................................53 Path Set Selection List Panel........
Volume Query Information (CAA) panel..............................................................................137 Volume Query Information (CAJ) Panel...............................................................................143 Executing YKMAKE..........................................................................................................150 Executing YKSUSPND.......................................................................................................152 Executing YKRESYNC......
YKQEXCTG command......................................................................................................224 YKQHPATH Command.....................................................................................................226 YKQRYDEV Command......................................................................................................227 YKQRYPTH Command......................................................................................................229 YKQUERY Command..........
Specification Format for CSV Files......................................................................................356 Coding Rules..............................................................................................................356 Specification Format for a Pair Information CSV File.........................................................357 Specification format for an EXCTG Information CSV File...................................................
7 Documentation feedback.........................................................................386 A Example of the Scan Results of PPRC Copy Pairs.........................................387 Example of the scan results of PPRC copy pairs.........................................................................387 B Symbols Used in Syntax Explanations........................................................389 Glossary ........................................................................................
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. Unless otherwise specified, the term storage system in this guide refers to the following disk arrays: • HP XP7 Storage • HP XP P9500 Disk Array • HP XP24000 Disk Array • HP XP20000 Disk Array The examples in this guide show a typical display from the appropriate z/OS interface, for example, ISPF, console/SYSLOG, command line, and so on.
Figure 1 ISPF panel system (1 of 2) 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. NOTE: During execution of Business Continuity Manager, you must not perform ISPF operations that involve execution of the following: • YKSTART command • Scripts that execute Business Continuity Manager Function keys Function keys, which are common among panels, are described in the following list.
SELECT command Function Actions are set to AC in a panel that displays list items in accordance with the conditions specified by the SELECT command. The SELECT command selects the rows that match the condition and performs the action on them. The command selects these rows not only from the part of the list that is displayed, but from the entire list.
• To select the device for which VSN111 is set to Volser, in the Pair Selection List (Primary) panel, enter the following command: SΔVOLSERΔVSN111ΔS • To select the device for which F310 is set to Devn (the default field name, DEVN, can be omitted), in the Pair Selection List (Primary) panel, enter the following command: SΔDEVNΔF310ΔS • To select the devices for which F310 through F320 are set to Devn (the default field name, DEVN, can be omitted), in the Pair Selection List (Primary) panel, enter the
Note that, on the Exception Message Panel, if you place the cursor on an error code that is within the displayed message, and then execute the ERRCODE command, the details for that error code will be displayed in the Error Code Help Panel. For details on the Exception Message Panel, see “Exception Message Panel” (page 16). Format ERRCODE Commands that can be used on the command line Table 2 (page 14) lists, in alphabetical order by panel name, which commands can be used on the command line.
ISPF settings Setting the position of the command line You can specify whether to position the command line at the top or at the bottom of each panel. To set the position of the command line: 1. Start Business Continuity Manager. Type SETTINGS on the command line, and then press the Enter key. The ISPF Settings panel appears. 2. To display the command line at the top of panels, clear the Command line at bottom check box.
Setting Information panel A Setting Information panel is displayed when F17=DispConf is pressed in the panels where F17=DispConf appears. The following figure shows the Setting Information panel. Setting Information Command ===> HP XP7 for Business Continuity Manager Configuration File Prefix . . Local Device Address Domain ID ISPF Log Max . . . . . . . . . Remote DKC Function . . . . . Preset RouteListID . . . . . . Preset Route Label . . . . . . . . . . . . : : : : : : BCM DADP 0 N Version v.r.
YKZ257E DASD device 733F(FF21) management error. (Message type: 0F Reason code: E3 Error code: 6A13 BF42, cmd=3, pos=HCIOE022) 32 1,2 YKZ257E DASD device 733F(FF21) management error. (Message type: 0F Reason code: E3 Error code: 6A13 BF42, cmd=3, pos=HCIOE022) 32 1,1 ***************************** Bottom of data ****************************** F1=Help F5=ErrCode F7=Backward F8=Forward F12=Cancel Table 4 (page 17) describes the items in the Exception Message panel.
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. Note, however, that an unusable configuration file might be created. If an update fails, the configuration file before the update might be damaged.
F1=Help F10=PrvsErr F7=Backward F8=Forward F11=NextErr F12=Cancel Table 5 (page 19) lists and 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 and the details. Error details Displays the error code details.
F1=Help F12=Cancel Pressing the Enter key overwrites the configuration file. Pressing the F12=Cancel key stops the configuration file from being updated. Capacity Warning panel When refreshing a copy group definition file, if the file contains a copy pair whose P-VOL and S-VOL are different capacities, or the file contains a copy pair for which the capacity of the P-VOL, S-VOL, or both cannot be acquired, then a Capacity Warning panel is displayed, asking you whether you want to refresh the file.
Figure 3 Panel transitions from the Main Menu #: You can sort the items on this panel from the pop-up panel displayed by pressing the F6=Sort key. To display the Main Menu panel: 1. Select 6 Command from the ISPF menu. 2. Enter YKSTART.
Set Defaults panel If any of the following conditions are met, the Set Defaults panel for entering the prefix and Device Address Domain ID is displayed: • No values are set for Configuration File Prefix and Local Device Address Domain ID in the Set Defaults panel. • The prefix that was used the last time Business Continuity Manager was running is specified for an instance of Business Continuity Manager agent with LOCK(PREFIX).
Table 6 Main Menu contents (continued) Item Description 7 Exit Terminates the panel Version Version of Business Continuity Manager When the PF keys are not displayed in the Main Menu panel or the Set Defaults panel, you can display the PF keys by entering the PFSHOW ON command. For information about the Set Defaults panel, see “Set Defaults panel (prefix and DAD ID settings)” (page 28).
Security Setting Information panel When you select 1 Security Setting from the Installation Verification Summary panel, the Security Setting Information panel is displayed. The Security Setting Information panel displays the current RACF profile setting information. The following figure shows the Security Setting Information panel. Security Setting Information Command ===> Facility Class Profiles Query . .
The following figure shows the User SVC Information panel. User SVC Information Command ===> Row 1 to 32 of 35 Scroll ===> PAGE 2013/01/21 15:15:15 Version of User SVC for this program . . . . . . : v.r.m-nn(zz) or later Current User SVC . . . . . .: SVC Number 257 Version v.r.m-nn(zz) Dynamic registered User SVC : SVC Number 257 Version v.r.m-nn(zz) Static installed User SVC . : SVC Number 253 Version v.r.m-nn(zz) Directions The current users SVC routine registration number and version are listed above.
Table 9 Items in the User SVC Information panel (continued) Item Description Version The version of the user SVC that is currently enabled in the system. If the user SVC that was registered either dynamically or statically is not found, N/A is displayed. Dynamic registered User SVC SVC Number SVC number of the user SVC that was registered dynamically by the YKALCSVC command If no user SVC that was registered dynamically is found, N/A is displayed.
2013/01/21 19:43:48 Current Host ID . . . . . . . . . : 00 Dynamically Defined Host ID . . . : N/A Statically Defined Host ID . . . : 00 system symbols in the IEASYMxx parmlib member and then perform IPL on the system again to set values for the host ID. The examples below show how to specify a host ID. If neither (a) nor (b) is specified, 00 is assumed.
Set Defaults panel (prefix and DAD ID settings) The Set Defaults panel is displayed when 1 Set Defaults is selected in the Main Menu panel. The following items can be defined in the Set Defaults panel: • The configuration file prefix and DAD ID. • The maximum number of messages that can be output to the ISPF log. • Whether to use 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.
Table 11 Contents of the Set Defaults panel (continued) Item Description Preset Route Label Specify the ROUTE parameter value (the route label) for the YKLOAD command. If a route label is specified, the information about the command devices with the specified route label is loaded. If * is specified, the information about all the 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.
//* F1=Help F3=Exit NOTE: F7=Backward F8=Forward F12=Cancel F17=DispConf 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. • For BC, the same DAD ID must be specified for P-VOL and S-VOL.
Table 12 Contents of the Manage Licenses panel (continued) Item Description Unlimited indicates unlimited capacity. Expires Expiration date of the license If you enter the dataset name of the license key file that has been transferred to MVS in the License Key Dataset Name field, or enter the key code in the Key Code field, and then press Enter, the license key will be installed.
Table 13 Contents of the Discover/Define Configuration panel Item Description 1 Discover HP Storage Scans the volumes 2 Route Config Defines the route list 3 Path Set Definitions Defines the path set 4 Copy Group Definitions Defines the copy group/copy pair For instructions on how to create a configuration file, see the HP XP7 for Business Continuity Manager User Guide. The configuration file needed to use Business Continuity Manager can be created in the Discover/Define Configuration panel.
The following figure shows the Discover HP Storage Arrays 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. The following figure shows the Scan Device Address Extent panel.
When the F6=Scan key is pressed after the items in Table 15 (page 34) are specified, volumes are scanned within the specified range. If an invalid character is specified, or if the value specified for Start is greater than the value specified for End, an error message prompts you to re-enter the values. After the local scanning operation, the number of detected volumes is displayed. The new information is displayed in the Discover HP Storage System panel.
F1=Help F3=Exit F7=Backward F8=Forward F12=Cancel F17=DispConf Table 17 (page 36) describes the items in the CU Selection List for Remote Storage System panel.
CCA Selection List for Edit devn panel If s is specified in AC in the CU Selection List for Edit devn panel, or if a dummy device number is entered in the Edit Device Number for CU panel, and then Enter is pressed, the CCA Selection List for Edit devn panel is displayed. CCA Selection List for Edit devn panel displays the dummy device number assigned to each volume detected in a remote scan or NG scan. The following figure shows the CCA Selection List for Edit devn panel.
Table 18 Contents of the CCA Selection List for Edit devn panel (continued) Item Description Dummy Devn Dummy device number assigned from the Edit Device Number for CU panel. The value displayed in this column can be modified.
Storage System/DADID Selection List panel When s is specified for AC in the Scan Device Address Extent panel, the Storage System/DADID Selection List panel is displayed. The Storage System/DADID Selection List panel displays storage system serial numbers and DAD IDs that have been NG-scanned. To perform a scan again, select storage system serial numbers and DAD IDs that have been NG-scanned from this panel. The following figure shows the Storage System/DADID Selection List panel.
F1=Help F3=Exit F7=Backward F8=Forward F12=Cancel Table 21 (page 40) lists and describes the items in the Control Unit Selection List panel.
Table 22 (page 41) lists and describes the items in the Command Control Address (CCA) Selection List panel.
Table 23 Contents of the Scan Remote Device Address Extent panel Item Description Remote Device Address Domain Device Address Domain ID of the storage system that will be scanned Storage System S/N Serial number of the storage system that will be scanned Device Address Specify Start and End for the device address (control unit and command control address) range to be remotely scanned.1 Specify the hexadecimal number in ascending order.
Figure 6 Route Config Panel Table 24 (page 43) describes the items in the Route Config panel. Table 24 Contents of the Route Config panel Item Description AC Specify an action. • s: Displays the list of storage systems included in the selected route list. The Route List Information panel appears.1 • d— Deletes the route list ID2 RouteList ID 1 2 Route list ID Route list definition files for the route list IDs that are not selected are also loaded.
When editing the route list definition (APID update, route deletion, or command device definition), the Confirm Route List Edit panel prompts you to confirm the update. For more information on the Confirm Route List Edit panel, see “Confirm Route List Edit Panel” (page 176). If you change the route list definition, and then press F3=Exit to update the route list, the Confirm Configuration File Update panel is displayed.
Figure 9 Route List Information Panel Page 2 Table 25 (page 45) describes the items in the Route List Information panel. Table 25 Contents of the Route List Information panel Item Description Route List ID Route list ID selected in the Route Config panel. AC 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. The Command Device Information panel appears.
Command Device Information panel If s is specified for AC in the Route List Information panel, the Command Device Information panel appears. The information about the command device lines and command devices included in the route appears in the Command Device Information panel. Figure 10 (page 46) shows the Command Device Information panel. Figure 10 Command Device Information Panel Page 1 If the list of command devices continues beyond the displayable area, > appears to the right of the header.
Table 26 Contents of the Command Device Information panel (continued) Item Description Leftmost AC Specify an action for the command device line. • e: Changes the route label or APID. The route labels or APIDs of all other command devices in the same command device group as the operation-target command device are also changed.
Figure 12 Define Command Device Panel Table 27 (page 48) describes the items in the Define Command Device panel. Table 27 Contents of the Define Command Device panel Item Description DADID DAD ID to which the devices belong. SN Serial number of the storage system to which the devices belong. Current Selection If a command device has already been defined, information about the already-defined command device appears. If a command device has not been defined, a blank appears for the CU and SSID items.
You can specify the following fields for a sort key of the SORT command: Name of field Sorted by Direction CU Number of the control unit to which the command device belongs Ascending CCA Command control address of the command device Ascending DEVN Device number of the command device Ascending VOLSER Volume serial number of the command device Ascending You can specify the following fields for a condition of the SELECT command: Name of field Value in field Type CU Number of the control unit
Figure 14 Define Remote Command Device Panel Table 29 (page 50) describes the items in the Define Remote Command Device panel. Table 29 Contents of the Define Remote Command Device panel Item Description DADID The Device Address Domain ID to which the device belongs. SN The serial number of the storage system to which the device belongs. Device Address for Command Device SSID Specify the SSID of the command device to be assigned to the storage system as a hexadecimal number.
Table 30 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). The specified value must be unique in the storage system.
Figure 17 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.
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. Figure 18 (page 53) shows the Storage System Selection List panel.
Figure 19 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.
Figure 20 (page 55) shows the transition of the operation panel starting from the Path Set Selection List panel. Figure 20 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. Figure 21 (page 55) shows the Path Set Selection List panel.
Table 35 Contents of the Path Set Selection List Panel Item Description AC Specify an action. • e— Displays the Path Set Detail panel used to load a path set definition file • d— Deletes a path set definition file When actions are entered in multiple AC columns, each is processed in the order displayed. Path Set ID Path set ID Description A description of the path set Add Path Set Panel When you press F5=Add in the Path Set Selection List panel, the Add Path Set panel is displayed.
Table 36 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) AC Specify an action. • e— Displays the Edit Logical Path Definition panel used to display or edit a logical path.
Figure 24 Edit Logical Path Definition Panel Table 37 (page 58) describes the items in the Edit Logical Path Definition panel. Table 37 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 • CU: Inter-CU logical path • DKC: Inter-DKC logical path SHR Shared attributes for path (modifiable). • Y— This path has shared attributes.
Table 37 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 group ID (path group ID in the reverse direction). Specify this item only for the inter-DKC logical path. If this item is omitted for the inter-DKC logical path, 00 is assumed.
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. You do not need to specify SSID. When Type is CU, make sure that you enter the values for S/N, Model, IFType, CU, and SSID.
Figure 25 Select Storage System Panel Table 40 (page 61) describes the items in the Select Storage System panel. Table 40 Contents of the Select Storage System Panel Item Description AC Specify an action. s— Displays the Select SSID panel used to load a disk configuration definition file. When actions are entered in multiple AC columns, the top line is selected.
Table 41 Contents of the Select SSID Panel Item Description AC Specify an action: s: Selects a CU and SSID. When actions are entered in multiple AC columns, the top line is specified. CU 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.
Table 42 Contents of the Edit Port Definition Panel (continued) Item Description CU Secondary CU number SSID Secondary SSID AC Specify an action. d— Deletes a physical path. When actions are entered in multiple AC columns, each is processed in the order displayed.
Figure 29 Sort Logical Paths in Path Set Panel Table 44 (page 64) describes the items in the Sort Logical Paths in the Path Set panel. Table 44 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 as in the sort-key column. sort-key Sort key for sorting logical paths within the path set.
Figure 30 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. #3: Pressing F6=Sort sorts items on the panel.
Figure 31 Panel Transition for the Copy Group Selection List Panel (Browse Copy Group Information) #: Pressing the F6=Sort key sorts items on the panel. Figure 32 (page 66) shows the panel transition when e is specified for AC in the Copy Group Selection List panel. Figure 32 Panel Transition from the Copy Group Selection List Panel (Update Copy Group) #1: The displayed panel changes if the specification for whether to make the copy group a CG container (Use Container check box) is changed.
Figure 33 Copy Group Selection List Panel Table 45 (page 67) describes the items in the Copy Group Selection List panel. Table 45 Contents of the Copy Group Selection List Panel Item Description AC Specify an action. • b1: Displays a copy group. If the copy group is not a CG container, the Browse Copy Group Pair Detail panel is displayed. If the copy group is a CG container, the Browse Copy Group Detail Definition panel is displayed. • e1: Edits a copy group. .
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 34 (page 68) shows the Add Copy Group pop-up) panel. Figure 34 Add Copy Group Panel Table 46 (page 68) describes the items in the Add Copy Group panel.
The following figure shows the Copy Group Detail Definition panel. Copy Group Detail Definition Row 1 to 1 of 1 Scroll ===> PAGE Command ===> 2008/03/04 10:59:06 Copy Group Type : UR Copy Group ID : GRP1UR2 Description . . . . . . . . . . . . . COPY GROUP 5 Primary Device Address Domain . . . : SF Secondary Device Address Domain . .
Table 47 Items in the Copy Group Detail Definition panel (continued) Item Description When effective AC Specify an action. N/A • e: Edits a copy pair in the copy group. This setting displays the Copy Group Pair Detail panel (this setting can be specified only in the Copy Group Detail Definition panel). • 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.
1 Unless all volumes are SIMPLEX, execution might not be executed properly. 2 Even if you disable EXCTG in the definition, it is not actually disabled on the DKC until the YKMAKE command is re-executed. Before changing the definition, execute the YKDELETE command to dissolve the copy group. If you press the F5=Add key in the Copy Group Detail Definition panel, the Copy Group Pair Detail panel (in which the copy pair is not defined) is displayed, and then the Setting C/T ID Attributes panel appears.
Table 48 Panel displayed for each combination (continued) Copy type CG Container? 1 CAA CAJ 1 Displayed panel No Copy Group Attributes (CA) Yes Copy Group Attributes For Container (CAA) No Copy Group Attributes (CAA) Yes Copy Group Attributes For Container (CAJ) No Copy Group Attributes (CAJ) Including when no C/T group ID is specified.
Figure 38 Copy Group Attributes (CA) Panel (for CA Copy Groups that are not CG Containers) Figure 39 Copy Group Attributes For Container (CAA) Panel (for CAA Copy Groups that are CG Containers) Figure 40 Copy Group Attributes (CAA) Panel (for CAA Copy Groups that are not CG Containers) Figure 41 Copy Group Attributes For Container (CAJ) Panel (for CAJ Copy Groups that are CG Containers) Discover/Define Configuration panel (configuration file definition) 73
Figure 42 Copy Group Attributes (CAJ) Panel (for CAJ Copy Groups that are not CG Containers) Table 49 (page 74) describes the items in the Copy Group Attributes panel. Note that if you change any of these items, the change does not take effect until the next time you perform an operation on the copy pair after reloading it by using the YKLOAD command. The table shows when a change made to the copy group attribute definition takes effect.
Table 49 Contents of the Copy Group Attributes Panel (continued) Item Description Copy type When effective Specify a value between OO and FF. NOTE: For configurations that use delta resync, specify the same value for both the CAJ copy pair and the CAJ copy pair for delta resync. Path ID Specify the path group ID. CAJ Specify a value between 00 and FF. When the YKMAKE command is executed.3 MIRROR ID Specify the Mirror ID in the range CAJ from 0 to 3 (required for CAJ).
Table 49 Contents of the Copy Group Attributes Panel (continued) Item Description Copy type When effective FENCE LVL Specify the fence level (required for CA). CA • When the YKMAKE command is executed • DATA: Places P-VOL in fence status (updates suppressed) when updates in P-VOL cannot be copied to S-VOL due to a problem such as a failure.
Table 49 Contents of the Copy Group Attributes Panel (continued) Item Description Copy type When effective ERROR LVL Specify the error level that determines whether all of the copy pairs in the same C/T group are suspended (required for TCA and CAJ).
Table 49 Contents of the Copy Group Attributes Panel (continued) Item Description Copy type When effective FLOW CTL Specify the sidefile flow restriction CAA (required for TCA). • When the YKMAKE command is executed • Y: Restricts the flow of host update I/O on the S-VOL depending on the usage amount of the sidefiles. Deterioration of the host’s I/O performance is proportional to the usage amount of the sidefiles. • When the YKRESYNC command is executed.
Table 49 Contents of the Copy Group Attributes Panel (continued) Item Description Copy type Preset Mode Specify the number BC corresponding to the ATTIME suspend function and suspend mode you want to use when setting an ATTIME suspend time. When effective When the YKSUSPND command is executed • NORMAL: Uses the NORMAL ATTIME suspend function. • CAJ(STEADY): Uses the CAJ ATTIME suspend function. The suspension is activated in STEADY mode. • CAJ(QUICK): Uses the CAJ ATTIME suspend function.
Table 49 Contents of the Copy Group Attributes Panel (continued) Item Description Copy type When effective TIMESTAMP Specify whether to transfer the writing timestamp to the S-VOL when the copy type is CA (timestamp transfer mode). CA When the YKMAKE command is executed • Y: Transfers the timestamp to the S-VOL. Specify this item only when you are using the CAJ ATTIME suspend function in a 4x4x4 Cascade configuration or a 3DC Cascade configuration.
Table 50 Default values for each copy type (continued) Copy type Default value COPY PACE=NORMAL CA Linkage Option=NONE FENCE LVL=NEVER FREEZE SCP=Y DIF UNIT=TRK PROT MODE=PROTECT COPY PACE=NORMAL TIMESTAMP=N OPEN/MF=N CAA ERROR LVL=GROUP FLOW CTL=Y DIF UNIT=TRK DIF UNIT=CYL PROT MODE=PROTECT COPY PACE=NORMAL CAJ Path ID=00 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 Group Attributes panel
Figure 43 Setting C/T ID Attributes Panel “Contents of the Setting C/T ID Attributes Panel” (page 82) describes the items in the Setting C/T ID Attributes panel: Table 51 Contents of the Setting C/T ID Attributes Panel Item Description C/T ID (JNLG) If the copy type is BC, CA, or CAA, • BC specify the C/T group ID (required for • CA CAA). Specify a value between 00 and 7F • CAA (depending on the storage system type).
If you press the F12=Cancel key while you are defining a new copy pair, and the copy group is not a CG container, display returns to the Copy Group Selection List panel. If the copy group is a CG container when you press the F12=Cancel key, display returns to the Copy Group Detail Definition panel. If you have already defined a copy pair during this process, a confirmation dialog box (Confirm Cancellation of Editing panel) is displayed for you to confirm cancellation of the changes.
Table 52 Contents of the Copy Group Pair Detail Panel (continued) Item Description SSID SSID CU CU number CCA 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. • +: An external volume • -: Not an external volume • (blank): The volume attribute is unknown because it was not requested.
Pair Selection List (Primary) Panel The Pair Selection List (Primary) panel is displayed in the following cases: • If the F5=Add key is pressed in the Copy Group Pair Detail panel, which causes the Pair Selection List (Primary) panel to be displayed on top of the Copy Group Pair Detail panel. • If the F5=Prim key is pressed in the Pair Selection List (Secondary) panel, which causes the Pair Selection List (Primary) panel to be displayed on top of the Pair Selection List (Secondary) panel.
Table 53 Contents of the Pair Selection List (Primary) Panel (continued) Item Description CCA The two leftmost digits indicate the device CCA (in hexadecimal) The rightmost digit indicates whether the CCA is an external volume.
Table 55 Contents of the Import SMS Storage Group Panel (continued) Item Description If this is the same name as the one specified in the SMS Storage Group Name column, this is optional. The SMS storage group is read when you press the Enter key after entering an SMS storage group name in the SMS Storage Group Name column.
Figure 48 Pair Selection List (Secondary) Panel “Contents of the Pair Selection List (Secondary) Panel” (page 88) describes the items in the Pair Selection List (Secondary) panel. Table 56 Contents of the Pair Selection List (Secondary) Panel Item Description Devn1 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).
You can specify the following fields for a condition of the SELECT command: Name of field Value in field Type DEVN Device Number Hexadecimal VOLSER Volume serial number Character string If you omit the field name, DEVN will be set as a default value. Sort Copy Group Container Panel If you press the F6=Sort key in the Copy Group Detail Definition panel, the Sort Copy Group Container panel for specifying the sorting order for the CG container is displayed.
Figure 50 Sort the Copy Group Pairs List Panel In the Sort the Copy Group Pairs List panel, you can select the sorting order from the following items. Item Description 1. Primary Device Number The order of P-VOL device numbers. 2. Primary Volume Serial Number The order of primary volume serial numbers. 3. Secondary Device Number The order of S-VOL device numbers. 4. Cylinder The order of the comparison results of the P-VOL and S-VOL capacities.
Table 57 Contents of the Scan Copy Pair Inside Storage System Panel Item Device Address Domain Description Primary Specify the Device Address Domain ID to which the P-VOL of the PPRC copy pairs to be scanned belong (required). Use no more than 28 alphanumeric characters. If the specification exceeds 8 characters, place a period every 8 characters. Hyphens cannot be specified. Secondary Specify the Device Address Domain ID of the S-VOL of the PPRC copy pairs to be scanned belong (required for CA or CAA).
Table 57 Contents of the Scan Copy Pair Inside Storage System Panel (continued) Item Description are enabled. PPRC copy pairs for which UCBHSWAP is set to ON are not defined in the CA copy group definition file. • NOCHECK: Does not check whether HyperSwap is enabled for the detected PPRC copy pairs. All detected copy pairs, even if HyperSwaps are enabled for them, are defined as CA copy groups without the HyperSwap attribute. The initial display is NOCHECK.
Command ===> Scroll ===> PAGE 2008/03/11 18:43:30 Copy Group Type : CAJ Copy Group ID : SAMP.CAJ Description . . . . . . . . . . . . : CAJ COPY GROUP Primary Device Address Domain . . . : DADP Secondary Device Address Domain . .
Manage Route Panel (Route Management) The Manage Route panel to operate the routes is displayed when 4 Manage Route is selected in the Main Menu panel. Figure 53 (page 94) shows the transition of the operation panel starting from the Manage Route panel. Figure 53 Panel Transitions from the Manage Route Panel The Manage Route panel is shown in Figure 54 (page 94). Figure 54 Manage Route Panel “Contents of the Manage Route Panel” (page 94) describes the items in the Manage Route panel.
panel to perform operations (aside from registration) for command devices not defined in the route list. Figure 55 (page 95) shows the Extra Command Device Direct Operation panel. Figure 55 Extra Command Device Direct Operation Panel Table 59 (page 95) describes the items displayed in the Extra Command Device Direct Operation panel.
Table 59 Contents of the Extra Command Device Direct Operation Panel (continued) Item Description Serial Number Specify the storage system serial number, using 5 digits of alphanumeric characters (required). Devn Use a 4-digit hexadecimal to specify the device number of the command device (required). 1 If the specified action has been aborted, the execution result (RC) is not displayed correctly.
Item F10=DADInfo key F11=CCAInfo key CCA Volser Figure 56 (page 97) shows the Route Status panel when the F10=DADInfo key is pressed. Figure 56 Route Status Panel (When the F10=DADInfo Key is Pressed) Figure 57 (page 97) shows the Route Status panel when the F11=CCAInfo key is pressed. Figure 57 Route Status Panel (When the F11=CCAInfo Key is Pressed) Table 60 (page 98) describes the items in the Route Status panel.
Table 60 Contents of the Route Status Panel Item Description Route List ID Route list ID selected in the Manage Route panel. HOST ID Host ID assigned to the local host.2 AC Specify an action. • q: Displays the Command Device Status panel used to execute the YKQRYDEV command to display the command device information that is registered in a storage system. • b: Executes the YKBLDCMD command to register a command device in a storage system.
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. If you press the F3=Exit key to exit the Command Device Selection List panel, Status in the Route Status panel displays the processing result of a command device information query (Fnd,nn).
• 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. Setting Information Command ===> 2008/03/19 19:23:04 Storage System Model . . : S/N . . . : HostStatus : Device Information USPV uCODE : 600243FF IFType : 2121 64051 SSID : 6800 CU . . : 00 OFFLINE CCA : 00 Command Device Information APID . . .
Table 61 Contents of the Command Device Status Panel (continued) Item Description CU Number of the CU to which the specified volume belongs.1 CCA CCA to which the specified volume belongs.1 APID APID1 • Displays Notset if it is not registered as a command device to the storage system. HostStatus Offline or Online information about the specified volume.1 Copy Pair Information(s) Copy pair information1, 2 Displays SIMPLEX when the copy pair information does not exist.
Even when b is specified for multiple ACs in the Route Status panel and is specified not to display the Confirm Command Device Build panel, the Confirm Command Device Build panel will be displayed after an error and before processing the next volume. NOTE: • After turning power on for the storage system, execute the YKBLDCMD command only once. If you execute this command more than once, when the command device has already been registered in storage system, the command device will not be registered.
Figure 58 Command Device Selection List Panel Table 62 (page 103) describes the items in the Command Device Selection List panel.
Table 62 Contents of the Command Device Selection List Panel (continued) Item Description CCA CCA of the detected command device (2-digit hexadecimal number) Devn Device number of the detected command device (2-digit hexadecimal number) 1 If the specified action has been aborted, the execution result (RC) is not displayed correctly. When the route list definition has been modified or deleted, sometimes the command devices defined in the old route list remain registered in the storage system.
Table 63 Contents of the Manage Path Set Panel Item Description AC Specify an action. • l: Executes the YKLOAD command and loads a path set. • b: Executes the YKBLDPTH command, and establishes all logical paths in the selected path set. • d: Executes the YKBLDPTH command, and deletes all logical paths in the selected path set. • q: Executes the YKQRYPTH command, and displays the status of all logical paths in the selected path set. The Path Set Status panel will be displayed.
Figure 61 LOAD Option Panel (When Loading a Path Set) The following table describes the items in the LOAD Option panel. Table 64 Contents of the LOAD Option Panel When Loading a Path Set Item Description Path Set ID Path set ID. Route List ID Specify the route list ID. Route Label Specify the route label. Specify this item when you use a command device line with the route label. If a route label is specified, the information for the command devices with the specified route label is loaded.
Executing YKDELPTH If d is specified in the AC column in the Manage Path Set panel or Path Set Status panel, the Confirm Path Delete panel (see “Confirm Path Delete Panel” (page 175)) is displayed to confirm the deletion. Path Set Status Panel (Executing YKQRYPTH) If q is specified in the AC column in the Manage Path Set panel, the Path Set Status panel that displays the status of a path in a path set is displayed. Figure 62 (page 107) shows the Path Set Status panel.
Table 65 Contents of the Path Set Status Panel (continued) Item Description ID Path ID of the primary site When the path type is CU, nothing is displayed. CU Primary CU number Displays the number of the CU in which a device exists to which the path operation command is issued.
When F6=Sort is pressed in the Path Set Status panel, the Sort Logical Paths in the Path Set panel for sorting the logical paths in the path set is displayed. For more information on the Sort Logical Paths in the Path Set panel, see “Path Set Detail Panel” (page 56). Logical Path Status Panel If s is specified in the AC column in the Path Set Status panel, the Logical Path Status panel for displaying the status of physical paths in a logical path is displayed.
Table 66 Contents of the Logical Path Status Panel (continued) Item Description Displays the number of the CU in which a device exists to which the path operation command is issued. SSID Secondary SSID Information Displays the number of physical paths defined for the storage system, if the number of physical paths detected by the storage system is greater than the number of paths defined in the path set definition file.
The following figure shows the Manage Copy Groups panel.
Table 67 Contents of the Manage Copy Groups Panel (continued) Item Description Status Result of action specified in AC: • NOT LOADED: The copy group has not been loaded. • LOAD ERROR RC = xx4: An error occurred during loading the copy group. • LOADED WITH WARNINGS RC = xx: The copy group has been loaded with warning attached. • LOADED: The copy group has been loaded. • ESTABLISH ERRORS. YKMAKE RC = xx: making of a copy pair failed. • ESTABLISHED: making of a copy pair requested.
The YKMAKE, YKSUSPND, YKRESYNC, YKDELETE, and YKRECVER commands involve changing copy pair statuses. Status transition takes time, so be sure to use the YKQUERY command to check that the transition is complete. NOTE: Status displays the execution result of the action specified for AC. If you specify q for AC, the YKQUERY command is executed and the Copy Group Status Summary panel is displayed.
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. The following figure shows the LOAD Option panel for loading copy groups. LOAD Option Command ===> Specify load option: Copy Group ID : UR Route List ID . . Route Label . . . F1=Help F12=Cancel Table 68 (page 114) describes the items in the LOAD Option panel.
load. For more information on the Confirm Copy Group Load panel, see “Confirm Copy Group Load Panel” (page 174). Copy Group Status Summary panel (Executing YKQUERY) When q or f is specified in AC on the Manage Copy Groups panel, the YKQUERY command executes and the Copy Group Status Summary panel, which displays the number of copy pairs in individual copy pair statuses within a copy group, is displayed.
Copy Progress Current Time: 20080304 12:02:23 CTDelta(ASIS): 000 00:00:05 Approx. Matching %: 0% Reversed Pairs %: 0% Duplex: Reverse Resync: V-Split: Invalid State: F1=Help 0 0 0 0 Pair Status Counts Simplex: 3 Suspend: 0 In Transition: 0 No Delta: 0 | | | | F3=Exit F4=Refresh | | | | F5=Storage Pending: Suspend by CU: Swapping: 0 0 0 F6=Pairs “Contents of the Copy Group Status Summary panel” (page 116) describes the items in the Copy Group Status Summary panel.
1 For Continuous Access Journal Z copy groups, the following table shows what is displayed for this item depending on the value specified for C/T TIME MODE in the Copy Group Attribute (CAJ) panel. Value specified for C/T TIME MODE Displayed value JOURNAL CTDelta (JOURNAL) VOLUME CTDelta (VOLUME) ASIS CTDelta (ASIS) 1 If you specify f for AC in the Manage Copy Groups panel, N/A is displayed.
Table 70 Contents of the Copy Group Storage System Summary panel (continued) Item Description Primary Device Addr. Domain Primary DAD ID Secondary Device Addr.
Table 71 Contents of the CAA Copy Group Performance Statistics panel (continued) Item Description Primary Device Addr. Domain Primary DAD ID in the copy group definition file Secondary Device Addr.
You can use the LOCATE and SORT commands in the CAA Copy Group Performance Statistics panel. For details about how to use each command, see “Command line commands” (page 11).
Item Sort Order 7. MCU to RCU Kbytes/s (MCU/RCU Kbytes/s) Descending order of the data transfer rate between the Pri-SN and the Sec-SN (KB/s) 8. Primary storage system S/N Ascending order of the serial number of the Pri-SN 9.
Table 72 Contents of the CAJ Copy Group Performance Statistics panel (continued) Item Description • STOP: Data transfer has stopped, as for example if all volumes in a journal group have been suspended. • N/A: Operating information could not be obtained. Sec Operating information between journal groups on Sec-SN • OK: Data transfer between journal groups is proceeding normally. • NG: Data transfer is not proceeding normally, possibly because a path between storage systems is temporarily out of service.
NOTE: • For Pri-SN and Sec-SN, information acquired from the storage system is displayed. If the copy direction is opposite to 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.
Figure 66 Sort CAJ Copy Group Statistics Panel In the Sort CAJ Copy Group Statistics panel, you can select the sorting order from the following items. Item Sort Order 1. C/T Group ID of M-JNL Consistency group ID of the primary journal group in the copy group definition file 2. C/T Group ID of R-JNL Consistency group ID of the secondary journal group in the copy group definition file 3. M-Storage System S/N Serial numbers of the storage system for Pri-SN 4.
Status Time . . .
Table 73 Contents of the Copy Group Pair Status panel (continued) Item Description EX Displays the following information that indicates whether the P-VOL is an external volume. • +: An external volume • -: Not an external volume • (blank): The volume attribute is unknown because it was not requested Dir Copy direction in the copy pair This information is changed by the YKQUERY command or YKEWAIT command.
You can specify the following fields for a condition of the SELECT command: Name of field Value in field Type STATE Copy pair status Character string PDEVN Device number of the P-VOL Hexadecimal VOLSER Volume serial number of the P-VOL Character string SDEVN Device number of the S-VOL Hexadecimal CTID Consistency group ID Hexadecimal SUBCTID Subconsistency group ID Hexadecimal DIR Copy direction (<, >) Character string RC Return code from action execution Decimal PRIEX Blank, -,
Table 74 Sort the Copy Group Pairs Status Panel Item Sort Order 1. Copy Pair State The order of the copy pair status 2. Primary Device Number The order of P-VOL device number. 3. Primary Volume Serial Number The order of P-VOL volume serial number. 4. Secondary Device Number The order of S-VOL device number. 5. C/T ID The order of consistency group ID. 6. sub C/T ID The order of subconsistency group ID. 7. Dir(>) The order indicated by the copy direction of > in DIR. 8.
Other CopyPair Information ----- Primary/Secondary -------- Pair Volume ---Type C/T ID SN DEVN Status Dir SN SSID CU CCA DEVN CAJ 1C 1C Pri 53039 0002- DUPLEX (02) < 53038 000D 08 01 738E ******************************* Bottom of data ******************************** F1=Help F3=Exit F4=Refresh F7=Backward F8=Forward Table 75 (page 129) describes the items in the Volume Query Information (BC) panel.
Table 75 Contents of the Volume Query Information (BC) panel (continued) Item Description Suspend ATTIME ATTIME suspend time and ATTIME suspend status On the first line: (GMT) : ATTIME-suspend-time-in-GMT ATTIME-suspend-status For ATTIME-suspend-time-in-GMT ATTIME-suspend-status, one of the following messages is displayed: • Notset: ATTIME suspend time is not set. • ATTIME-suspend-time - WAITING: ATTIME suspend has not been executed.
Table 75 Contents of the Volume Query Information (BC) panel (continued) Item Description the CAJ copy pair was made, or for a similar reason, the consistency time for CAJ is not displayed. • DUPLEX consistency-time-of-CAJ-copy-pairs: When the BC copy pair was suspended, all CAJ copy pairs were in DUPLEX status (consistency time was valid). CAJ consistency time format: YYYYMMDD HH:MM:SS.NNNNNN (GMT) ◦ YYYY: The year is displayed. ◦ MM: The month is displayed. ◦ DD: The date is displayed.
Table 75 Contents of the Volume Query Information (BC) panel (continued) Item Description P-VOL is high, and this might affect the I/O performance of the host. • SLOW: Slows the speed of the copy operation so that the effect of the copy operation on the I/O performance of the host is minimal.
1 See the table (for BC) in the HP XP7 for Business Continuity Manager User Guide for details about obtaining the status of the displayed copy pair using the YKQRYDEV command. Note that when the device is a command device of either of the following models, CDEV(apid) is displayed in the Status column (apid: APID): • HP XP12000/XP10000 Disk Array • HP XP24000/XP20000 Disk Array • HP XP P9500 Disk Array • HP XP7 Storage 2 If the emulation type of the journal volume is OPEN, JOURNAL is not displayed.
Table 76 Contents of the Volume Query Information (CA) panel Item Description Copy Group ID Copy group ID Copy Group Type (in Configuration) Copy group type at definition Copy Group Type (from Storage System) Copy types held by the storage system Primary Volume SN Storage system serial number of the P-VOL at definition SSID SSID of the P-VOL at definition CU CU number of the P-VOL at definition CCA CCA of the P-VOL at definition DEVN Device number of the P-VOL at definition The following v
Table 76 Contents of the Volume Query Information (CA) panel (continued) Item Description COPY PACE Pace of copying4 • NORMAL: The speed of the copy operation improves. However, update I/O load on P-VOL is high, and this might affect the I/O performance of the host. • SLOW: Slows the speed of the copy operation so that the effect of the copy operation on the I/O performance of the host is minimal.
Table 76 Contents of the Volume Query Information (CA) panel (continued) Item Other CopyPair Information5 Description Primary/Secondary Type The following information is displayed if there are any other copy pairs apart from the one specified in the Copy Group Pair Status panel.
4 5 6 The timing for when the defined values are reflected is as shown in “Contents of the Copy Group Attributes Panel” (page 74), in the table item of 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). MISMATCH might be displayed.
F1=Help F3=Exit F4=Refresh F7=Backward F8=Forward “Contents of the Volume Query Information (CAA) Panel” (page 138) describes the items in the Volume Query Information (CAA) panel.
Table 77 Contents of the Volume Query Information (CAA) 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 status1 JOURNAL is displayed for the journal volume.2 Suspend ATTIME ATTIME suspend time and ATTIME suspend status On the first line (GMT) : ATTIME-suspend-time-in-GMT - status is displayed.
Table 77 Contents of the Volume Query Information (CAA) Panel (continued) Item Description • MM: The minute is displayed. • SS.NNNNNN: The second is displayed. Consistency Time (GMT) Consistency time • On the first line: (GMT):consistencytime-in-GMT • On the second line: (LOCAL):consistencytime-in-GMT If the consistency time is invalid, N/A is displayed. C/T ID Consistency group ID ERROR LVL Error level3 • VOLUME: When a failure occurs, only the affected volumes are suspended.
Table 77 Contents of the Volume Query Information (CAA) Panel (continued) Item Description might affect the I/O performance of the host. • SLOW: Slows the speed of the copy operation so that the effect of the copy operation on the I/O performance of the host is minimal.
Table 77 Contents of the Volume Query Information (CAA) Panel (continued) Item Description SN • 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 the copy pair specified in the Copy Group Pair Status panel • For Secondary: Device number for S-VOL of the copy pair specified in
3 The timing for when the defined values are reflected is as shown in Table 49 (page 74), in the item When effective. 4 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). MISMATCH might be displayed.
Volume Query Information (CAJ) Row 1 to 1 of 1 Scroll ===> PAGE Command ===> 2012/03/27 09:55:08 Copy Group ID . . . . . . . . . : UR Copy Type(in Configuration): CAJ Copy ---------- Primary Volume ---------SN SSID CU CCA DEVN Status Dir 10037 000A 07 0F 0002- DUPLEX (02) > Type(from Storage System) : CAJ --------- Secondary Volume --------SN SSID CU CCA DEVN Status 10007 000C 07 01 1301- DUPLEX (02) Consistency Time (GMT) : 20120327 00:55:06.190322 (LOCAL) : 20120327 09:55:06.
Table 78 Contents of the Volume Query Information (CAJ) panel (continued) Item Description Always displays > when the Status of the Primary Volume is SIMPLEX.
Table 78 Contents of the Volume Query Information (CAJ) panel (continued) Item Description F, R (from Storage System) EXCTG ID that has been registered in a storage system • F: EXCTG ID in the forward direction • R: EXCTG ID in the reverse direction N/A is displayed if EXCTG is not registered, or if the information cannot be obtained.
Table 78 Contents of the Volume Query Information (CAJ) panel (continued) Item Description 1 Other CopyPair Information Primary/Secondary Type The following information is displayed if there are any other copy pairs apart from the one specified in the Copy Group Pair Status panel: • Copy type • Indication of whether it is information on the P-VOL or S-VOL (Pri or Sec) C/T ID Consistency group ID and subconsistency group ID SN • For Primary: storage system serial number of the P-VOL of the copy pair
Table 78 Contents of the Volume Query Information (CAJ) panel (continued) Item Description CCA CCA of the volume that makes a copy pair DEVN Device number of the volume that makes a copy pair 1 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). 2 MISMATCH might be displayed.
flag2: Indicates, by using a flag, whether the journal group of the copy destination volume has been registered in a storage system as EXCTG when a copy is being performed in the forward direction. This information is held by the copy destination volume and flag2 may have one of the following values: • 0: The journal group has not been registered in a storage system as EXCTG. • 1: The journal group has been registered in a storage system as EXCTG. • N/A: Unable to identify the status.
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: ◦ For P-VOL ◦ When the CAJ copy pair status is PENDING or DUPLEX If none of these situations apply, N/A is displayed.
Figure 70 BC Copy Group Make Options Panel Figure 71 CA & CAA Copy Group Make Options Panel Figure 72 CAJ Copy Group Make Options Panel “Contents of the Make Options Panel” (page 152) describes the items in the Make Options panel.
Table 79 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). You can specify the NOCOPY parameter in CA, CAA, and CAJ. • Delta Resync Relation Make: Makes a delta resync pair (the HOLD parameter is specified). You can specify the HOLD parameter in CAJ.
Figure 73 BC Copy Group Suspension Options Panel Figure 74 BC with C/T Copy Group Suspension Options Panel Figure 75 CA Copy Group Suspension Options Panel Manage Copy Groups Panel (Copy Group Operation) 153
Figure 76 CAA Copy Group Suspension Options Panel Figure 77 CAJ Copy Group Suspension Options Panel Displayed from the Manage Copy Groups Panel Figure 78 CAJ Copy Group Suspension Options Panel Displayed from the Copy Group Pair Status Panel “Contents of the Suspension Options Panel” (page 155) describes the items in the Suspension Options panel.
Table 80 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. • Purge: Suspends, discarding the unreflected data. • Preset: Specifies use of the ATTIME suspend function.
Table 80 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) • mmmm: Specify the offset value to be added to the ATTIME suspend time in minute (0000 to 1439) • ss: Specify the offset value to be added to the ATTIME suspend time i
The YKSUSPND command terminates successfully when the instruction to the copy pair succeeded. Even if the command has terminated successfully, make sure that the transition of the copy pair status was performed, using the YKQUERY command or the YKEWAIT command. If there is a volume whose status has not been changed, re-execute the YKSUSPND command with the VOLUNIT parameter specified for all the copy pairs.
Figure 81 CAJ Copy Group Resync Options Panel Displayed from the Manage Copy Groups Panel Figure 82 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 in “Confirm Overwrite ONLINE Target Volume Panel” (page 174).
Table 81 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. Pair Selection Specify the SELECT parameter (indicating how to select the copy pair to be operated) of YKRESYNC command by using the number.
Table 81 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. Update Open/MF Specify whether the CA Open/MF Consistency attribute is to be changed (using the Open/MF Consistency Preservation Function); the default is N.
parameters of the YKWATCH command is displayed. The value is used as a background job for submitting. JCL uses a value indicated in the Set Defaults panel. Figure 83 (page 161) shows the Watch Options panel. Figure 83 Watch Options Panel “Contents of the Watch Options Panel” (page 161) describes the items in the Watch Options panel.
Figure 84 Wait Options Panel (for BC, CA, or CAA) Figure 85 CAJ Copy Group Wait Options Panel “Contents of the Wait Options Panel” (page 162) describes the items in the Wait Options panel. Table 83 Contents of the Wait Options Panel Item Description Copy Group ID Copy group ID Wait transition to Specify the waiting status for the YKEWAIT command by using the number. • Duplex: Waits for the volume to change to the DUPLEX status. • Suspend: Waits for the volume to change to the suspend status.
Table 83 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. • N: The NOINVALIDCHECK parameter is not specified. The detection of invalid statuses is enabled.
Table 84 Contents of the Path Set Status of Copy Group Pair Panel (continued) Item Description Primary SN Serial number of the primary storage system ID Primary path group ID (path group ID in the forward direction) When the path type is CU, nothing is displayed.
Table 85 Return codes displayed in the Copy Group Pair Status panel (continued) Return Code Meaning file in use, as well as the actual storage system configuration information and settings. • If the device indicated by Primary Volume/Secondary Volume in the Copy Group Pair Status panel is a remote site, then either the route list is not specified, or the serial number of the storage system to which the device belongs is not registered in the route list specified for the YKLOAD command.
Table 86 Contents of the Logical Path Status of Copy Group Pair Panel (continued) Item Secondary Description SSID Primary SSID S/N Secondary storage system serial number PathID Secondary path group ID (path group ID in the reverse direction) When the path type is CU, nothing is displayed.
Table 87 Contents of the EXCTG Information panel (continued) Item Description EXCTG Consistency Time (GMT) EXCTG consistency time (in GMT) acquired from the supervisor DKC. If the EXCTG consistency time cannot be acquired, N/A is displayed. EXCTG Consistency Time (LOCAL) EXCTG consistency time (in local time) acquired from the supervisor DKC. If the EXCTG consistency time cannot be acquired, N/A is displayed.
Confirm Execution Recover Panel If c is specified in AC in the Manage Copy Groups panel, the Confirm Execution Recover panel is displayed, prompting you to confirm whether the copy pair is dissolved. The following figure shows the Confirm Execution Recover panel. Confirm Execution Recover Command ===> ___________________________________________________________________________ Confirm that you want to execute the requested copy group operation.
Figure 87 Confirm Command Device Build Panel “Contents of the Confirm Command Device Build Panel” (page 169)describes the items in the Confirm Command Device Build panel. Table 90 Contents of the Confirm Command Device Build Panel Item Description Route List ID Route list ID APID APID Serial Number Selected storage system serial number Set command device build Specify whether to display the Confirm Command Device confirmation off Build panel.
Figure 88 Confirm Cancellation of Changes Panel Pressing the Enter key cancels the update of the configuration file. Pressing the F12=Cancel key continues processing while keeping the update of the configuration file. Confirm Cancellation of Editing Panel When you attempt to cancel an update of the copy pair definition file or path set definition file, the Confirm Cancellation of Editing panel is displayed asking you whether you want to cancel the update.
Figure 90 Confirm Command Device Delete Panel (displayed from Route Status Panel) “Contents of the Confirm Command Device Delete Panel (displayed from Route Status Panel)” (page 171) describes the items in the Confirm Command Device Delete panel.
Figure 91 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 172) lists the items displayed in the Confirm Command Device Delete panel.
The following figure shows the Confirm Configuration File Delete panel. Confirm Configuration File Delete Command ===> ___________________________________________________________ You have requested the deletion of the following file: BCM.GRP.SI Are you sure you want to delete the file? _ Yes, delete the file Instructions: Press ENTER key to delete the file. Press CANCEL to cancel this operation.
When you execute c in the Manage Path Set panel, pressing the Enter key updates the file, and pressing the F12=Cancel key cancels the updating of the file. However, after an error occurred during an update of the configuration file, if you press the F12=Cancel key, the Cancellation Warning panel is displayed.
This panel provides a warning that the contents of the online target volume (S-VOL) will be overwritten when the YKMAKE or YKRESYNC command is executed. Specifying / for Yes, perform this operation and pressing the Enter key overwrites the contents of the online target volume (S-VOL). Pressing the F12=Cancel key cancels the overwriting of the contents of the online target volume (S-VOL).
Figure 95 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. Figure 96 (page 176) shows the Confirm Route Delete panel.
Figure 97 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. N is displayed from the beginning.
The following figure shows the Confirm Open/MF Consistency Group Suspension panel. Confirm Open/MF Consistency Group Suspension Command ===> ________________________________________________ You are attempting to suspend an Open/MF consistency group. With the exception of the case below, when a consistency group is suspended, all open-volume copy pairs in the group are also suspended.
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 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.
Table 95 List of Supported Functions (continued) Command 1 Function YKDROP Drops a REXX variable structure that has been loaded from a script by using the YKLOAD command and then expanded. YKENV Obtains a Business Continuity Manager environment variable and displays it in the TSO/E terminal. YKERCODE Displays storage system sense byte information (error codes) on the TSO/E terminal. YKEWAIT Monitors the copy pair status transition and waits for a certain specified status.
3 The YKWATCH command is a REXX script. 4 The YKWTOMSG command is a REXX function. Configuration Files That Must Be Loaded Before Command Execution Table 96 (page 181) and Table 97 (page 183) show the configuration files that must be loaded before each command is executed. Table 96 (page 181) 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.
Table 96 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 YKQRYDEV -- D3 -- YKQRYPTH -- D1 Y 3, 4 YKQUERY Y D -- YKRECVER Y Y -- YKRESYNC Y D2, 5 -- YKRUN Y Y -- YKSCAN -- -- -- YKSLEEP -- -- -3 YKSTATS Y D -- YKSUSPND Y D2, 5 -- YKWATCH -- -- -
Table 97 Configuration Files That Must Be Loaded Before Command Execution (When the Environment Contains a Non Gen'ed Volume) Command name YKBLDCMD Configuration file that must be loaded Copy group definition file Route list definition file Path set definition file -- Y -1 YKBLDPTH -- D Y YKCONMSG -- -- -- YKDELCMD -- Y -- YKDELETE Y D2 -- YKDELPTH -- D1 Y YKERCODE -- -- -2 YKEWAIT Y D -- YKEXPORT -- -- -- YKFCSTAT -- -- -- YKFREEZE Y -- -- YKH2B -- -- --
D: Whether you need to load the configuration file depends on the situation. --: You do not need to load the configuration file. Command details This section describes command details. For details about the syntax symbols used in the explanations, see “Symbols Used in Syntax Explanations” (page 389) YKBLDCMD Command Applies to CMD.
APID(APID) ~ Specify the APID. MSG(stem-name-1) ~ 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. NOTE: • Execute the YKBLDCMD command only once after turning on the storage system.
YKBLDPTH Command Applies to PTH. Format YKBLDPTH 1STEM(stem-name-1) 1MSG(stem-name-2) [ 1PSN(storage system-serial-number)[ [ 1SSN(storage system-serial-number)[ [ 1PTID(path-group-ID)] [ 1{FORWARD|REVERSE}] [ 1TYPE({CU|DKC})] 1PCU(cu-number)]] 1SCU(cu-number)]] Function This command is a TSO/E command called from REXX scripts.
and inter-DKC logical paths will be established such that the paths treat the storage system (that has the serial number specified by this parameter) as the secondary storage system. If neither this parameter nor any other parameters are specified, the command establishes all logical paths.
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 XP7 for Business Continuity Manager Messages and then eliminate the cause of the error.
Function This command is a TSO/E command called from REXX scripts. This command monitors for the following messages: • IEA494I message Copy status display message that is output to the MVS console • IOSHM0414I message HyperSwap completion message that is output to the MVS console • User-specified message User-specified message that indicates that a HyperSwap has been completed Parameters MSGID({IEA494|IOSHM0414I|user-specified-message-ID}) Specifies the message to be monitored.
HANDLE(X'handle') ~ <8-digit hexadecimal number> Specify the handle to be used to associate this request to an EMCS console interface that has already been established. Specify the value returned in the YKCONMSG OP(OPEN) command's completion message as the handle value. 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.
Format YKDELCMD { 1SN(storage system-serial-number)| 1SN(storage system-serial-number) 1CU(cu-number) 1DEVN(device-number) 1APID(apid)} 1MSG(stem-name-1) 1CCA(cca-number) 1APID(apid)| 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.
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.
Format YKDELETE 1STEM(stem-name-1) 1MSG(stem-name-2) [ 1DEVN(p-vol-device-number,s-vol-device-number)] [ 11SELECT({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.
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.
Table 102 YKDELETE Command Return Code List (continued) Return Code Meaning 48 Terminating due to invalid parameters. This return code appears, for example, when the copy pair corresponding to the device number specified with the DEVN parameter is not found. 128 The command terminated abnormally. The user does not have permission to execute this command. YKDELPTH Command Applies to PTH.
PCU(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 MCU matches the value specified for this parameter. Inter-DKC logical paths are not affected by this parameter. If neither this parameter nor any other parameters are specified, the command establishes all nonshared inter-CU logical paths.
FORCE If this parameter is specified, of those logical paths that are identified in the path set stored in the path set structure specified by the STEM parameter, the command also deletes the paths that have the shared attribute (those with the value Y assigned to stem-name-specified-in-STEM-parameterPATH.n.Shared). If this parameter is not specified, the command does not delete logical paths that have the shared attribute.
Table 103 YKDELPTH Command Return Code List (continued) Return Code Meaning 32 • I/O errors were encountered. None or only some of the logical paths were deleted. • A change in an I/O configuration definition was detected. 36 • Processing was interrupted because a REXX variable with an invalid value was encountered. None or only some of the logical paths were deleted. • No path to be deleted was found. 40 An error occurred while a REXX variable was being read or written.
For either the GRP or the PTH parameter, specify the prefix of the copy group structure related to the REXX variable structures to be dropped. If you specify the GRP parameter, the REXX variable structures related to the copy group structures will be dropped. If you specify the PTH parameter, the REXX variable structures related to the path set structures will be dropped.
Table 104 YKDROP Command Return Code List (continued) Return code Meaning 1044 An error occurred while a REXX variable was being accessed. • REXX variables loaded via the YKLOAD command cannot be found. • REXX variables loaded via the YKLOAD command are disabled or initialized. • The return code of the IRXEXCOM routine R15 is —2, —1, 28, or 32. 2000 A system error occurred. YKENV Command Format YKENV Function This is a TSO/E command called from REXX scripts.
Table 106 Items Output by the YKENV Command (continued) Output item Description Host ID: Host ID License info DSN prefix: Prefix of the license information dataset. Business Continuity Manager log output method: Business Continuity Manager log output method. • LOGR: The system logger service is used to output the Business Continuity Manager log. • SAM: The Business Continuity Manager log is output to a SAM file CLI log output settings: CLI command-execution log output settings.
YKLCNS2 LOGPUT SYSLOG YKZ371I = N/A (&YKLCNS2 = N/A (&YKLOGPT = N/A (&YKSYSLG YKENV command return = N/A = N/A = N/A code=0. ) ) ) YKERCODE Command Format YKERCODE 1error-code Function This is a TSO/E command. This command displays the details of a specified error code on the TSO/E terminal. The command displays the following information: • Error details:details-of-error Displays the error details. • Type of error:cause-of-error Displays the cause of the error.
YKEWAIT Command Applies to Business Copy for Mainframe, Continuous Access Synchronous for Mainframe, Continuous Access Synchronous for Mainframe with the HyperSwap attribute, Continuous Access Asynchronous for Mainframe, and Continuous Access Journal for Mainframe.
SUSPEND The command waits until all the copy pairs in the group reach the SUSPOP or SWAPPING status. However, if the status of any copy pair changes to the SIMPLEX, SUSPER, SUSPCU, HOLD, HOLDER, HOLDTRNS, NODELTA, CONSLOST, or INVALID status, the YKEWAIT command terminates abnormally with return code 8. SIMPLEX The command waits until all the copy pairs in the group reach the SIMPLEX status.
NOINVALIDCHECK Processing continues even when the status changes to anything other than the status specified by the GOTO parameter (invalid statuses). If this parameter is specified, and the status does not change to that specified in the GOTO parameter, command processing will continue until the timeout time specified in the TIMEOUT parameter is reached. The invalid statuses in Table 108 (page 205) differ depending on the value specified in the GOTO parameter.
Specify this parameter to monitor copy groups by monitoring the status of either P-VOLs or S-VOLs. When the TO parameter is specified, the copy group container is not checked for EXCTG registration information. • PRIMARY Monitors the status of P-VOL during copy group definition. • SECONDARY Monitors the status of S-VOL during copy group definition. VOLUNIT Usually, information is obtained for each CU, but when this parameter is specified, information is obtained for each volume.
1 If a time-out has taken place, use the YKQUERY command to check the status of the copy pair. If there is a copy pair where a transition has not taken place, the S-VOL of the copy pair might be ONLINE. Place it OFFLINE and re-execute. In addition, for CG containers specified by EXCTG ID, check if the journal group has been registered in EXCTG.
NOTE: • The execution of this command does not check if the configuration of the copy groups specified in the copy group definition file is supported. Therefore, an error could result when you specify, by using the YKIMPORT command, a CSV file created by this command. If an error occurs, check if the configuration of the copy groups in the CSV file is supported. • The pair information CSV file is created even if an error occurs during creation of the EXCTG information CSV file.
• HP XP P9500 Disk Array • HP XP7 Storage Parameters STEM(stem-name-1) ~ Specify an optional prefix for the name of the FlashCopy information structure used to store the FlashCopy information. You must also include a trailing period character. MSG(stem-name-2) ~ Specify an optional prefix for the name of the message structure used to store the messages to be generated by this command.
Format YKFREEZE 1STEM(stem-name-1) 1MSG(stem-name-2) [ 1TIMEOUT(timeout-value) Function This command: • Is a TSO/E command called from REXX scripts. • Is executable for a copy group specified by the consistency group ID. • Freezes the specified copy group, changes it to the SCP status and suspends update I/O to the P-VOL. • Works when the storage system has the corresponding function.
Table 112 YKFREEZE Command Return Code List (continued) Return Code Meaning 32 • I/O errors were encountered. • A change in an I/O configuration definition was detected. 36 Invalid or unknown elements are found in the structure. 40 An error occurred while a REXX variable was being written. 44 Terminating due to processing errors. 48 Terminating due to invalid parameters. 128 The command terminated abnormally. The user does not have permission to execute this command.
If device-number-2 is smaller than device-number-1, device-number-2 is treated as the starting DEVN of the scan range and device-number-1 is treated as the ending DEVN of the scan range. DAD(dad-id) ~ The maximum length of the specification must be 44 - (13 + PREFIX-length). CGNAME(name-of-TrueCopy-copy-group-with-HyperSwap-attribute) ~ Specify the name of a CA copy group with the HyperSwap attribute.
Table 113 YKH2B Command Return Code List (continued) Return Code Meaning 44 Termination due to processing errors. No copy group definition file was created. 48 Termination due to invalid parameters. 64 An error occurred during REXX processing.
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. Maximum length that can actually be specified = 44 - (5 + PREFIX-length) NEWGROUP(copy-group-ID) ~ < GROUP string> Specify a name for the copy group definition file that is to be created, without the prefix.GRP part.
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. Parameters None. Return codes Table 115 (page 215) lists the return codes to be returned when the YKINSCHK command terminates. Table 115 YKINSCHK Command Return Code List Return Code Meaning 0 There are no problems in the settings. 8 There is a problem with the settings.
Table 116 YKINSCHK Command Output Items (continued) Output item Explanation Current User SVC: Version Outputs the user SVC version that is currently enabled. If version information cannot be acquired, N/A is output. Dynamic registered user SVC: Outputs the SVC number of the user SVC that was registered dynamically by the YKALCSVC command. If no SVC number can be acquired, N/A is output.
- Facility Class Profiles Query - Facility Class Profiles Commands To give a user the permissions necessary to use all of the BCM commands: 1. Make the RACF FACILITY class active. 2. Define the STGADMIN.YKA.BCM.COMMANDS profile in the FACILITY class. 3. Give the user the access rights of the profile. To give a user the permissions necessary to use some of the BCM commands (the reference commands): 4. Make the RACF FACILITY class active. 5. Define the STGADMIN.YKA.BCM.YKQUERY profile in the FACILITY class.
specify any host IDs. For host IDs, specify a unique hexadecimal two-digit number from 00 through 1F for each OS. In an LPAR environment, specify a different number for each LPAR. Set host IDs by using the YKSETENV command before starting Business Continuity Manager. Alternatively, you can define the corresponding system symbols in the IEASYMxx parmlib member and then perform IPL on the system again to set values for the host ID. The examples below show how to specify a host ID.
Table 117 Which File Results in Which REXX Variable Structure Specified parameter Loaded file REXX variable structure that is created GROUP • Copy group definition file • Copy group structure • Disk configuration definition file • Host-Discovered Array Index structure • Host-Discovered Array structure ROUTE • Disk configuration definition file • Route list structure • Route list definition file • Host-Discovered Array Index structure • Command device definition file PATH • Disk configuration
When you specify a route label, the information about the command devices with the specified route label is loaded. If * is specified, the information for all command devices is loaded regardless of whether they have a route label. If both the route label and * are omitted, the information about the command devices with no route label is loaded.
Table 118 YKLOAD Command Return Code List Return Code Meaning 0 The command completed normally. 4 Unknown XML attributes or elements encountered in input file. 8 Unable to resolve device number for S-VOL in copy pair. 12 Unable to resolve volume serial number for P-VOL in copy pair. 16 Unable to resolve device number for P-VOL in copy pair. 36 Terminating due to invalid XML structure encountered in input file, or system symbols are not defined correctly.
The message structure is initialized when the CLI command with the same name as the MSG parameter is specified. {FORWARD|REVERSE} Specify the copy direction. FORWARD The command makes a copy pair directed from the primary site to the secondary site. REVERSE Makes a copy pair in the reverse direction, from the secondary site to the primary site. NOCOPY Applies to Continuous Access Synchronous for Mainframe, Continuous Access Asynchronous for Mainframe, and Continuous Access Journal for Mainframe.
NOTE: • Do not dissolve copy pairs during a planned outage. • In 4x4x4 Delta Resync configurations, when all copy pairs in EXCTG whose copy direction is from the primary site to the remote site are dissolved, the journal groups whose copy direction is from the local site to the remote site are also dissolved from EXCTG registration.
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.
Format YKQEXCTG 1STEM(stem-name-1) 1MSG(stem-name-2) 1TO({SECONDARY|PRIMARY}) Function This is a TSO/E command. Information about the copy group container with the specified EXCTG ID is acquired from the supervisor DKC at the site specified for the TO parameter. Parameters STEM(stem-name-1) ~ Specifies the prefix of the copy group structure that contains the copy group container with an EXCTG ID for which you want to acquire EXCTG information.
Table 120 YKQEXCTG command return code list Return code Meaning -4095 to -4040 The command terminated abnormally. A possible cause is as follows: • A user SVC routine was not properly embedded. -3 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. -1 An interruption occurred during execution. 0 The command terminated normally. 32 • An I/O error occurred.
Table 121 YKQHPATH Command Return Code List Return Code Meaning -4095 to -4040 The command terminated abnormally. A possible cause is the user SVC routine has not been properly included. -3 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. -1 An interruption occurred during execution. 0 I/O path of the specified device is available.
SN(storage system-serial-number) ~ Specify the serial number of the storage system to which the volume obtaining storage system information belongs. When this parameter is specified, the route list needs to be loaded before the command is executed. CU(cu-number) ~ <2-digit hexadecimal number> Specify the CU number of the volume for obtaining storage system information. When this parameter is specified, the route list needs to be loaded before the command is executed.
USPV Specify this option when the model of the secondary storage system for the inter-DKC logical path you want to obtain is HP XP24000/XP20000 Disk Array. VSP Specify this option when the model of the secondary storage system for the inter-disk controller logical path you want to obtain is XP P9500. VSPG1000 Specify this option when the model of the secondary storage system for the inter-disk controller logical path you want to obtain is XP7.
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. Parameters STEM(stem-name-1) ~ Specify the prefix of the name of the path set structure that stores information about the logical path whose status you want to obtain.
PTID(path-group-ID)~<2–digit hexadecimal number> If this parameter is specified, for each logical path within the path set stored in the path set structure specified for the STEM parameter, inter-disk controller logical paths that have the path group ID specified for this parameter are acquired. Inter-control unit logical paths are not affected by this parameter. If neither this parameter nor any other parameters are specified, the command acquires all the logical paths.
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 XP7 for Business Continuity Manager Messages and then eliminate the cause of the error.
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 1STEM(stem-name-1) 1MSG(stem-name-2) [ 1DEVN(device-number)] [ 1TO({PRIMARY|SECONDARY})]|VERIFY}] Function This command is a TSO/E command called from REXX scripts.
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 XP7 for Business Continuity Manager User Guide.
Table 124 YKQUERY Command Return Code List (continued) Return Code Meaning 24 • 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. • The suspend processing has started because the timeout period had elapsed when the CAJ ATTIME suspend function was executed. 32 • I/O errors were encountered.
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) ~ Specify the prefix of the name of the copy group structure that stores information about the copy group for which you want to dissolve the copy pairs.
Table 125 YKRECVER Command Return Code List (continued) Return Code Meaning -1 An interruption occurred during execution. 0 The command completed normally. 32 • I/O errors were encountered. • A change in an I/O configuration definition was detected. 36 Invalid or missing data in a REXX variable. 40 An error occurred while a REXX variable was being written. 44 Terminating due to processing errors. 48 Terminating due to invalid parameter.
SELECT({ALL|COND}) Specify the selection method for copy pair to be manipulated by the command. When not specified, ALL is assumed. ALL All the copy pairs in the copy group are to be manipulated by the command. Note that if the DEVN parameter is specified, the copy pair specified for the parameter is the execution target of the command. COND The pairs to be manipulated by the command depend on their volume status.
VOLUNIT When this is specified, the operation is performed by volume even when the environment supports operation by group. If you specify this parameter after ATTIME suspend, execute the YKSUSPND command with the CANCEL parameter specified. The following describes the relationship between the VOLUNIT parameter specification and the command execution when issuing the YKRESYNC command to reverse the copy direction.
of the error according to the message, and then re-execute the YKRESYNC command without the ERRCHK parameter. If the ERRCHK parameter is specified and no abnormal copy pairs exist, the command will terminate normally with the return code 0. Table 126 Example Procedure Using the ERRCHK Parameter After Transition to HOLDER Status No. Command Description 1 YKQUERY STEM(SF.TO.LA.) MSG(MSG.) Checks if all copy pairs are in the HOLD status. 2 YKRESYNC STEM(SF.TO.LA.) MSG(MSG.
specified, the command is executed in units of volumes even in an environment in which the command can be executed in units of groups. 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.
Table 127 YKRESYNC Command Return Code List (continued) Return Code Meaning 4 Since a volume with an invalid status was found in the copy group, processing for the volume will be skipped. 32 • I/O errors were encountered. • A change in an I/O configuration definition was detected. 36 Invalid or missing data in a REXX variable. 40 An error occurred while a REXX variable was being written. 44 Terminating due to processing errors. 48 Terminating due to invalid parameters.
Return Codes Table 128 (page 243) lists the return codes to be returned when the YKRUN command terminates. Table 128 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. -3 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. -1 An interruption occurred during execution.
TO(X'nnnn') ~ <4-digit hexadecimal number> Specify the device number of the last volume to be scanned. This parameter and the FROMVSN and TOVSN parameters are mutually exclusive. The range from the FROM parameter to the TO parameter is scanned in hexadecimal ascending order. FROMVSN(volser) ~ Specify the volume serial number of the first volume to be scanned. This parameter and the FROM and TO parameters are mutually exclusive.
Table 129 YKSCAN Command Return Code List (continued) Return Code Meaning -1 An interruption occurred during execution. 0 The command completed normally. The REXX variable corresponding to the scanned volume is created. 4 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. 8 I/O errors were encountered. The REXX variable corresponding to the scanned volume is created.
Table 130 YKSLEEP Command Return Code List Return Code Meaning 0 The command completed normally. 8 Cancellation of the temporarily stopped status due to an interruption. 16 Termination due to invalid parameters. YKSTATS Command Applies to Continuous Access Asynchronous for Mainframe and Continuous Access Journal for Mainframe. Format YKSTATS 1STEM(stem-name-1) 1MSG(stem-name-2) Function This command is a TSO/E command called from REXX scripts.
NOTE: • Start Usage Monitor from the Remote Web Console before executing the YKSTATS command. Set the collection interval of Usage Monitor information to 10 minutes or less. • If the specified copy group is a CAJ copy group and contains the following volumes, in order to obtain correct information, you must start Usage Monitor for the CU containing the journal volumes used by the copy group.
Table 131 YKSTATS Command Return Code List (continued) Return Code Meaning 48 Terminating due to invalid parameters. 128 The command terminated abnormally. The user does not have permission to execute this command. YKSTORE Command Format YKSTORE 1STEM(stem-name-1) 1PREFIX(prefix) 1MSG(stem-name-2) [ 1PATH] [ 1UIDCHK] Function YKSTORE command is a REXX subroutine.
NOTE: • The YKSTORE command is an REXX subroutine, so it should be called from REXX script by the REXX CALL key word instruction. • When you store the current volume status in a configuration file, HP recommends that you specify a prefix other than the prefix used when the copy group was created and manage the copy group separately. Return Codes Table 132 (page 249) lists the return codes to be returned when the YKSTORE command terminates.
The following table describes the correspondence between functions, copy types, and parameter names. Function Copy type Parameter name BC CA Sets the ATTIME suspend time. Y -- Y -- ATTIME Cancels the ATTIME suspend time. Y -- Y -- CANCEL -- -- Y -- DRAIN -- -- Y Y FLUSH -- Y Y PURGE Y -- -- -- QUICK -- Y Y Y FORWARD Suspends the copy pair so that the copy direction goes from the secondary site to the primary site.
ATTIME(timevalue) If you use the ATTIME suspend function, specify the time at which suspend processing is performed. This parameter is valid for copy groups specified by consistency group ID. If you do not use the CAJ ATTIME suspend function, this parameter cannot be specified for a remote storage system. You must use the CAJ ATTIME suspend function for a copy group in which the P-VOLs are Non Gen'ed volumes. If you do not use the CAJ ATTIME suspend function, an I/O error will occur.
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. Take the command execution time into consideration when you specify the time. • Do not specify a time value larger than the command execution time plus 65,536 minutes.
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. For example, generation IDs are useful when you need to maintain consistency between multiple storage systems.
Table 134 Operation When the ATTIME Suspend Time Is Canceled in BC (continued) Target storage system or copy group Setting of the ATTIME suspend time CAJ ATTIME suspend time Operation when the ATTIME suspend time is canceled NORMAL ATTIME CAJ ATTIME suspend suspend time time NORMAL ATTIME suspend time canceled because it has not been set.1 canceled because it has not been set.1 • Storage system that Specified is directly connected to a host -- The CAJ ATTIME suspend time is canceled.
QUICK Applies to Business Copy for Mainframe. Suspends in the QUICK mode. 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.
suspension will be the same as that used when the FLUSH parameter is specified. When neither FORWARD parameter nor REVERSE parameter are specified, the status of copy pairs become SUSPOP. The copy direction is not changed at the time of RESYNC. 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.
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.
Table 135 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. 128 The command terminated abnormally. The user does not have permission to execute this command.
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. When any copy pair takes a status other than SIMPLEX, however, the YKWATCH command terminates abnormally with the return code 8.
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. Use the YKEWAIT command.
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. Specify one of the following types: • I Specify this for a message that reports information. The message is output in by using the destination indicating code 11.
Table 137 YKWTOMSG Command Return Code List (continued) Return code Meaning 1016 The specified text is invalid. 2000 A system error occurred. 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. Table 138 (page 262) lists the sample scripts stored in HPQYSAMT.
Table 138 List of Sample Scripts (continued) Sample script name Overview YKDEMO05 Uses the following CLI commands to demonstrate acquiring information about copy pairs in a copy group, and acquiring operating information: • YKLOAD • YKQUERY • YKSTATS YKDEMO06 Shows an example of using the YKWATCH command. YKDEMO07 Shows an example of using the YKRECVER command. YKDEMO08 Shows an example of failing over a 2DC configuration with HyperSwap and CAJ.
/* - YKEWAIT */ /* */ /* 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". */ /* */ /**********************************************************************/ /* Sample script begins. */ say "#-- BEGIN YKDEMO01.
call printCopyGroupStatus; /* Prints the copy group status info. */ /* * Alternatively, you can use YKEWAIT to retrieve the copy group * status information more quickly as YKEWAIT also updates the Copy * Group structure (but not entirely. The information items that are * RCU-dependant such as C/T Delta and C/T Time are not updated). * Refer to Business Continuity Manager Reference Guide to see how * YKQUERY and YKEWAIT update the Copy Group structure.
* Unlike when TIMEOUT(0) parameter was used, check the return code * to see if it is 0 or not because any non-zero return code for * YKEWAIT indicates that the copy pair state transition did not * happen as expected. */ if rc /= 0 then do call printErrorMessage; exit; 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.
address TSO "YKRESYNC STEM(DEMO_INFO.) MSG(DEMO_MSG.) SELECT(COND)", "FORWARD"; /* * Check the return code to see if it is 0 or not. */ if rc /= 0 then do call printErrorMessage; 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.
else nop; call printCopyGroupStatus; say "#-- END YKDEMO01."; /* The sample script completed. exit; */ /* * printErrorMessage: This procedure prints all of the error messages * in the Message structure when a CLI command failed. */ printErrorMessage: procedure expose DEMO_MSG. do x = 1 to DEMO_MSG.0 say "Severity = " || DEMO_MSG.x.Severity; say "Text = " || DEMO_MSG.x.Text; say "Value = " || DEMO_MSG.x.
do i = 1 to 10 while (outFlag == "INLOOP") /* * Use YKFCSTAT command to view the current status of the * FlashCopy processing. You may choose a volume from which * the status information of the current FlashCopy processing * is retrieved by specifying a device number of a volume with * "DEVN" parameter, such as "DEVN(12AB)". */ address TSO "YKFCSTAT STEM(DEMO_INFO.) MSG(DEMO_MSG.) DEVN(####)"; /* Check the return code of YKFCSTAT to see if it is 0 or not.
YKDEMO03 /* REXX */ /**********************************************************************/ /* */ /* All Rights Reserved. Copyright (C) 2007, 2010, Hitachi, Ltd. */ /* */ /**********************************************************************/ /* /* YKDEMO03 - A sample demonstration script that illustrates how to */ /* use the Business Continuity Manager's REXX CLI commands for */ /* establishing and deleting routes (command devices) and logical */ /* paths between two storage systems.
nop; /* * Now build the logical paths between the primary and the secondary * storage systems in direction from the primary storage system * to the secondary storage system. */ address TSO "YKBLDPTH STEM(DEMO_INFO.) MSG(DEMO_MSG.)"; /* * Check the return code to see if it is 0 or not. */ if rc /= 0 then do call printErrorMessage; exit; end; else nop; /* * Query for the information of the logical paths that were built * in the previous call of YKBLDPTH.
/* * Check the return code to see if it is 0 or not. */ if rc /= 0 then do call printErrorMessage; exit; end; 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.
say "CDEV(Primary) is status = " || DEMO_CDEVP.Cdev.Status; say "CDEV(Primary)'s APID = " || DEMO_CDEVP.Cdev.APID; say "-------------------------------------"; /* * The following example retrieves the information about the command * device in the secondary storage system. * The information is stored under "DEMO_CDEVS" as specified by the * STEM parameter.
/* * Now delete the command device in the primary storage system. As * in the previous YKDELCMD call, supply the appropriate values to * SN, CU, CCA and APID parameters for the command device in the * primary storage system. * Please note that if the route list is available, you do not actually * have to specify CU, CCA and APID parameters. */ address TSO "YKDELCMD SN(#####) MSG(DEMO_MSG.) CU(##) CCA(##)", "APID(####)"; /* * Check the return code to see if it is 0 or not.
YKDEMO04 /* REXX */ /**********************************************************************/ /* */ /* All Rights Reserved. Copyright (C) 2007, 2010, Hitachi, Ltd. */ /* */ /**********************************************************************/ /* */ /* YKDEMO04 - A sample demonstration script that illustrates how to */ /* use the Business Continuity Manager's REXX CLI commands for */ /* using Extended C/T Group feature of TrueCopy Synchronous.
*/ if rc > 8 then do call printErrorMessage; exit; end; else nop; /* * Use YKCONMSG with OP(OPEN) parameter to establish the * interface for monitoring IEA494I message. Use OUTTRAP * of REXX to acquire the handler value that needs to be * in the subsequent YKCONMSG calls. The return code for * completion of YKCONMSG with OP(OPEN) is 0. */ temp = OUTTRAP("MyHandle.
* if it could capture the IEA494I message successfully. */ if rc = 1 then do /* * Extract the message body from the captured IEA494I string. */ parse var MyHandle.1 . IEA494Imsg; /* * 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.
then do call printErrorMessage; /* * Close the EMCS console interface that was opened by * the previous YKCONMSG OP(OPEN) call. Note that the * return code for YKCONMSG with OP(CLOSE) parameter is * 6 if it completed successfully. */ address TSO "YKCONMSG OP(CLOSE)", "HANDLE(x'"HandlerValue"')"; /* * Check the return code to see if it is 6 or not. * Note that the return code for YKCONMSG with * OP(CLOSE) is 6 for successful completion. */ if rc /= 6 then say "YKCONMSG OP(CLOSE) failed.
/* * 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 = " || DEMO_MSG.x.Value; end; return 0; YKDEMO05 /* REXX */ /**********************************************************************/ /* */ /* All Rights Reserved. Copyright (C) 2007, 2010, Hitachi, Ltd.
* of MYTCA copy group before calling YKMAKE. You may use YKEWAIT with * TIMEOUT(0) parameter instead, as demonstrated in YKDEMO01. */ address TSO "YKQUERY STEM(DEMO_INFO.) MSG(DEMO_MSG.)"; /* * Check the return code to see if it is bigger than 8. */ if rc > 8 then do call printErrorMessage; exit; end; else nop; /* * Establish all copy pairs in MYTCA copy group into DUPLEX. This is * for demonstration purpose only. In reality you may already have a * copy group up and running.
if rc /= 0 then do call printErrorMessage; exit; end; else nop; /* * Few of the information items that you can acquire by YKQUERY and * 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. You may view the value for as many pairs as present. */ do x = 1 to DEMO_INFO.CopyGroup.
end; return 0; YKDEMO06 /* REXX */ /**********************************************************************/ /* */ /* All Rights Reserved. Copyright (C) 2007, 2010, Hitachi, Ltd. */ /* */ /**********************************************************************/ /* */ /* YKDEMO06 - A sample demonstration script that illustrates how to */ /* use the Business Continuity Manager's YKWATCH command. */ /* */ /* This sample script assumes the following settings.
/* * Establish all copy pairs in MYTCS copy group into DUPLEX. This is * for demonstration purpose only. In reality you may already have a * copy group up and running so that you do not have to use YKMAKE * before YKWATCH. */ address TSO "YKMAKE STEM(DEMO_INFO.) MSG(DEMO_MSG.) SELECT(COND)"; /* * Check the return code to see if it is 0 or not. */ 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.
/* */ /**********************************************************************/ /* */ /* YKDEMO07 - A sample demonstration script that illustrates how to */ /* use the Business Continuity Manager's YKRECVER 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".
*/ if rc /= 0 then do call printErrorMessage; exit; end; else nop; /* * Wait for MYTCS to become fully established. */ 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.
YKDEMO08 /* REXX */ /**********************************************************************/ /* */ /* All Rights Reserved. Copyright (C) 2009, 2010, Hitachi, Ltd. */ /* */ /**********************************************************************/ /* */ /* YKDEMO08 - A sample demonstration script that illustrates */ /* how to use the Business Continuity Manager's CLI commands to */ /* perform fail-over operations in a 2DC configuration with */ /* HyperSwap and UR.
then do call printErrorMessage exit end else nop call "YKLOAD" "STEM(DEMO_INFO.MYUR2.) PREFIX(BCM.DEMO) GROUP(MYUR2)", "DAD(PRIM) MSG(DEMO_MSG.)" /* * Check the return code of YKLOAD. */ if result /= 0 then do call printErrorMessage exit end else nop /* * 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.
address TSO "YKEWAIT STEM(DEMO_INFO.MYUR2.) MSG(DEMO_MSG.)", "GOTO(HOLD) TIMEOUT(0) NOINVALIDCHECK" /* * Check the return code of YKEWAIT. */ if rc /= 0 then do call printErrorMessage exit end else nop /* * Use YKCONMSG with the OP(OPEN) and MSGID(IOSHM0414I) parameters * to establish the EMCS console interface to monitor the IOSHM0414I * message. Use the REXX instruction OUTTRAP to acquire the handler * value that needs to be referenced in subsequent YKCONMSG calls.
dc = OUTTRAP("OFF") /* * Check the return code of YKCONMSG to see if it is 1 or not. * YKCONMSG with the OP(GET) parameter returns the return code 1 * if it was able to capture the IOSHM0414I message. */ if rc = 1 then do /* * 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.
*/ address TSO "YKEWAIT STEM(DEMO_INFO.MYUR1.)", "MSG(DEMO_MSG.) GOTO(SUSPEND) TIMEOUT(10)" end else do /* * Confirm that the MYTCHS copy pair is in a status * where a DeltaResync can be performed. */ address TSO "YKEWAIT STEM(DEMO_INFO.MYTCHS.)", " MSG(DEMO_MSG.) GOTO(SWAPPING)", " TIMEOUT(0)" /* * Check the return code of YKEWAIT. */ if rc /= 0 then do call printErrorMessage leave /* Exit the loop.
* change the status of MYUR1 to HOLD, and * to change the status of MYUR2 to DUPLEX. */ address TSO "YKRESYNC STEM(DEMO_INFO.MYUR2.) ", "MSG(DEMO_MSG.) DELTAJNL" /* * Check the return code of YKRESYNC. */ if rc /= 0 then do call printErrorMessage leave /* Exit the loop. */ end else nop /* * Wait for completion of copying from the local site to * the remote site. */ address TSO "YKEWAIT STEM(DEMO_INFO.MYUR2.) MSG(DEMO_MSG.)", "GOTO(DUPLEX) TIMEOUT(30)" /* * Check the return code of YKEWAIT.
say "YKCONMSG OP(CLOSE) failed." exit end else nop say "#-- END YKDEMO08." exit /* * printErrorMessage: This procedure prints all of the error messages * in the Message structure when a CLI command failed. */ printErrorMessage: procedure expose DEMO_MSG. do x = 1 to DEMO_MSG.0 say "Severity = " || DEMO_MSG.x.Severity say "Text = " || DEMO_MSG.x.Text say "Value = " || DEMO_MSG.x.
/* 3) Delete the MYUR1 copy pair. */ /* 4) Make the MYUR1 copy pair, exit this sample script, and then */ /* re-execute this sample script again. */ /* 5) Suspend the MYUR2 copy pair. */ /* 6) Execute a DeltaResync on the MYUR1 copy pair. */ /* *) After using this sample script, resync MYTCHS. */ /* */ /**********************************************************************/ /* Sample script begins. */ say "#-- BEGIN YKDEMO09." address TSO "YKENV" call "YKLOAD" "STEM(DEMO_INFO.MYTCHS.) PREFIX(BCM.
* Check the return code of YKEWAIT. */ if (rc < 0)|(rc > 8) then do call printErrorMessage exit end else do if rc /= 0 then do 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.
call printErrorMessage exit end else nop /* * Execute Make(HOLD) on the MYUR1 to change * the status of MYUR1 to one where a DeltaResync * can be performed. */ address TSO "YKMAKE STEM(DEMO_INFO.MYUR1.) MSG(DEMO_MSG.) HOLD" /* * Check the return code of YKMAKE. */ if rc /= 0 then do call printErrorMessage end else nop /* * Confirm that the status of the MYUR1 copy pair is one where a * DeltaResync can be performed. */ address TSO "YKEWAIT STEM(DEMO_INFO.MYUR1.) MSG(DEMO_MSG.
*/ if rc /= 0 then do call printErrorMessage exit end else nop /* * 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 end else nop /* * Confirm that the status of the MYUR2 copy pair is one where a * DeltaResync can be performed. */ address TSO "YKEWAIT STEM(DEMO_INFO.MYUR2.) MSG(DEMO_MSG.
nop /* * Wait for completion of copying from the primary site to * the remote site. */ address TSO "YKEWAIT STEM(DEMO_INFO.MYUR1.) MSG(DEMO_MSG.)", "GOTO(DUPLEX) TIMEOUT(30)" /* * Check the return code of YKEWAIT. */ if rc /= 0 then do call printErrorMessage exit end else nop 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. do x = 1 to DEMO_MSG.
/**********************************************************************/ /* Beginning of sample script. */ /* * Parse DEVN operand of YKDEMO1S cataloged procedure. */ parse upper arg "DEVN("op_devn")"; /* * Retrieve a volume information in the storage system. DEVN * operand is specified a device number of volume for input. STEM * operand is specified a variable of volume information for output. */ address TSO "YKQRYDEV STEM(DEMO.) DEVN("op_devn") MSG(MSG.
YKDEMO11 /* REXX */ /**********************************************************************/ /* */ /* All Rights Reserved. Copyright (C) 2010, Hitachi, Ltd. */ /* */ /**********************************************************************/ /* */ /* YKDEMO11 is an example script for setting BCM environment */ /* variables to local variables and then printing them out. */ /* */ /* Below is a list of local variables that store BCM environment */ /* variables. The default value for each is "N/A".
/**********************************************************************/ /* */ /* All Rights Reserved. Copyright (C) 2011, Hitachi, Ltd. */ /* */ /**********************************************************************/ /* */ /* YKDEMO12 is an example script that demonstrates recovery of TC */ /* pairs that became inconsistent because of interrupted FlashCopy */ /* copy process. This script discovers CONSLOST copy pairs in the TC */ /* group, deletes them, and then re-creates them.
Do Do i = 1 To DEMO_INFO.CopyGroup.1.Pair.0 If DEMO_INFO.CopyGroup.1.Pair.i.State == "CONSLOST" Then Do /* * Delete the CONSLOST pair in MYTCS. */ P_DEVN = DEMO_INFO.CopyGroup.1.Pair.i.Pri.Devn S_DEVN = DEMO_INFO.CopyGroup.1.Pair.i.Sec.Devn Address TSO "YKDELETE STEM(DEMO_INFO.) MSG(DEMO_MSG.)", "DEVN("P_DEVN","S_DEVN")" /* * Check the return code of YKDELETE.
Exit End Else Nop End Else Nop End End Else Nop 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 = " || DEMO_MSG.x.Text Say "Value = " || DEMO_MSG.x.
exit; end; else nop; /* * Call YKQUERY to refresh the information in the Copy Group structure * of MYUR4X4 copy group container before calling YKMAKE. You may use * YKEWAIT with TIMEOUT(0) parameter instead, as demonstrated in * YKDEMO01. */ address TSO "YKQUERY STEM(DEMO_INFO.) MSG(DEMO_MSG.)"; /* * Check the return code to see if it is bigger than 8. */ if rc > 8 then do call printErrorMessage; exit; end; else nop; /* * Establish all copy pairs in MYUR4X4 copy group container into DUPLEX.
outFlag = "INLOOP"; do i = 1 to 10 while (outFlag == "INLOOP") /* * Calls the YKQEXCTG command to obtain the EXCTG information for * MYUR4X4. If the copy direction is the reverse direction, specify * the TO(PRIMARY) parameter. */ address TSO "YKQEXCTG STEM(DEMO_INFO.) MSG(DEMO_MSG.)", "TO(SECONDARY)"; /* Check the return code of YKQEXCTG to see if it is 0 or not. if rc /= 0 then do call printErrorMessage; exit; end; else nop; */ if DEMO_INFO.Exctg2.
return 0; Command details 305
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. Names of configuration files Running Business Continuity Manager data objects exist as REXX variable structures. For details about these data objects, see “About REXX Variable Structures” (page 324). Business Continuity Manager data objects that are not running exist as XML format files (Configuration files) in disks.
Table 140 (page 307) describes the maximum length and characters that can be specified for the items of the configuration file names. Table 140 Maximum length and characters that can be specified for the items of the configuration file names Item Maximum length Specifiable characters Prefix 16 Copy group ID 44 - (5 + prefix-length) Device address domain ID 44 - (13 + prefix-length), or 28 whichever is smaller Route list ID 8 A string consisting of one or more parts, joined by periods.
Table 142 Configuration File Dataset Format (continued) Type of the configuration file DSORG RECFM LRECL BLKSIZE (bytes) Command device definition file PS VB 256 4,096 Path set definition file PS VB 256 4,096 NOTE: The configuration files are only for reference. If the configuration files are changed, correct operation cannot be guaranteed. Table 143 (page 308) describes the required disk space for the configuration file.
Table 144 Size to Be Increased When a Condition is Satisfied No. Type of the configuration file Condition for the size to be increased Size to be increased (bytes) 1 Copy group definition file The EXCTG attribute has been defined. 400 The YKSTORE command has been used in the script. 400 2 Copy group definition file + A x 210 + J x 16 + A x (2,760 + J x 16) + B x 90 XML Document Type Definitions Business Continuity Manager operates under z/OS.
The following table gives the meanings of the attributes of the DiskDevice elements.
• Attribute name Meaning Map Unit of difference management OpenMF When Y, the Open/MF Consistency Preservation Function is used. TCA Option The following table gives the meanings of the attributes of the TCA_Options elements.
The following table gives the meanings of the attributes of the UR_Options elements.
• RelatedDKCState The following table gives the meanings of the attributes of the RelatedDKCState elements.
• Attribute name Meaning DuplexCt DUPLEX count PendingCt PENDING count RevresyncCt REVRSY count SuspendOpCt SUSPOP count SuspendVSCt SUSPVS count SuspendCuCt SUSPCU count SuspendErCt SUSPER count SwappingCt SWAPPING count TransitionCt TRANS count InvalidCt INVALID count ReversedCt Count of copy pairs with reverse direction from Secondary to Primary HoldCt HOLD count HoldErCt HOLDER count ChkJnlCt CHKJNL count HoldTrnsCt HOLDTRNS count NoDeltaCt NODELTA count ConslostCt CO
NoDeltaCt ConslostCt ExctgEnable CDATA#IMPLIED CDATA#IMPLIED (0|1)#IMPLIED > The following table gives the meanings of the attributes of the CopyGroupContainer elements. • Attribute name Meaning ContainerID Copy group ID Format When SIMPLE, indicates the copy group structure earlier than version 2.0.
FwdSuper_SerialNum RevSuper_SerialNum CDATA#IMPLIED CDATA#IMPLIED > The following table gives the meanings of the attributes of the EX_DefInfo elements.
The following table gives the meanings of the attributes of the HostAddressedDisk elements. • Attribute name Meaning Devn Device number Volser Volume serial number SoftwareKeys The following table gives the meanings of the attributes of the SoftwareKeys elements.
SecCUNum PriCCA SecCCA CDATA#IMPLIED CDATA#IMPLIED CDATA#IMPLIED > The following table gives the meanings of the attributes of the Paths elements. Attribute name Meaning ID Path set ID Description Descriptions added by the user The following table gives the meanings of the attributes of the CUPath elements.
• Attribute name Meaning SecCUNum Secondary CU number PriCCA The CCA of the device to which I/Os are issued when path operations are performed on the primary site where the path is used. SecCCA 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.
SLOTSIZE CDATA#IMPLIED > The following table gives the meanings of the attributes of the CDEVGRP elements. Attribute name Meaning DADID DAD ID to which a command device belongs APID APID1 LABEL Route label CYL First cylinder (fixed value of 0001) HD First track (fixed value of 00) SLOTSIZE Slot size of dummy dataset (fixed value of 2000) 1 • XXXX is set for a value whose definition is not yet complete.
• Attribute name Meaning Model Storage system model Microcode Microcode number IFType Interface version PhysicalSerialNum Physical storage system serial number DKC The following table gives the meaning of the attribute of the DKC elements.
• Command device definition file • Path set definition file. Example Contents of Copy Group Definition File The example of the contents of the copy group definition file, prefix.GRP.copy-group-id, is shown: PAGE 323SSID="2340" CCA="16" Cyls="3339" External="Y"/>
Example Contents of Route List Definition File The example of the contents of the route list definition file, prefix.ROUTE.route-list-id, is shown: PAGE 324> PAGE 325Table 145 Copy Group Structure (continued) REXX variables Description PendingCt PENDING count (sum value of CopyGroup.n.PendingCt) DuplexCt DUPLEX count (sum value of CopyGroup.n.DuplexCt) TransitionCt TRANS count (sum value of CopyGroup.n.TransitionCt) SuspendOpCt SUSPOP count (sum value of CopyGroup.n.SuspendOpCt) SuspendCuCt SUSPCU count (sum value of CopyGroup.n.SuspendCuCt) SuspendVSCt SUSPVS count (sum value of CopyGroup.n.SuspendVSCt) SwappingCt1 SWAPPING count (sum value of CopyGroup.
Table 145 Copy Group Structure (continued) REXX variables Description PriTCAKeys Primary TCA key (minimum value of Key.TCA in the Host-Discovered Array structure of the storage system at the primary site) PriSIKeys Primary BC key (minimum value of Key.
Table 145 Copy Group Structure (continued) REXX variables 24 Description Info If this is Valid, the REXX under Exctg2 are valid. StartTime EXCTG information acquisition start time (yyyymmdd hh:mm:ss.nnnnnn) EndTime EXCTG information acquisition end time (yyyymmdd hh:mm:ss.nnnnnn) ArbCTTime25 EXCTG consistency time (yyyymmdd hh:mm:ss.
Table 145 Copy Group Structure (continued) REXX variables Description 4 MatchingPerCent Copy pair matching rate (average value of CopyGroup.n.Pair.n.MatchingPerCent) CopyType Copy type • SI| • TC • TCA • UR InitPace Copy pace • SLOW • NORMAL ProtectMode23 Protect mode TC_FreezeScpMode23 When Y, makes SCP if SUSPER. TC_TimeStampMode When Y, the timestamp transfer mode is enabled.
Table 145 Copy Group Structure (continued) REXX variables Description Unit for suspending CAJ copy pairs UR_ErrorLevel • GROUP • VOLUME CAJ Consistency time mode UR_CTTimeMode • JOURNAL • VOLUME • ASIS UR_PathID Path group ID of CAJ Related_ID Related ID Related_Type Related type PresetMode Whether to use the CAJ ATTIME suspend function • NORMAL: Do not use • CAJ: Use Suspend mode used by the CAJ ATTIME suspend function.
Table 145 Copy Group Structure (continued) REXX variables Description JNLState 16, 18 ErrorCode Rev14 16 Journal status Error code Model Model • USP (XP12000/XP10000) • USPV (XP24000/XP20000) • VSP (XP P9500) • VSPG1000 (XP7) SerialNum ArbCmdNo 15 ArbCTTime16, 17 Serial number Arbitration command device EXCTG consistency time (yyyymmdd hh:mm:ss.
Table 145 Copy Group Structure (continued) REXX variables Description Pri_JNL_Meta Metadata % used rate in master journal volume. The percentage used of the Journal Metadata capacity available in the Journal Volume(s) registered to M-JNL. Pri_JNL_Data Data % used rate in master journal volume. The percentage used of the Journal Data capacity available in the Journal Volume(s) registered to M-JNL. Sec_JNL_Meta19 Metadata % used rate in restore journal volume.
Table 145 Copy Group Structure (continued) REXX variables Description Model Primary storage system Model • USP (XP12000/XP10000) • USPV (XP24000/XP20000) • VSP (XP P9500) • VSPG1000 (XP7) Sec Devn Secondary device number SerialNum Secondary storage system serial number CUNum Secondary CU number SSID Secondary SSID CCA Secondary CCA IFType Secondary interface version Model Secondary storage system Model • USP (XP12000/XP10000) • USPV (XP24000/XP20000) • VSP (XP P9500) • VSPG1000 (XP7) Table f
NOTE: 17 Displayed in GMT.
Table 146 (page 334) shows the Host-Discovered Array Index structure. The prefix for the name of the Host-Discovered Array Index structure is one of the following: • When the YKLOAD command is used for creating the structure: HCC.HDA. • When the YKSCAN command is used for creating the structure: stem-name-specified-in-ARRAYS-parameter Each REXX variable is preceded by a period (.).
Table 147 (page 335) shows the Host-Discovered Array structure. The prefix for the name of the Host-Discovered Array structure is one of the following: • When the YKLOAD command is used for creating the structure: stem-name-specified-in-STEM-parameter and dad-id • When the YKSCAN command is used for creating the structure: stem-name-specified-in-opSTEM-parameter Each REXX variable is preceded by a period (.).
A value of 0 is also set when the YKLOAD command is executed. 2 Created for each CU, thus the device information is created for each defined CU (CU number). The xx in CUxx is a CU number (hexadecimal value). Example of CUxx: If C400 is set to SSID of CU=05, the value for CU05.SSID is C400. 3 Created for each CCA, thus the device information is created for each defined CCA (CCA number). The xx in CCAxx is a CCA (hexadecimal value).
Table 148 Route List Structure (continued) REXX variables 3 n Description SerialNum Storage system serial number used as route entry DADID DAD ID to which a command device belongs IFTYPE Storage system interface version CDEV Devn1 Device number of the command device in the storage system Volser1 Volume serial number of command device in DKC 1 CU number of the command device in the storage system CUNum 1 SSID SSID of the command device in the storage system CCA1 CCA of the command device i
1 Created for each command. When more than one message exists in one command, the process is repeated for each message. NOTE: The element names ending with 0 include the number of .n. elements of the node after REXX conversion. Device Information Structure Table 150 (page 338) shows the device information structure. The prefix for the name of the device information structure is stem-name-specified-in-STEM-parameter-of-the-YKQRYDEV-command. Each REXX variable is preceded by a period (.).
Table 150 Device Information Structure (continued) REXX variables Description n Status of CA copy pair State • PENDING (01) • DUPLEX (02) • SUSPOP (03) • SUSPOP (04) • SWAPPING (04) • SUSPOP (05) • SUSPCU (06) • SUSPER (07) • SUSPCU (08) • SUSPER (09) • SUSPER (50) • TRANS (60) • TRANS (61) • SUSPER (62) • SUSPER (A0) Data inconsistency in the Cnt Ac-S Z copy pair (CONSLOST status) CONSLOST • Y: The copy process of the related FlashCopy was interrupted.
Table 150 Device Information Structure (continued) REXX variables Description Copy mode Mode • Sync • Async Unit of difference management MAP • CYL • TRK ProtectMode7 Protect mode • PROTECT • PERMIT FlowControl6 Flow control • Y • N FreezeSCPMode3, 5, 7 Freeze SCP • Y • N InitPace3 Copy pace • SLOW • NORMAL CT ID6, 8 Consistency group ID TimerType6 C/T group timer type • SYSTEM • LOCAL • NONE Status6, 9 C/T status Time6 Consistency time (yyyymmdd hh:mm:ss.
Table 150 Device Information Structure (continued) REXX variables Description • SUSPEND (TIMESTAMP): Suspend was performed because the ATTIME suspend time elapsed. • SUSPEND (TIMEOUT): Suspend was performed because a timeout occurred.
Table 150 Device Information Structure (continued) REXX variables Description Time 9 ATTIME suspend time (yyyymmdd hh:mm:ss.nnnnnn) Tout Timeout value (minutes) Status ATTIME status • Notset: The ATTIME suspend time is not set. • PRESET: The ATTIME suspend time is set, but suspend has not been performed. • SUSPEND (TIMESTAMP): Suspend was performed because the ATTIME suspend time elapsed. • SUSPEND (TIMEOUT): Suspend was performed because a timeout occurred.
Table 150 Device Information Structure (continued) REXX variables Description SIStatus BC copy group status • WAITING: Suspend processing has not been started. • SUSPENDING: Suspend processing is ongoing. • SUSPEND: Suspend processing ended normally. • ERROR: Suspend processing ended abnormally. URStatus The status of the Cnt Ac-J Z copy group when the BC copy group is suspended. • DUPLEX: When suspend was performed, all Cnt Ac-J Z copy pairs were in DUPLEX status.
Table 150 Device Information Structure (continued) REXX variables Description • HOLDER (73) • NODELTA (74) Protect mode ProtectMode • PROTECT • PERMIT ExctgRegistFlag EXCTG registration flag • 0 • 1 If the EXCTG function is applied, 1 is set only when the journal group that has the applicable volume has been registered in EXCTG.
Table 150 Device Information Structure (continued) REXX variables Path CUxx Description TIME Consistency time acquired in accordance with the storage system's system option mode (TOD or disk controller time) JNL_TIME Consistency time acquired from the journal (TOD or disk controller time) SVOL_TIME Consistency time acquired from the volume (TOD or disk controller time) Info1 Existence of inter-CU path information (Valid) 0 Number of inter-CU logical paths established from the CU to which this de
Table 150 Device Information Structure (continued) REXX variables Description • VSP (XP P9500) • VSPG1000 (XP7) Serial number of secondary storage system Serialnum Number of path group IDs established from the storage system to which this device belongs to the storage system of Sec.
8 Information can be acquired for CA with consistency group ID specified. 9 Displayed in GMT. 10 Information can be acquired for P-VOL when the status for the Continuous Access Journal copy pair is PENDING or DUPLEX. 11 When the copy type is CAJ, and the following models supports the relevant attribute settings, information is displayed.
Table 151 Path Set Structure (continued) REXX variables Description Interface version of primary storage system IFType 1 Sec PathID Primary path group ID SSID2 Primary SSID CUNum Primary CU number CCA The CCA of the device to which I/Os are issued when path operations are performed on the primary site where the path is used. DEVN The device number of the device to which I/Os are issued when path operations are performed on the primary site where the path is used.
Table 151 Path Set Structure (continued) REXX variables Description Sec Setting port The initiator port number of the secondary site of the logical path (on the storage system indicated by Sec.SerialNum) The number of physical paths from the secondary site to the primary site set in the storage system (0 to 8) 0 1 These variables are valid when the n.type value is DKC. 2 These variables are valid when the n.type value is CU.
Table 152 FlashCopy Information Structure (continued) REXX variables Description State6 Existence of a failure suspension during FlashCopy: • 0: No • 1: Yes State7 Existence of an incremental FlashCopy relationship: • 0: No • 1: Yes 1 When the information is acquired, Valid is stored. REXX Variables Updated by YKQUERY and YKEWAIT Commands Table 153 (page 350) shows the copy group structure's REXX variables that are updated by the YKQUERY command and the YKEWAIT command.
Table 153 REXX Variables Updated by YKQUERY and YKEWAIT (continued) REXX variables YKQUERY YKEWAIT DEVN specified DEVN not specified DEVN specified DEVN not specified InvalidCt N Y N Y PendingCt N Y N Y SuspendOpCt N Y N Y SuspendCuCt N Y N Y SuspendVSCt N Y N Y SuspendErCt N Y N Y TransitionCt N Y N Y ReversedCt N Y N Y SwappingCt N Y N Y RevrsyncCt N Y N Y HoldCt N Y N Y HoldErCt N Y N Y HoldTrnsCt N Y N Y NoDeltaCt N Y N Y Consl
Table 153 REXX Variables Updated by YKQUERY and YKEWAIT (continued) REXX variables YKQUERY DEVN specified YKEWAIT DEVN not specified DEVN specified DEVN not specified MatchingPerCent N Y N N Reversed N Y N Y CTTime N Y N N Diagnosis N Y N N Legend: Y: Updated. N: Not updated. --: Not applicable.
Table 154 REXX Variables Updated by YKQUERY Command with the TO Parameter Specified (continued) REXX variables Copy direction: Forward Copy direction: Reverse1 PRIMARY specified SECONDARY PRIMARY specified specified SECONDARY specified MatchingPerCent Y F2, 5 F2 Y CopyGroup 0 -- -- -- -- SimplexCt Y Y Y Y DuplexCt Y Y Y Y InvalidCt Y Y Y Y PendingCt Y Y Y Y SuspendOpCt Y Y Y Y SuspendCuCt Y Y Y Y SuspendVSCt Y Y Y Y SuspendErCt Y Y Y Y TransitionCt Y
Table 154 REXX Variables Updated by YKQUERY Command with the TO Parameter Specified (continued) REXX variables Copy direction: Forward Pair PRIMARY specified SECONDARY PRIMARY specified specified SECONDARY specified -- -- -- -- Y Y Y Y CTDelta F2 Y Y F2 MatchingPerCent Y F2, 5 F2 Y Reversed Y Y Y Y Y4 Y4 F2 Y7 Y F6, 7 0 n Copy direction: Reverse1 State CTTime 4 F2 Diagnosis F6, 7 4 7 1 Not applicable if the copy type is BC.
Table 155 REXX Variables Updated by the YKEWAIT Command with the TO Parameter Specified (continued) REXX variables Copy direction: Forward Copy direction: Reverse PRIMARY specified SECONDARY PRIMARY specified specified SECONDARY specified SwappingCt F1 Y Y F1 ReversedCt Y Y Y Y SuspendErCt Y Y Y Y InvalidCt Y Y Y Y RevrsyncCt Y Y Y Y HoldCt Y Y Y Y HoldErCt Y F1 F1 Y HoldTrnsCt Y F1 F1 Y NoDeltaCt Y F1 F1 Y ConslostCt Y Y Y Y CopyGroup 0 -- -- -- -
1 Because information cannot be acquired, 0 is set. Legend: Y: Updated F: Updated to a fixed value --: Not applicable CSV Files Used by the Copy Group Definition File Generation Function CSF File Dataset Formats and Disk Requirements Table 156 (page 356) shows the CSV file dataset formats that are used by the copy group definition file generation function.
CSV files used by the YKIMPORT command • Delimit item values with the comma. If there is no value for an item, you must specify a comma to represent the empty item. • Item values can be enclosed in double-quotation marks. In this case, only values enclosed in the double-quotation marks are written into the copy group definition file. • Commas specified within a character string enclosed in double-quotation marks are not handled as delimiters.
Item name Data type1 Value to be specified Length (characters) Specify in the range from 00 to 7F For CAJ: Specify in the range from 00 to FF. SubCTID Subconsistency group ID Hexadecimal 1-2 Specify in the range from 00 to FF. Number-Of-Pairs 1 2 Number of times the specified copy pair is to be repeated3 Decimal 1-5 Specify in the range from 1 to 99,999. For details about data types, see the table of syntax elements in “ Copy Types and Targets for Which Commands Can Be Executed” (page 179).
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 7311, 7313, and 7314 are defined for the P-VOL.
For each item, specify the following values.
Figure 99 Example of a 4x4 Configuration Defined by the YKIMPORT Command • Pair information CSV file //*PDEVN,PSN F101 , F201 , • ,PCU,PCCA,SDEVN,SSN , , ,A101 , , , ,A201 , ,SCU,SCCA,CTID,SubCTID,Number-Of-Pairs , , ,01 ,02 ,1 , , ,03 ,04 ,1 EXCTG information CSV file //*PSN ,SSN ,CTID,SubCTID,FEXCTG,FSpDKC,FarbCDEV,REXCTG,RSpDKC,RarbCDEV 14002,14001,01 ,02 ,1 ,S , , , , 64051,64050,03 ,04 ,1 , ,002F , , , • CTG information CSV file //*PSN ,SSN ,CTID,SubCTID,PATHID 14002,14001,01 ,02 ,01 64051,6405
//*PDEVN,PSN,PCU,PCCA,SDEVN,SSN,SCU,SCCA,CTID,SubCTID,Number-Of-Pairs F101,14002,01,01,A101,14001,01,01,01,02,1 F201,64501,01,01,A201,64050,01,01,03,04,1 • EXCTG information CSV file //*PSN,SSN,CTID,SubCTID,FEXCTG,FSpDKC,FarbCDEV,REXCTG,RSpDKC,RarbCDEV 14002,14001,01,02,1,S, , , , 64051,64050,03,04,1, ,002F, , , • CTG information CSV file //*PSN,SSN,CTID,SubCTID,PATHID 14002,14001,01,02,01 64051,64050,03,04,02 362 Data Objects
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 This section describes the parameter files used with BCM Monitor. Content of the BCM Monitor Parameter Files “Parameter Files Used with BCM Monitor” (page 363) lists and describes the parameter files used with BCM Monitor.
If both a continuation symbol and a comment symbol are specified on the same line, the comment symbol takes precedence. No more than one parameter can be specified per line. When a continuation symbol is used, the next line is treated as part of the same line. Maximum number of characters per line Even with the use of continuation symbols, the maximum number of characters per line is 32,760.
Information to be set This parameter file sets the option information required for starting BCM Monitor. Parameters CYCLETIME=cycle-time ~ ((10 to 999999))<<300>> Specifies the cycle time in seconds for monitoring the copy group status. The following figure shows the concept of the copy group status monitoring cycle. If the specified value is from 0 to 9, 10 seconds is used for CYCLETIME.
Specifies the default error action to be used when no error action is specified in the ACTION parameter in the YKMONCG file. SKIPONLY Skips the cycle where an error occurred, but starts monitoring again from the next cycle. STOP Places the monitoring status of all copy groups specified in the CGID parameter to INACTIVE EXIT(return-code) ~ ((0 to 4095)) Stops BCM Monitor with the specified return code.
Figure 101 Structure of Parameters in the YKMONCG File 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. • An error occurs if more than one CGID parameter with the same copy group ID is specified.
Copy Group Parameters Format CGID=copy-group-ID CGPREFIX=prefix CGDAD=DADID [CGROUTE=route-list-ID[,{route-label|'*'}]]] [CGMONSTAT={ACTIVE|INACTIVE}] [CGSTARTUPSTATUS=startup-status,startup-action[,NOCANCEL]] Information to be set You can specify the startup status of a copy group that you want to monitor, and the startup action to be executed if the copy group is not in startup status.
INACTIVE Does not montior the copy group. CGSTARTUPSTATUS=startup-status,startup-action[,NOCANCEL] If this parameter is specified and the copy group status is not the specified startup status when BCM Monitor starts, the specified startup action is executed. The processing of this parameter is also for copy groups that has ACTIVE or INACTIVE specified for the CGMONSTAT parameter.
NOCANCEL Does not execute the YKSUSPND command with the CANCEL parameter specified. You can specify this value only if you specified DUPLEX as the startup status. Processing for Changing to the Startup Status This section describes the processing of changing the copy group to the startup status when ADJUST is specified for the CGSTARTUPSTATUS parameter.
Table 163 Processing for the Specified Startup Status (continued) Specified startup status Copy pair status Processing CONSLOST SUSPOP Executes the following commands: SUSPCU • YKRESYNC SUSPVS SUSPOP All SUSPOP • YKEWAIT GOTO(DUPLEX) Does nothing. SUSPVS SIMPLEX SWAPPING Places the monitoring status of all copy groups specified in the CGID parameter to INACTIVE.
Table 163 Processing for the Specified Startup Status (continued) Specified startup status Copy pair status Processing 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;]]... Information to be set Specifies the target status, action, and error action for the copy group.
Table 164 Combinations of Target Statuses and Actions That Can Be Specified (continued) Target status Action SWAPPING Y Y Y Y Y N N N Y Y Y Y Y Y Y Y Y Y N Y Y Y 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. For the specifiable values, see “Combinations of Target Statuses and Actions That Can Be Specified” (page 372).
EXIT(return-code) ~ ((0 to 4095)) Stops BCM Monitor with the specified return code. HP recommends hat you specify a value other than 0, 4, 8, or 12 because these numbers are already used as BCM Monitor return codes. REPORT(copy-group-ID[,{SUMMARY|DETAIL|STATS|RPO}[,{CONS|ERROR|STATUS|INFO}]]) Outputs report information for the specified copy group. {SUMMARY|DETAIL|STATS|RPO} Specifies the type of report information: SUMMARY Outputs summary information about the copy group.
Specifies the YKRESYNC command parameters. The STEM and MSG parameters are ignored even if they are specified. For details on the specifiable parameters, see the description of parameters in “YKRESYNC Command” (page 237). SUSPEND(copy-group-ID[,'command-parameter']) Executes the YKSUSPND command with the specified command parameters on the specified copy group. command-parameter ~ Specifies the parameters of the YKSUSPND command.
STATUS Outputs as a YK8300I message, which reports a status. INFO Outputs as a YK8400I message, which indicates information. STOPPOINT(label-name) ~
Table 166 Copy Pair Status Priority (continued) Priority Copy pair status 8 PENDING 9 TRANS 10 HOLDTRNS 11 REVRSY 12 SUSPVS 13 SUSPOP 14 HOLD 15 SWAPPING 16 DUPLEX Example 2 Example The following is an example of the STATUS parameter: STATUS=SUSPOP,ACTION=RESYNC(SICG,0,’FORWARD’); EXIT(64); NOTE: • If a specified value contains a comment symbol, enclose the entire value in single quotation marks.
5 Parameters for YKBTSCAN This chapter describes the parameters for YKBTSCAN. Functionality YKBTSCAN executes local scans by batch. YKBTSCAN locally scans the volume of the device number or volume serial number that you entered from SYSIN, and then creates a disk configuration definition file for the detected volume. If the disk configuration definition file already exists, YKBTSCAN updates the file by adding the newly obtained volume information to the existing disk configuration definition file.
DAD(device-address-domain-ID)~ Specify the current host's device address domain ID (host device address domain ID). For details about the maximum length that can be specified, see “Names of configuration files” (page 306). DEVN(nnnn[:nnnn][,nnnn[:nnnn]]...)~ <4-digit hexadecimal number> Specify the device number of a volume to be scanned. To specify a range of device numbers, insert a colon between the first and the last device numbers for scanning.
For scanning the volumes with the device numbers ranging from 1100 to 1105 and the device number 1107 PREFIX(PREFIX1) DAD(DAD1) DEVN(1100:1105,1107) For scanning the volumes with the volume serial numbers VOL001, VOL005, and VOL009, and the volume serial numbers ranging from VO020 to VOL030 PREFIX(PREFIX1) DAD(DAD1) VOLSER('VOL001','VOL005','VOL009') VOLSER('VOL020':'VOL030') For scanning the volumes with the device numbers ranging from 1100 to 1105, and the volumes with the volume serial numbers ranging
//********************************************************************* //* //* All Rights Reserved. Copyright (c) 2013, Hewlett-Packard //* //*********************************************************************//BTCSCANA JOB CLASS=A,MSGCLASS=A,NOTIFY=&SYSUID,TIME=1440,REGION=0M //YKBTSCAN EXEC PGM=YKBTSCAN,PARM='SPACE(5,1)' //SYSEXEC DD DSN=HP.VXXXXXX.HPQYEXET,DISP=SHR //STEPLIB DD DSN=HP.VXXXXXX.HPQYLNKT,DISP=SHR //SYSTSPRT DD SYSOUT=* //SYSABEND DD SYSOUT=* //SYSIN DD * PREFIX(YUKON.
6 Support and other resources Contacting HP For worldwide technical support information, see the HP Support Center: http://www.hp.
• TSO/E REXX Reference, SC28-1975 • eNetwork Communications Server: IP API Guide, SC31-8516 • Communications Server IP Configuration Guide, SC31-8725 • Communications Server IP Configuration Reference, SC31-8726 • ISPF User's Guide Volume I, SC34-4791 Manuals related to z/OS: • Program Directory for IBM Library for REXX on zSeries Alternate Library, GI10-3243 • MVS Initialization and Tuning Reference, SA22-7592 • MVS Programming: Assembler Services Reference, SA22-7606, SA22-7607 • MVS Sett
Conventions for storage capacity values XP 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,0002 bytes • 1 GB (gigabyte) = 1,0003 bytes • 1 TB (terabyte) = 1,0004 bytes • 1 PB (petabyte) = 1,0005 bytes • 1 EB (exabyte) = 1,0006 bytes XP P9000 disk arrays use the following values to calculate logical storage capacity values (logical devices): • 1 KB (kilobyte) = 1,024 bytes • 1 MB
CAUTION: IMPORTANT: NOTE: TIP: Indicates that failure to follow directions could result in damage to equipment or data. Provides clarifying information or specific instructions. Provides additional information. Provides helpful hints and shortcuts.
7 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.
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.
(1) The scan results of PPRC copy pairs are displayed. For details on the displayed messages, see HP XP XP7 for Business Continuity Manager 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. Underlined values are values specified for each item in the Scan Copy Pair Inside Storage System panel.
B Symbols Used in Syntax Explanations (page 389) shows the symbols used in syntax explanations. (page 389) shows the syntax elements that are used. Table 170 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. SD Bold code-font characters indicate the abbreviation for a command.
Table 171 Syntax Elements (continued) Syntax element Specifiable characters 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. GROUP string A string consisting of one or more parts, joined by periods. Each part ABC.DEF consists of upper-case alphanumeric characters.
Glossary A 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.
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 Rate at which pair P-VOL data matches pair S-VOL data 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 configuration D DAD Device address domain.
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’ Guide. F 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. FlashCopy An IBM function that copies data quickly. For details, see DFSMS Advanced Copy Services.
L 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).
3DC Multi-Target configuration A configuration to perform remote copying with a nearby local site and a distant remote site, in 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. The applicable copy type is UR.
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. You can specify this command in the MODIFY command to display the number of copy pairs in various copy pair statuses, the details for each copy pair, and the operational information and consistency information for copy groups.
suspend status A collective name for the SUSPOP status, SUSPCU status and, SUSPER status system logger service A function that writes, displays, and deletes the MVS standard log T target port A Fibre Channel interface port on the RCU. This port is connected to the MCU by a Fibre Channel interface (FIBRE) cable. TC TrueCopy, a function that remotely creates and manages volume copies between storage subsystems. This writes a copy pair to the S-VOL synchronously with the P-VOL.
Index A Add Attribute panel, 50 Add Copy Group Panel, 67 Add Path Set panel, 56 Add Route Entry panel, 51 Add Route List ID panel, 43 ALLJNL parameter YKRESYNC command, 239 APID parameter YKDELCMD command, 191 ARRAYS parameter YKSCAN command, 244 Assign Port panel, 63 ATOPT parameter YKSUSPND command, 252 ATTIME parameter YKSUSPND command, 251 B BASEGROUP parameter YKIMPORT command, 214 BC Copy Group Make Options panel, 151 BC Copy Group Resync Options panel, 157 BC Copy Group Suspension Options panel, 153
YKDELCMD command, 191 YKQRYDEV command, 228 CU Selection List for Edit devn panel, 35 D DAD parameter YKLOAD command, 219 YKWATCH command, 259 data objects, 306 dataset format configuration file, 307 Define Command Device panel, 47 Define Remote Command Device panel, 49 DELTAJNL parameter YKRESYNC command, 239 device information structure, 338 DEVN parameter YKDELCMD command, 191 YKDELETE command, 193 YKEWAIT command, 205 YKFCSTAT command, 209 YKMAKE command, 222 YKQHPATH command, 226 YKQRYDEV command, 228
YKDELPTH command, 196 YKQRYPTH command, 231 YKRESYNC command, 238 YKSUSPND command, 255 FROM parameter YKSCAN command, 243 FROMVSN parameter YKSCAN command, 244 G GENID parameter YKSUSPND command, 253 GOTO parameter YKEWAIT command, 203 YKWATCH command, 258 GROUP parameter YKEXPORT command, 207 YKLOAD command, 219 YKWATCH command, 258 H HANDLE parameter YKCONMSG command, 190 help obtaining, 382 Help panel, 15 HOLD parameter YKMAKE command, 222 Host ID Settings Information panel, 26 Host-Discovered Array I
path set structure, 347 PCU parameter YKBLDPTH command, 186 YKDELPTH command, 196 YKQRYPTH command, 230 PPRC Copy Pair scan result, 387 PREFIX parameter YKEXPORT command, 207 YKIMPORT command, 213 YKLOAD command, 219 YKSTORE command, 248 YKWATCH command, 258 PREPARE parameter YKRESYNC command, 240 PSN parameter YKBLDPTH command, 186 YKDELPTH command, 195 YKQRYPTH command, 230 PURGE parameter YKSUSPND command, 254 YKSUSPND command, 257 YKWATCH command, 260 REVERSE parameter YKBLDPTH command, 187 YKDELPTH co
ISPF panel, 15 Setting Information panel, 16 sidefile flow restriction, 78 SMODEL parameter YKQRYDEV command, 228 SN parameter YKBLDCMD command, 184 YKDELCMD command, 191 YKQRYDEV command, 228 Sort CAA Copy Group Statistics panel, 120 Sort CAJ Copy Group Statistics panel, 123 SORT command, 13 SORT command format, 13 Sort Copy Group Container panel, 89 Sort Logical Paths in the Path Set panel, 63 Sort the Copy Group Pairs List panel, 89 Sort the Copy Group Pairs Status panel, 127 Sort the Copy Groups Panel,
MSGID parameter, 189 TIMEOUT parameter, 189 YKDELCMD command, 190 executing, 102 YKDELETE command, 192 YKDELPTH command , 195 YKDEMO01 overview of sample script, 262 sample script, 263 YKDEMO02 overview of sample script, 262 sample script, 268 YKDEMO03 overview of sample script, 262 sample script, 270 YKDEMO04 overview of sample script, 262 sample script, 275 YKDEMO05 overview of sample script, 263 sample script, 279 YKDEMO06 overview of sample script , 263 sample script, 282 YKDEMO07 overview of sample scr