manualshive.com logo in svg

HP P9000, Reference Manual

Share
Download
HP P9000 Reference Manual Download Page 305

           */                                                                   
          If rc /= 0 Then                                                       
            Do                                                                  
              Call PrintErrorMessage                                            
              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.Value                                         
End                                                                             
Return 0                                                                        

Command details 305

Summary of Contents for P9000

Page 1: ...ce guide to the following program products known collectively as Business Continuity Manager HP StorageWorks P9000 for Business Continuity Manager Basic and HP StorageWorks P9000 for Business Continuity Manager Continuous Access Journal 4x4 Extended CTG HP Part Number T5253 96053 Published May 201 1 Edition Tenth ...

Page 2: ...s list is subject to change This document may not be exported re exported transferred or downloaded to persons or entities listed on the U S Department of Commerce Denied Persons List Entity List of proliferation concern or on any U S Treasury Department Designated Nationals exclusion list or to parties directly or indirectly involved in the development or production of nuclear chemical biological...

Page 3: ...ication 23 Security Setting Information Panel 24 User SVC Information Panel 25 Set Defaults Panel Prefix and DAD ID Settings 27 Manage Licenses Panel License Management 29 Message Panel 30 Discover Define Configuration Panel Configuration File Definition 31 Discover HP Storage System Panel 32 Scan Device Address Extent Panel 34 CU Selection List for Remote Storage Array Panel 35 CCA Selection List...

Page 4: ...ir Selection List Secondary Panel 91 Sort Copy Group Container Panel 93 Sort Copy Group Pairs List Panel 94 Scan Copy Pair Inside Storage System Panel 94 Browse Copy Group Detail Definition Panel 97 Browse Copy Group Pair Detail Panel 97 Manage Route Panel Route Management 98 Extra Command Device Direct Operation Panel 99 Executing YKDELCMD 100 Route Status Panel Route Management 101 Executing YKQ...

Page 5: ...of Editing Panel 177 Confirm Command Device Delete Panel 178 Displayed from Route Status Panel 178 Displayed from Extra Command Device Direct Operation Panel 179 Confirm Configuration File Delete Panel 180 Confirm Configuration File Update Panel 180 Confirm Copy Group Load Panel 181 Confirm Overwrite ONLINE Target Volume Panel 182 Confirm Path Delete Panel 182 Confirm Path Set Load Panel 183 Confi...

Page 6: ...299 YKDEMO1 1 300 YKDEMO12 302 3 Data Objects 306 Saving and Converting Objects 306 Dataset Formats and Required Disk Capacity for the Configuration File 307 XML Document Type Definitions 308 Configuration File Examples 321 Example Contents of Copy Group Definition File 321 Example Contents of Disk Configuration Definition File 322 Example Contents of Route List Definition File 322 Example Content...

Page 7: ...verview of BCM Monitor Parameter Files 361 Content of the BCM Monitor Parameter Files 361 Dataset Format 361 Format of Parameter Explanations 361 Specifying parameters 361 Parameter specifications across multiple lines 361 Maximum number of characters per line 362 Specifying comments 362 YKMONOPT File 362 Structure of the YKMONOPT file 362 YKMONCG File 364 Structure of the YKMONCG File 365 Copy Gr...

Page 8: ... Continuity Manager can control the following replication products BC Z Business Copy for Mainframe Hitachi ShadowImage for Mainframe SI Cnt Ac S Z Continuous Access Synchronous for Mainframe Hitachi TrueCopy for Mainframe TC Cnt Ac J Z Continuous Access Journal for Mainframe Hitachi Universal Replicator for Mainframe UR Cnt Ac A Z Continuous Access Asynchronous for Mainframe TrueCopy Asynchronous...

Page 9: ...mbers ISPF Panel System Figure 1 page 9 and Figure 2 page 10 show the panel structure beginning with the main menu As the panel system illustration suggests there are multiple levels of panels Tertiary panels are accessed through secondary panels Figure 1 ISPF Panel System 1 of 2 Overview of ISPF Panels 9 ...

Page 10: ...mmand Scripts that execute Business Continuity Manager Function Keys Function keys which are common among panels are described in the following list Available function keys are displayed at the bottom of each panel See each panel description for available function keys These keys are also referred to as PF program function keys In this document PF keys and function keys are the same key for exampl...

Page 11: ...tches the specified string is found that value is scrolled to the top of the list below the header line If the value is not found the value immediately before the specified string is scrolled to the top of the list below the header line Format LOCATE LOC L Δ1search character string NOTE If the list is sorted by an item other than the one you want to search for sort the list by the item you want to...

Page 12: ...ch that value 1 value 2 and enclose the values in single quotation marks value 1 value 2 Specifies one of the available actions A space can be specified for action name If a space is specified the previously specified action is cancelled action name Examples To display the status of copy groups that begin with TCGRP the default field name CGID can be omitted in the Manage Copy Groups panel enter t...

Page 13: ...pecifying the sort key is displayed SCANPAIR Command Function The SCANPAIR command displays the Scan Copy Pair Inside Storage System panel that scans volumes of PPRC copy pairs Format SCANPAIR ERRCODE Command Function The ERRCODE command displays the Error Code Help panel If you enter an error code on this panel you can view the details for that error code For details about the Error Code Help pan...

Page 14: ...Group Performance Statistics Y Y Y Continuous Access Journal for Mainframe Copy Group Performance Statistics Y Others 1 This command can be used but you cannot specify field names 2 Pressing the F5 ErrCode key will also execute the command Legend Y Can be used Cannot be used ISPF Settings Setting the Position of the Command Line You can specify whether to position the command line at the top or at...

Page 15: ...the value set is reached with the keys between F1 and F12 the F17 DispConf key is not displayed Common Displays Among Panels This section describes the common displays among panels Panel Help Information Help information for each panel is displayed when the cursor is positioned on each panel field and F1 Help is pressed Figure 3 page 15 shows an example of the Help panel Figure 3 Help Panel Settin...

Page 16: ...structures that are output to the ISPF log when a command is executed ISPF Log Max Displays whether the remote DKC control function is applied Y The Remote DKC Control Function is being used N The Remote DKC Control Function is not being used Remote DKC Function Current route list ID Preset RouteListID Pressing the F17 DispConf key displays the Setting Information panel Working Setting Information...

Page 17: ...within the displayed message and then press the F5 ErrCode key or execute the ERRCODE command details for that error code will be displayed in the Error Code Help panel For details on the Error Code Help panel see Error Code Help Panel page 18 Note that when an error code is split it and spans two rows details for the error code cannot be displayed even if you place the cursor on the error code In...

Page 18: ...orageWorks P9000 for Business Continuity Manager Software User Guide Figure 6 page 18 shows the Cancellation Warning panel Figure 6 Cancellation Warning Panel When you press the Enter key the configuration file is not created or updated If F12 Cancel is pressed the panel is displayed in which you can create or update the configuration file Error Code Help Panel Executing the ERRCODE command displa...

Page 19: ...ys the error code that is immediately before the current error code according to the list of error codes in the HP StorageWorks P9000 for Business Continuity Manager Software Messages If the first error code in the list of error codes is currently displayed the last error code in the list will be displayed Pressing the F1 1 NextErr key displays the error code that is immediately after the current ...

Page 20: ...Enter key will overwrite the configuration file Pressing the F12 Cancel key will stop the configuration file from being updated Notes Common to All Panels The following notes are common to all panels XP24000 disk array is displayed as USPV Lowercase letters might not be displayed correctly depending on the local environment Main Menu Panel Transitions between operating panels starting from the Mai...

Page 21: ...Menu Pressing the F6 Sort key sorts items on the panel To display the Main Menu panel 1 Select 6 Command from the ISPF menu 2 Enter YKSTART In some cases the following panels might be displayed instead of the Main Menu panel Main Menu Panel 21 ...

Page 22: ... 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 After that an attempt is made to start the same instance of Business Continuity Manager as before while the instance of Business Continuity Manager agent is still running If the configuration file is l...

Page 23: ...nt Settings Verification The Installation Verification Summary panel is displayed when the final installation check determines that the installation of Business Continuity Manager has not completed or when 0 Installation Verification is selected from the Main Menu panel the installation check is performed before the Main Menu panel is displayed In the Installation Verification Summary panel either...

Page 24: ...ou 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 Figure 12 page 24 shows the Security Setting Information panel Figure 12 Security Setting Information Panel Table 8 page 24 lists and describes the items in the Security Setting...

Page 25: ...splayed The User SVC Information panel displays the user SVC setting information Figure 13 page 25 shows the User SVC Information panel Figure 13 User SVC Information Panel If you press the F8 Forward key the rest of the User SVC Information panel is displayed as follows Installation Verification Summary Panel Environment Settings Verification 25 ...

Page 26: ...is currently enabled in the system If the user SVC that was registered either dynamically or statically is not found N A is displayed Version 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 SVC Number Dynamic registered User SVC Version of the user SVC that was registered dynamically by the ...

Page 27: ... in Figure 14 page 27 values in the figure are samples only Figure 14 Set Defaults Panel Table 10 page 27 describes the items in the Set Defaults panel Table 10 Contents of the Set Defaults Panel Description Item Specify the prefix of the configuration file name in alphanumeric characters required Do not use hyphens Configuration File Prefix1 2 Specify the DAD ID of the local site in alphanumeric ...

Page 28: ...e Copy Groups panel and the YKWATCH command is executing in the background When using the Scan Copy Pair Inside Storage System panel to execute in the background the copy group definition generation function for a PPRC copy pair JCL JOB Statement 1 If one or more configuration files have already been created by using the Mainframe Agent YKP2A command specify a different prefix from that of any con...

Page 29: ... S VOL However when defining a Non Gen ed volume and a Gen ed volume inside the same storage system as a BC copy pair specify the respective values the DAD ID used during an NG scan and the DAD ID used during a local scan Manage Licenses Panel License Management The Manage Licenses panel is displayed when 2 Manage Licenses is selected in the Main Menu panel In the Manage Licenses panel you can reg...

Page 30: ...e 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 If you entered the value in the License Key Dataset Name field the license key is then installed from the dataset of the license key file into the license information dataset If you entered the value in Key Code the ent...

Page 31: ...bes the items in the Discover Define Configuration panel Specify the number corresponding to the operation to be performed Table 12 Contents of the Discover Define Configuration Panel Description Item Scans the volumes 1 Discover HP Storage Defines the route list 2 Route Config Defines the path set 3 Path Set Definitions Defines the copy group copy pair 4 Copy Group Definitions For instructions on...

Page 32: ...isplayed when 1 Discover HP Storage System is selected in the Discover Define Configuration panel The Discover HP Storage System panel displays a list of storage systems detected by performing a scan Figure 19 page 32 shows the transitions of the operation panel starting from the Discover HP Disk Storage System panel Figure 19 Panel Transition from the Discover HP Disk Storage System Panel The Dis...

Page 33: ...s been executed UNDISCOVERED REMOTE STORAGE A remote scan has not yet been executed DISCOVERED NONGEN STORAGE An NG scan has been executed Description Related operations on copy groups become unavailable if the volume scan result is deleted If d is specified in the AC column in the Discover HP Storage System panel the Confirm Configuration File Delete panel see Confirm Configuration File Delete Pa...

Page 34: ... End Enter device numbers in ascending order by hexadecimal number NOTE The device number range cannot be omitted To scan only one volume specify the same value for both Start and End Device Num To scan volume serial numbers add a check and then specify the range of the volume serial numbers to be scanned in Start and End Order by EBCDIC code Volser Displays the number of volumes detected by a loc...

Page 35: ...rmation the names must be specified using no more than 44 characters NOTE describes the command devices used when an NG scan is performed If you want to change the command device to be used modify the environment according to information in Table 15 page 35 Table 15 Command Devices Used when NG Scan is Performed Command device used when an NG scan is performed First entry of the route list specifi...

Page 36: ...ays the CCA Selection List for Remote Storage Array panel which identifies detailed information about the CU e Displays the Edit Device Number for CU panel used to assign a dummy device number to the CU AC Control unit number CU SSID of the CU SSID Dummy device number assigned to the start device the device with the lowest CCA in the CU Dummy Devn Display when dummy device number not assigned to C...

Page 37: ... panel by pressing the F3 Exit key in the Selection List for Remote Storage Array panel CCA Selection List for Edit devn Panel If s is specified in AC in the CU Selection List for Remote Storage System 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 will be displayed CCA Selection List for Edit...

Page 38: ...aracter indicates whether the CCA is an external volume The values are An external volume Not an external volume blank The volume attribute is unknown because it was not requested CCA When F3 Exit is pressed to exit this panel the system checks for any device number conflicts If a device number conflict is detected information about the conflicting volumes is displayed in the Conflict Devices colu...

Page 39: ... this panel Figure 25 page 39 shows the Storage System DADID Selection List panel Figure 25 Storage System DADID Selection List Panel Table 19 page 39 describes the items in the Storage System DADID Selection List panel Table 19 Description of Storage System DADID Selection List Panel Description Item Specify an action s Specify this option to select the DAD IDs and storage system serial numbers t...

Page 40: ...ion Item DAD ID to which the CU belongs Device Address Domain Description of the storage system to which the CU belongs Description Serial number of the storage system to which the CU belongs Storage System S N Model of the storage system to which the CU belongs Model Microcode information for the storage system to which the CU belongs uCode Interface version of the storage system to which the CU ...

Page 41: ...ion of the storage system to which a device belongs Description Serial number of the storage system to which a device belongs Storage System S N Model of the storage system to which a device belongs Model Microcode information for the storage system to which a device belongs uCode Interface version of the storage system to which a device belongs IFType Number of the CU to which a device belongs Co...

Page 42: ... S N 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 If the CCA is omitted Start and End will be set to 00 and FF respectively Device Address 1 Do not include any volumes that belong to a copy pair that was created by Remote Web Console If such a volume is included the copy pair o...

Page 43: ...f the specified entry was created by the remote scan and no dummy device number has been assigned 3 Returns to the initial panel that called this panel 4 If Device Address Domain or Storage System S N is blank the Storage System Device Address Domain Selection List panel is displayed first 5 Pressing the F6 Sort key sorts items on the panel Discover Define Configuration Panel Configuration File De...

Page 44: ...o APID is set for the DAD ID that was selected on the Add Route panel 2 Pressing the F6 Sort key sorts items on the panel The Route Config panel is shown in Figure 31 page 44 Figure 31 Route Config Panel Table 23 page 45 describes the items in the Route Config panel 44 ISPF Panels ...

Page 45: ... route list is shown in Figure 32 page 45 Figure 32 Add Route List ID Panel In the Add Route List ID panel specify a route list ID using no more than 8 alphanumeric characters or less Do not use hyphens 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 Confir...

Page 46: ...te d Deletes the route AC The first DAD ID of the route Device Address Domain Route number Route Num Priority Priority APID APID If you attempt to delete the routes by entering d in AC for all the routes displayed in the Route Information panel the Confirm Configuration File Delete panel see Confirm Configuration File Delete Panel page 180 is displayed for the confirmation of deletion Add Route Pa...

Page 47: ...y is 1 only From the DAD ID list select the first DAD ID of the route Specify the DAD ID that is connecting to the host where Business Continuity Manager will execute since I Os are issued to this first DAD ID of the route Add APID Panel If no APID is set for the DAD ID selected in the Add Route panel the Add APID panel is displayed to set the APID Figure 35 page 47 shows the Add APID panel Figure...

Page 48: ...n List number List Serial number of the storage system to which the command device belongs S N Cmd Device Device number of the command device Devn A route is a connection between DADs The route direction is from the smaller list number to the larger list number as displayed in List In the example shown on the Inner Route Information panel the route is from List numbers 1 to 2 from DADP to DADR Fig...

Page 49: ...d Route Entry Panel Description Item Specify an action s Selects a DAD ID to be connected to the route AC Selectable DAD ID Device Address Domain Add Remote Route Entry Panel In the Inner Route Information panel press F6 Remote The Add Remote Route Entry panel for specifying information about a storage system to be remotely scanned is displayed Figure 38 page 49 shows the Add Remote Route Entry pa...

Page 50: ...n this panel A name that conforms to Configuration File Prefix in the Set Defaults panel and Remote Device Address Domain in the Add Remote Route Entry panel is applied to the file in the following format prefix DSK SNnnnnn dad id When entering information for prefix and dad id names must be 44 characters or less Storage System Selection List Panel If s is specified in AC in the Inner Route Inform...

Page 51: ... device Define Command Device Panel If s is specified in the AC for Device Number in the Add Route Entry panel or in AC in the Storage System Selection List panel the Define Command Device panel is displayed The CCA information is displayed in the Define Command Device panel Figure 40 page 51 shows the Define Command Device panel Figure 40 Define Command Device Panel Table 30 page 51 describes the...

Page 52: ...r a Sort Key of the SORT Command Direction Sorted by Name of field Ascending Number of the CU to which the command device belongs CU Ascending CCA of the command device CCA Ascending Device number of the command device DEVN Ascending Volume serial number of the command device Volser Table 32 Use These Fields for a Condition of the SELECT Command Type Value in field Name of field Hexadecimal Number...

Page 53: ...it APID Panel Table 34 page 53 describes the items in the Edit APID panel Table 34 Contents of the Edit APID Panel Description Item DAD ID to change the APID Supply new APID for DADID Specify a new APID 0000 FFFF Do not press Enter when specifying a nonhexadecimal value In the initial status APIDs already assigned are displayed APID Entire Route Information Panel When e is specified in AC in the R...

Page 54: ...xt row Displays the Insert Remote Route Entry panel used to add an entry for remote scanning to the next row When actions are input to multiple ACs they are processed in the following order 1 Entries at the beginning of the route the value of List is 1 for which d has been specified 2 i e or r or an entry that is not at the beginning of the route and for which d has been specified processed in ord...

Page 55: ... Entry panel Table 36 Contents of the Add Route Entry Panel Description Item Specify an action s Specify this when you do not manually type in a DAD ID and storage system serial number or a command device but select them from the list When you specify this in either Device Address Domain or Storage System S N the Storage System Device Address Domain Selection List panel is displayed When you speci...

Page 56: ...y panel Insert Route Entry panel or Edit Route Entry panel AC Specifiable storage system DKC serial numbers S N Specifiable DAD IDs Device Address Domain The following list describes the relationship between the contents of the DKC DAD Selection List panel and the input status of the input fields for the Add Route Entry Insert Route Entry and Edit Route Entry panels If s is specified for the AC of...

Page 57: ... When you specify this in either Device Address Domain or Storage System S N the Storage System DAD Selection List panel is displayed When you specify this in Device Number the Define Command Device panel is displayed AC Specify the DAD ID to be added to the route Device Address Domain Specify the DKC storage system serial number to which the device to be registered as a command device belongs DKC...

Page 58: ...modifiable The first DAD ID of the route cannot be changed Device Address Domain Serial number of the storage system to which the command device belongs modifiable Storage System S N Device number of the command device modifiable Device Number If Enter is pressed while the Edit Route Entry panel is displayed the information for the entry is changed as specified and the display returns to the Entir...

Page 59: ... panel Table 41 Contents of the Insert Remote Route Entry Panel Description Item Specify the DAD ID assigned to the storage system to be remotely scanned Remote Device Address Domain Specify the serial number alphanumeric characters of the storage system to be remotely scanned Remote Storage System S N Specify the SSID of the command device assigned to the storage system to be remotely scanned in ...

Page 60: ...ected in the Discover Define Configuration panel Figure 50 page 60 shows the transition of the operation panel starting from the Path Set Selection List panel Figure 50 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 51 page 61 shows the...

Page 61: ...layed AC Path set ID Path Set ID Add Path Set Panel When you press F5 Add in the Path Set Selection List panel the Add Path Set panel is displayed In Path Set ID specify a path set ID to identify the path set definition file Figure 52 page 61 shows the Add Path Set panel Figure 52 Add Path Set Panel Path Set Detail Panel If e is specified in AC in the Path Set Selection List panel the Path Set Det...

Page 62: ... has no shared attributes SHR Primary storage system serial number S N Primary Primary path ID1 PathID Primary CU number CU Primary SSID2 SSID Direction of the path Dir Secondary storage system serial number S N Secondary Secondary path ID1 PathID Secondary CU number CU Secondary SSID2 SSID 1 Valid only when the Type is DKC 2 Valid only when the Type is CU In the initial state the information is d...

Page 63: ...cal Path Definition Panel Table 44 page 63 describes the items in the Edit Logical Path Definition panel Table 44 Contents of the Edit Logical Path Definition Panel Description Item Path set ID Path Set ID Type of path CU Inter CU logical path DKC inter DKC logical path Type Shared attributes for path modifiable Y This path has shared attributes The path is deleted only if the FORCE parameter is s...

Page 64: ...econdary storage system serial number modifiable S N Secondary Secondary storage system model modifiable Model Secondary interface version modifiable IFType Specify the secondary path ID Specify this item only for the inter DKC logical path If this item is omitted for the inter DKC logical path 00 is assumed PathID Secondary CU number modifiable CU Secondary SSID modifiable SSID Secondary CCA CCA ...

Page 65: ...ied for CU and CCA page 65 describes a relationship between a S N value and values specified for CU and CCA and the device to which I O will be issued Table 45 Relationship between a S N value and values specified for CU and CCA Device to which I O will be issued Values specified for CU and CCA S N value A command device A CU number and CCA for Non Gen ed volumes A serial number of storage system ...

Page 66: ... as follows S N and then Device Address Domain ID If s is specified in AC and Enter is pressed the disk configuration definition file is loaded and the Model and IFType values are fetched At this point if DKC is not specified in Type in the Edit Logical Path Definition panel the Select SSID panel is displayed for displaying a list of CUs in the storage system on the selected line Select SSID Panel...

Page 67: ...anel the Edit Port Definition panel is displayed to edit physical paths Figure 57 page 67 shows the Edit Port Definition panel Figure 57 Edit Port Definition Panel Table 49 page 67 describes the items in the Edit Port Definition panel Table 49 Contents of the Edit Port Definition Panel Description Item Path set ID Path Set ID Primary storage system serial number S N Primary Model of the primary st...

Page 68: ...nformation is displayed in ascending order by hexadecimal code in the following order Primary and then Secondary for Port Assign Port Panel When you press F5 Add in the Edit Port Definition panel the Assign Port panel is displayed for assigning new physical paths Figure 58 page 68 shows the Assign Port panel Figure 58 Assign Port Panel Table 50 page 68 describes the items in the Assign Port panel ...

Page 69: ...econdary CU Secondary CU number Secondary PathID Secondary path ID number Path Type Path type EBCDIC code order sort key When an ordering priority is specified in the Priority column and Enter is pressed the logical paths in the path set are sorted the Path Set Detail panel is re displayed and the system returns to the Path Set Detail or Path Set Status panels Copy Group Selection List Panel The C...

Page 70: ...tems on the panel 4 If you press F5 Add the Copy Group Pair Detail panel is displayed and the Setting C T ID Attributes panel is displayed on top of that panel 5 If you press Enter the Copy Group Pair Detail panel is displayed and the Setting C T ID Attributes panel is displayed on top of that panel 6 If the number of P VOLs and S VOLs does not match pressing Enter does not change the panel that i...

Page 71: ...ke the copy group a CG container Use Container check box is changed 2 After the Copy Group Pair Detail panel is displayed the Setting C T ID Attributes panel is displayed on that panel 3 Pressing the F6 Sort key sorts items on the panel 4 If the numbers of P VOLs and S VOLs that are specified are not the same pressing Enter does not change the panel that is currently displayed Figure 63 page 72 sh...

Page 72: ...rm the next operation When the target copy group is being copied with a copy pair other than SIMPLEX the copy pair is not dissolved even if d is specified in AC in order to delete the copy group definition file When the target copy group definition file is deleted without releasing the copy pair subsequent operations for the copy pair can no longer be performed Before specifying d in AC HP recomme...

Page 73: ... Address Domain Primary When defining a Non Gen ed volume and a Gen ed volume inside the same storage system as a BC copy pair specify respective values the DAD ID specified for an NG scan and the DAD ID specified for a local scan Device Address Domain Secondary Specify the copy type of the copy group either BC CA CAA or CAJ Copy Group Type Select Use Container to define a copy group as a CG conta...

Page 74: ...ription Item When the YKMAKE command is executed1 Copy type of the copy group Copy Group Type N A Copy group ID Copy Group ID N A Primary DAD ID Primary Device Address Domain N A Secondary DAD ID Secondary Device Address Domain When the YKMAKE command is executed1 Specify to define an EXCTG attribute 2 This is only effective when the copy type is CAJ if the copy type is other than CAJ an error mes...

Page 75: ...orage system in a primary site S Primary N A Primary storage system serial number If multiple storage systems exist for one C T ID and sub C T ID combination is displayed to the right of the serial number S N When the YKMAKE command is executed 1 Specify the arbitration command device of the primary site You do not have to specify this item for the supervisor DKC or a subordinate DKC that exists o...

Page 76: ... page 19 If you create a copy group or change the definition by pressing the F3 Exit key in the Copy Group Detail Definition panel a copy group that is not a CG container will be created when both of the following conditions are satisfied When only one C T group exists in a copy group When Enable EXCTG Attributes is not selected You can use the SORT command in the Copy Group Detail Definition pane...

Page 77: ...Containers page 77 to Copy Group Attributes CAJ Panel for CAJ Copy Groups that are not CG Containers page 79 show the Copy Group Attributes panels Figure 66 Copy Group Attributes For Container BC Panel for BC Copy Groups that are CG Containers Figure 67 Copy Group Attributes BC Panel for BC Copy Groups that are not CG Containers Figure 68 Copy Group Attributes For Container CA Panel for CA Copy Gr...

Page 78: ... 70 Copy Group Attributes For Container CAA Panel for CAA Copy Groups that are CG Containers Figure 71 Copy Group Attributes CAA Panel for CAA Copy Groups that are not CG Containers Figure 72 Copy Group Attributes For Container CAJ Panel for CAJ Copy Groups that are CG Containers 78 ISPF Panels ...

Page 79: ...effective Copy type Description Item 2 CA Displays the linkage option HS This is a CA copy group with the HyperSwap attribute NNE This is something other than the above For PPRC copy pairs in a 2DC configuration with HyperSwap and CAJ specify HS If this is a CA copy group created by executing the YKH2B command HS is displayed If HS is displayed Business Continuity Manager can only be used for moni...

Page 80: ...ppressed when updates in P VOL cannot be copied to S VOL due to a problem such as a failure If the operation from the primary site attains the suspend status updates to P VOL are accepted NEVER P VOL is never in fence status updates suppressed When a copy pair is suspended updates to P VOL are accepted NOTE FENCE LVL cannot be altered when a C T group ID is specified For the system volume that is ...

Page 81: ...command is executed CAA Specify the C T group timer type6 when performing copy operations from the primary site to the secondary site again after performing copying from the secondary site to the primary site required for TCA SYSTEM Uses a timestamp to maintain consistency LOCAL Uses the storage system s internal clock to maintain consistency NONE Does not maintain consistency FORWARD TIMER TYPE S...

Page 82: ...f host update I O on the S VOL This prevents host I O performance deterioration on crucial volumes If the usage amount exceeds the criteria the copy pair status becomes SUSPCU NOTE If the C T Group option Inflow Control is not enabled in the following models FLOW CTL will be disregarded even if set to Y XP12000 XP10000 Disk Array XP24000 XP20000 Disk Array For details see the one of the following ...

Page 83: ... the number corresponding to the ATTIME suspend function and suspend mode you want to use when setting an ATTIME suspend time NORMAL Uses the NORMAL ATTIME suspend function CAJ STEADY Uses the CAJ ATTIME suspend function The suspension is activated in STEADY mode CAJ QUICK Uses the CAJ ATTIME suspend function The suspension is activated in QUICK mode Preset Mode When the YKMAKE command is executed...

Page 84: ...ed to the S VOL ASIS Uses the consistency time set according to the storage system setting C T TIME MODE When the YKMAKE command is executed When the YKRESYNC command is executed CA Specify whether to transfer the writing timestamp to the S VOL when the copy type is CA timestamp transfer mode Y Transfers the timestamp to the S VOL Specify this item only when you are using the CAJ ATTIME suspend fu...

Page 85: ...t was set using the Remote Web Console to change the hold period for update I O Specification of Y is valid only for a CA copy group for which a consistency group ID is specified 6 For details on the consistency group timer type see one of the following HP StorageWorks P9000 Continuous Access Synchronous for Mainframe Systems User Guide HP StorageWorks P9000 Continuous Access Synchronous User Guid...

Page 86: ...sistency group ID of the copy group Figure 74 page 86 shows the Setting C T ID Attributes Panel Figure 74 Setting C T ID Attributes Panel Contents of the Setting C T ID Attributes Panel page 86 describes the items in the Setting C T ID Attributes panel Table 58 Contents of the Setting C T ID Attributes Panel Specifiable copy types Description Item BC CA CAA CAJ If the copy type is BC CA or CAA spe...

Page 87: ...u 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 For details about the Confirm Cancellation of Editing panel see Confirm Command Device Delete Panel page 178 If you change the definition in the Copy Group Detail Definition panel and press the F3 Exit key the Confirm Con...

Page 88: ...st 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 CCA Secondary DAD ID Sec Device number modifiable Devn Sec Storage system serial number Array Storage subsytem number SSID CU number CU The two leftmost characters indicate the CCA of the device in hexadecimal The right...

Page 89: ... 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 t...

Page 90: ...ot be acquired CCA 1 The procedure to specify the range is the same as for specifying the pattern parameter for the SELECT command For details about how to specify the pattern parameter for the SELECT command see Command Line Commands page 11 If the number of P VOL devices selected does not match the number of S VOL devices this panel remains ready to accept device selections until the number matc...

Page 91: ...mn Import SMS Storage Group Result Panel When you press the Enter key to refresh the SMS storage group panel from the Import SMS Storage Group panel the Import SMS Storage Group Result panel is displayed The Import SMS Storage Group Result panel displays the number of volumes that have been newly added to the SMS storage group Figure 78 page 91 shows the Import SMS Storage Group Result panel If an...

Page 92: ...and then specify the volume serial number range for the copy pairs that you want to select in EBCDIC code order Volser1 Specify s for devices joined in copy pairs Copy pairs are joined in ascending order of device number AC Displays In Config once a copy pair is joined once the paired device has been determined Displays Imported if the device is imported from the SMS storage group Prompts Volume s...

Page 93: ... order for the CG container is displayed Figure 80 page 93 shows the Sort Copy Group Container panel Figure 80 Sort Copy Group Container Panel In the Sort Copy Group Container panel you can select the sorting order from the following items Sort Order Item Consistency group ID order 1 C T Group ID Subconsistency group ID order 2 sub C T Group ID Primary storage system serial number order 3 Primary ...

Page 94: ...ice Number Scan Copy Pair Inside Storage System Panel When SCANPAIR is entered on the command line and the Enter key is pressed on the Copy Group Selection List panel the display switches to the Scan Copy Pair Inside Storage System panel for scanning the P VOL of the PPRC copy pair and generating a copy group definition file Execute the YKH2B command to create a copy group definition file for a CA...

Page 95: ...pecified BC Pair S VOL Non Gen ed Specify a CA copy group name required only when a Device Address Domain ID is specified for Secondary Two digit serial numbers beginning with 00 are assigned in ascending order to the copy group names specified by this parameter for example 00 01 02 You can specify a maximum of six characters for a copy group name Do not use hyphens The initial display is MYTCS CA...

Page 96: ...l display is NOCHECK HS Pressing the Enter key starts the background job for scanning the P VOL The volumes within the range specified in Device Num are scanned 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 The values specified here are used during the execution of the backgro...

Page 97: ...C T group the copy groups included in the CG container Figure 83 page 97 shows the Browse Copy Group Detail Definition Panel Figure 83 Browse Copy Group Detail Definition Panel For an explanation of the items displayed in the Browse Copy Group Detail Definition Panel see Copy Group Detail Definition Panel page 73 You can view the copy group attributes in the Browse Copy Group Detail Definition pan...

Page 98: ...nel you can use the LOCATE and SORT commands For details about how to use each command see Command Line Commands page 11 Manage Route Panel Route Management The Manage Route panel to operate the routes is displayed when 4 Manage Route is selected in the Main Menu panel Figure 85 page 98 shows the transition of the operation panel starting from the Manage Route panel Figure 85 Panel Transitions fro...

Page 99: ...anel In the Manage Route panel and Route Status panel press the F5 Extra key to display the Extra Command Device Direct Operation panel You can use the Extra Command Device Direct Operation panel to perform operations aside from registration for command devices not defined in the route list Figure 87 page 99 shows the Extra Command Device Direct Operation panel Figure 87 Extra Command Device Direc...

Page 100: ...yed from the Manage Route panel operations can only be performed for local command devices In this case you cannot overwrite DAD IDs that are already displayed Device Address Domain ID Specify the storage system serial number using 5 digits of alphanumeric characters required Serial Number Use a 4 digit hexadecimal to specify the device number of the command device required Devn 1 If the specified...

Page 101: ...e host You cannot delete remote storage system command devices Take care not to delete command devices defined in the route list Route Status Panel Route Management The Route Status panel is displayed when s is specified for the AC column in the Manage Route panel The following table shows the Route Status panel when the F1 1 CCAInfo key is pressed on the Route Status panel F1 1 CCAInfo key F10 DA...

Page 102: ...n the Route Status panel Table 67 Contents of the Route Status Panel Description Item Route list ID selected in the Manage Route panel Route List ID APID1 APID Host ID assigned to the local host 1 HOST ID The top cylinder number of the command device protection dataset 1 CYL The top header number of the command device protection dataset 1 HD The number of tracks in the command device protection da...

Page 103: ...isplay processing for the command device in nn format Bld nn Displays the result RC of creation processing for the command device in nn format Del nn Displays the result RC of deletion processing for the command device in nn format Fnd nn Displays the result RC of a command device information query in nn format Status Route number Route Num Placement list number of the entry within the same route ...

Page 104: ... When q is specified in the AC column in the Route Status panel the YKQRYDEV command is executed to display command device information The Command Device Status panel will be displayed This panel will be also displayed when q is specified in the AC column in the Command Device Selection List panel The Command Device Status panel is shown in Figure 90 page 104 to Figure 92 page 105 When registered ...

Page 105: ...d Device Status panel Table 68 Contents of the Command Device Status Panel Description Item Model of the storage system to which the specified volume belongs1 Model Microcode information for the storage system to which the specified volume belongs 1 uCODE Interface version of the storage system to which the specified volume belongs 1 IFType Serial number of the storage system to which the specifie...

Page 106: ...rmation cannot be obtained N A is displayed 1 2 If the target volume is related to another volume as a copy pair and not as a command device the pair relationship is displayed NOTE If the YKQRYDEV command is executed on the HP StorageWorks XP1024 XP128 Disk Array N A will be displayed as the command device information APID Volume information cannot be obtained when the command device on the remote...

Page 107: ...s P9000 for Business Continuity Manager Software Users Guide If you specify d for multiple fields in AC in the Route Status panel processing will be performed from bottom to top Even when d is specified in multiple ACs in the Route Status panel and is specified not to display the Confirm Command Device Delete panel the Confirm Command Device Delete panel will be displayed after an error and before...

Page 108: ...Displays the Command Device Status panel used to display the command device information which is registered in the storage system d Deletes the command device information which is registered in the storage system The Confirm Command Device Delete panel will be displayed even if Confirm is set to off When multiple actions are specified in multiple AC columns the actions are executed in order from t...

Page 109: ... in the storage system Such command devices can be accessed directly through this panel NOTE Only devices registered in the disk configuration definition file are displayed Scan the target storage system to detect command devices and register them in the disk configuration definition file in advance Manage Path Set Panel Logical Path Management When 5 Manage Path Set is selected in the Main Menu p...

Page 110: ...tion name WARNINGS command name RC xx A warning occurred with the command indicated by command name in the action indicated by action name Action name WITH WARNINGS command name RC xx The command indicated by command name within the action indicated by action name generated an error message Action name ERRORS command name RC xx The command indicated by command name terminated with an error 1 xx is...

Page 111: ...ed in the LOAD Option panel Note that once you return to the Main Menu panel information for the specified route list can be cleared Note that when you specify b or q in the AC column of the Manage Path Set panel without executing the YKLOAD command the Confirm Path Set Load panel see Confirm Path Set Load Panel page 183 is displayed requesting the loading of the path set If a device to which I Os...

Page 112: ...e selected logical path The Confirm Path Delete panel is displayed q Executes the YKQRYPTH command and updates the status of the selected logical path The execution result is displayed on the same panel When actions are entered in multiple AC columns each is processed in the order displayed AC Type of path CU Inter CU logical path DKC Inter DKC logical path Type Primary storage system serial numbe...

Page 113: ...the number of physical paths in the ESTABLISHED status and n indicates the number of defined physical paths MISMATCH The physical paths in the path set definition file do not match the storage system settings INVALID The status of the physical path is something other than NO PATH ESTABLISHED or MISMATCH and an error has occurred on a physical path Status 1 xx is a return code from each command In ...

Page 114: ...h a device exists to which the path operation command is issued CU Primary SSID SSID Secondary storage system serial number S N Secondary Secondary path ID When the path type is CU nothing is displayed PathID Secondary CU number Displays the number of the CU in which a device exists to which the path operation command is issued CU Secondary SSID SSID Displays the number of physical paths defined f...

Page 115: ...el is set to c the YKQRYPTH command is executed with the RESTRUCT parameter specified To use this functionality see the description in the HP StorageWorks P9000 for Business Continuity Manager Software Users Guide that explains how to acquire path information from storage system If the return code is within the range from 8 to 32 the Confirm Configuration File Update panel see Confirm Configuratio...

Page 116: ...Figure 98 Manage Copy Groups Panel Table 73 page 117 describes the items in the Manage Copy Groups panel 1 16 ISPF Panels ...

Page 117: ...th 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 ESTABLISHED HOLD making of a copy pair with HOLD specified was requested SUSPEND ERRORS YKSUSPND RC xx suspending of a copy pair failed SUSPENDING suspending of a copy pair requested RESYNC ERRORS YKRESYNC RC xx synchronizing of a copy pai...

Page 118: ...SPEND SIMPLEX SUSPVS or HOLD of the monitored copy group 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 Co...

Page 119: ...displayed depending on the settings of the Remote DKC Function column and Preset RouteListID column in the Set Defaults panel Display of the LOAD Option Panel Settings of the Preset RouteListID Settings of the Remote DKC Function Not displayed The ROUTE parameter of the YKLOAD command becomes the value specified for the Preset RouteListID Specified Y Only displayed the first time a copy group is l...

Page 120: ...tatuses within a copy group is displayed When v is specified in AC the YKQUERY command that includes the specified VERIFY parameter is executed and the copy group configuration is checked When q is specified the execution results of the YKQUERY command are displayed When f is specified the execution results of the YKEWAIT command with the TIMEOUT 0 parameter specified are displayed When v is speci...

Page 121: ...Figure 101 Panel Transitions from the Copy Group Status Summary Panel The Copy Group Status Summary panel is shown in Figure 102 page 122 Manage Copy Groups Panel Copy Group Operation 121 ...

Page 122: ...anel N A is displayed Approx Matching The ratio of copy pairs that the copy direction in DUPLEX status is in reversed direction in the corresponding copy group Reversed Pairs Number of copy pairs in the DUPLEX status Duplex Pair Status Counts Number of copy pairs in the PENDING status Pending Number of copy pairs in the SUSPOP status includes the HOLD status Suspend Number of copy pairs in the SUS...

Page 123: ...nage Copy Groups panel N A is displayed 2 Average of copy pair matching rates of all copy pairs in the corresponding copy group Even if the copy pair matching rate is displayed as 100 confirm the status in Pair Status Counts because a copy pair in the suspend status might be included Copy Group Storage System Summary Panel When the F5 Storage key is pressed in the Copy Group Storage System Summary...

Page 124: ...airs in the SIMPLEX status Simplx Number of copy pairs in the SUSPCU status SusCU Number of copy pairs in the TRANS status includes the HOLDTRNS status Trans Number of copy pairs in the INVALID status includes the SUSPER status HOLDER status and CONSLOST status Error Number of copy pairs in the NODELTA status NoDlt CAA Copy Group Performance Statistics Panel For the CAA copy type when the F5 Stats...

Page 125: ...SN Storage system serial number of the copy target Sec SN Sidefile threshold of Pri SN SFT Pri s Reserved sidefile cache usage rate for Pri SN RSF Tot Reserved sidefile cache usage rate for C T for Pri SN RSF C T Write pending rate of Pri SN WPR Tot Reserved sidefile cache usage rate for Sec SN RSF Tot Sec s Reserved sidefile cache usage rate for C T for Sec SN RSF C T Write pending rate for Sec S...

Page 126: ...es s columns in Pri s and OFLD min and RCUR min columns in TIMERS display N A If an operation is performed on each copy pair or the copy pair directions in the copy group are mixed the value for the copy group cannot be guaranteed because the copy pair direction statuses in the copy group do not match Match the copy pair statuses and copy pair directions in the copy group and then re execute You c...

Page 127: ...ed sidefile cache usage rate for C T 5 RCU Reserved Sidefile Rate for C T Group Descending order of the Sec SN write pending rate 6 RCU Total Write Pending Rate Descending order of the data transfer rate between the Pri SN and the Sec SN KB s 7 MCU to RCU Kbytes s MCU RCU Kbytes s Ascending order of the serial number of the Pri SN 8 Primary storage system S N Ascending order of the serial number o...

Page 128: ... SN Data transfer rate KB s between a Pri Array and a Sec Array KB s Kbytes s Data Trans Operating information between journal groups on Pri 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 STOP Data transfer has stopped as for example if all volumes in a journ...

Page 129: ...e are shown in order for Pri SN and Sec SN The columns where information is not acquired by storage system and the columns for copy groups that contain a copy pair whose copy type is not CAJ might display N A because the values for those columns are not guaranteed When you display the data transfer rate of CAJ containing an XP24000 disk array or P9500 disk array in this panel it is necessary that ...

Page 130: ... Sec SN SJNLDATR Ascending Capacity that can be used as journal data for Pri SN in GB PJNLDATC Ascending Capacity that can be used as journal data for Sec SN in GB SJNLDATC Sort CAJ Copy Group Statistics Panel Pressing F6 Sort in the CAJ Copy Group Performance Statistics panel displays the Sort CAJ Copy Group Statistics panel allowing you to specify the sort order Figure 107 page 130 shows the Sor...

Page 131: ... for Pri SN in GB 10 Data capacity in the M JNL volume GB In order of the available capacity of journal data for Sec SN in GB 1 1 Data capacity in the R JNL volume GB Copy Group Pair Status Panel The status of each copy pair is displayed when the F6 Pairs key is pressed in the Copy Group Status Summary panel Figure 108 page 131 shows the Copy Group Pair Status panel Figure 108 Copy Group Pair Stat...

Page 132: ...te2 3 Match Rate Displays the difference between the consistency time of the suspended S VOLs and the current time when a copy pair is suspended in CAA or CAJ 3 When BC or CA or information cannot be acquired from the secondary site for example the command device is not defined it is not displayed Only if the C T group timer type is SYSTEM it is displayed For CAJ the type of consistency time to be...

Page 133: ...can use the LOCATE SELECT and SORT commands in the Copy Group Pair Status panel For details about how to use each command see Command Line Commands page 11 You can specify the following fields for the sort key of the SORT command Direction Sorted by Name of field Ascending Copy pair status STATE Ascending Device number of the P VOL PDEVN Ascending Volume serial number of the P VOL VOLSER Ascending...

Page 134: ...irs Status panel Figure 109 Sort the Copy Group Pairs Status Panel Sort the Copy Group Pairs Status Panel page 134 describes the items in the Sort the Copy Group Pairs Status panel Table 79 Sort the Copy Group Pairs Status Panel Sort Order Item The order of the copy pair status 1 Copy Pair State The order of P VOL device number 2 Primary Device Number The order of P VOL volume serial number 3 Prim...

Page 135: ...el If you specify q in AC on the Copy Group Pair Status panel the YKQRYDEV command is executed on the P VOL and S VOL and the Volume Query Information BC panel is displayed for an BC copy pair Figure 1 10 page 135 and Figure 1 1 1 page 136 show a configuration example and the Volume Query Information BC panel displayed in this configuration Figure 1 10 Volume Query Configuration Example BC Manage ...

Page 136: ...m Storage System Storage system serial number of the P VOL at definition SN Primary Volume SSID of the P VOL at definition SSID CU number of the P VOL at definition CU CCA of the P VOL at definition CCA Device number of the P VOL at definition The following volume online information is displayed to the right of DEVN 1 Online Offline Nothing is displayed when volume online information cannot be obt...

Page 137: ...of the following messages is displayed Notset ATTIME suspend time is not set ATTIME suspend time WAITING ATTIME suspend has not been executed ATTIME suspend time TIMESTAMP TRIGGERED A suspension was performed at ATTIME suspend time ATTIME suspend time TIMEOUT TRIGGERED A suspension was performed due to a timeout or because the CAJ copy pair was in the suspend status at the ATTIME suspend time ATTI...

Page 138: ...istency 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 HH The hour is displayed MM Minutes are displayed SS NNNNNN Seconds are displayed...

Page 139: ... of whether it is information on the P VOL or S VOL Pri or Sec Type Primary Secondary Other CopyPair Information5 Consistency group ID and subconsistency group ID C T ID For Primary storage system serial number for P VOL of the Copy pair specified in the Copy Group Pair Status panel For Secondary storage system serial number for S VOL of the copy pair specified in the Copy Group Pair Status panel ...

Page 140: ...he definition for example in a 1 n BC copy pair configuration or when S VOL for CAA is used as P VOL for BC 6 MISMATCH might be displayed This happens when the device information during definition as indicated by Primary Volume and Secondary Volume differs from the device information reported by the SSID In this case the device information reported by the SSID is displayed in the Pair Volume colum...

Page 141: ...Panel Description Item Copy group ID Copy Group ID Copy group type at definition Copy Group Type in Configuration Copy types held by the storage system Copy Group Type from Storage System Storage system serial number of the P VOL at definition SN Primary Volume SSID of the P VOL at definition SSID CU number of the P VOL at definition CU CCA of the P VOL at definition CCA Device number of the P VOL...

Page 142: ...MODE4 Pace of copying5 1 NORMAL The speed of the copy operation improves However update I O load on P VOL is high and this might affect the I O performance of the host SLOW Slows the speed of the copy operation so that the effect of the copy operation on the I O performance of the host is minimal COPY PACE Fence level5 DATA Places P VOL in fence status updates suppressed when updates in P VOL cann...

Page 143: ... the related Compatible FlashCopy was interrupted N Normal status This item is displayed in the format P VOL status S VOL status In either of the following cases N A is displayed SIMPLEX is displayed for Status under both Primary Volume and Secondary Volume The information cannot be obtained CONSLOST P S The following information is displayed if there are any other copy pairs apart from the one sp...

Page 144: ... the HP StorageWorks P9000 for Business Continuity Manager Software Users Guide Note that when the device is a command device of either of the following models CDEV apid is displayed in the Status column apid APID HP StorageWorks XP12000 XP10000 Disk Array HP StorageWorks XP24000 XP20000 Disk Array HP StorageWorks P9500 Disk Array 3 If the emulation type of the journal volume is OPEN JOURNAL is no...

Page 145: ...t Volume Query Information CAA Panel If you specify q in AC on the Copy Group Pair Status panel the YKQRYDEV command is executed on the P VOL and S VOL and the Volume Query Information CAA panel is displayed for a CAA copy pair Figure 1 13 page 145 and Figure 1 14 page 146 show a configuration example and the Volume Query Information CAA panel displayed in this configuration Figure 1 13 Volume Que...

Page 146: ... Configuration Copy types held by the storage system Copy Group Type from Storage System Storage system serial number of the P VOL at definition SN Primary Volume SSID of the P VOL at definition SSID CU number of the P VOL at definition CU CCA of the P VOL at definition CCA Device number of the P VOL at definition The following volume online information is displayed to the right of DEVN 1 Online O...

Page 147: ...ndary Volume SSID of the S VOL at definition SSID CU number of the S VOL at definition CU CCA of the S VOL at definition CCA Device number of the S VOL at definition The following volume online information is displayed to the right of DEVN 1 Online Offline Nothing is displayed when volume online information cannot be obtained DEVN Copy pair status2 JOURNAL is displayed for the journal volume 3 Sta...

Page 148: ...ATTIME suspend time TIMESTAMP TRIGGERED A suspension was performed at ATTIME suspend time ATTIME suspend time TIMEOUT TRIGGERED A suspension was performed due to a timeout On the second line LOCAL ATTIME suspend time in local time Format of the ATTIME suspend time YYYYMMDD HH MM SS NNNNNN YYYY The year is displayed MM The month is displayed DD The date is displayed HH The hour is displayed MM The ...

Page 149: ...Update of the S VOL is prohibited after the copy pair is suspended YKSUSPND command is executed PERMIT Update of the S VOL is allowed after the copy pair is suspended YKSUSPND command is executed PROT MODE Pace of copying4 1 NORMAL The speed of the copy operation improves However update I O load on P VOL is high and this might affect the I O performance of the host SLOW Slows the speed of the copy...

Page 150: ...ndary storage system serial number for S VOL of the copy pair specified in the Copy Group Pair Status panel SN 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 the Copy Group Pair Status panel The following volume online information is displayed to the right of DEVN 1 Online Offlin...

Page 151: ...y pair configuration or when S VOL for CAA is used as P VOL for BC 6 MISMATCH might be displayed This happens when the device information during definition as indicated by Primary Volume and Secondary Volume differs from the device information reported by the storage system In this case the device information reported by the storage system is displayed in the Pair Volume column If MISMATCH is disp...

Page 152: ...s held by the storage system Copy Group Type from Storage System Storage system serial number of the P VOL at definition SN Primary Volume SSID of the P VOL at definition SSID CU number of the P VOL at definition CU CCA of the P VOL at definition CCA Device number of the P VOL at definition The following volume online information is displayed to the right of DEVN 4 Online Offline Nothing is displa...

Page 153: ... displayed to the right of DEVN 4 Online Offline Nothing is displayed when volume online information cannot be obtained DEVN Copy pair status5 JOURNAL is displayed for the journal volume 6 Status Consistency time The type of consistency time used differs depending on the value specified in C T TIME MODE in the Copy Group Attribute CAJ panel N A is displayed for the delta resync pair or when the co...

Page 154: ...spended ERROR LVL C T group timer type in both the forward F and reverse R directions SYSTEM Uses a timestamp to maintain consistency LOCAL Uses the storage system s internal clock to maintain consistency NONE Does not maintain consistency The timer type obtained from the storage system is displayed N A is displayed when a reverse direction timer type cannot be obtained TIMER TYPE F R Write protec...

Page 155: ...em serial number of the S VOL of the copy pair specified in the Copy Group Pair Status panel SN For Primary Device number of the P VOL of the copy pair specified in the Copy Group Pair Status panel For Secondary Device number of the S VOL of the copy pair specified in the Copy Group Pair Status panel The following volume online information is displayed to the right of DEVN 4 Online Offline Nothing...

Page 156: ...siness Continuity Manager Software Users Guide Note that when the device is a command device of either of the following models CDEV apid is displayed in the Status column apid APID HP StorageWorks XP12000 XP10000 Disk Array HP StorageWorks XP24000 XP20000 Disk Array HP StorageWorks P9500 Disk Array 6 If the emulation type of the journal volume is OPEN JOURNAL is not displayed 7 The following forma...

Page 157: ...tem as EXCTG This copy pair is ready to be used by 4x4 CAJ in the reverse direction inactive The journal group has not been registered a registration error occurred or user added information later This copy pair is not ready to be used by 4x4 CAJ in the reverse direction invalid Invalid status N A Unable to identify the status flag3 Indicates by using a flag whether the journal group of the copy d...

Page 158: ...se situations apply N A is displayed N A is displayed in the Device Information DEVN field in the following cases When the YKQRYDEV command returns an error When displaying information about a device of a remote storage system if the route list has not been loaded or the target storage system is not included in the route list Volume Query Information Panel Executing YKQRYDEV When you specify q for...

Page 159: ...AKE command parameters The Make Options panels are shown in Figure 1 16 page 159 Figure 1 17 page 159 and Figure 1 18 page 159 Figure 1 16 BC Copy Group Make Options Panel Figure 1 17 CA CAA Copy Group Make Options Panel Figure 1 18 CAJ Copy Group Make Options Panel Contents of the Make Options Panel page 160 describes the items in the Make Options panel Manage Copy Groups Panel Copy Group Operati...

Page 160: ...t target copy pairs based on the volume status of the copy pair Pair Selection When the S VOL is online determine 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 Do not make or resynchronize the copy pair if the S VOL is online Overwrite ONLINE target volume The BC Copy Group Make Options panel is displayed for the BC ...

Page 161: ...re 1 19 BC Copy Group Suspension Options Panel Figure 120 BC with C T Copy Group Suspension Options Panel Figure 121 CA Copy Group Suspension Options Panel Manage Copy Groups Panel Copy Group Operation 161 ...

Page 162: ...pension Options Panel Displayed from the Manage Copy Groups Panel Figure 124 CAJ Copy Group Suspension Options Panel Displayed from the Copy Group Pair Status Panel Contents of the Suspension Options Panel page 163 describes the items in the Suspension Options panel 162 ISPF Panels ...

Page 163: ...nreflected data up to the time of the suspend request NOTE The Preset and Cancel Preset parameters are effective for BC and TCA copy groups with a consistency group ID and can be specified for a remote storage system only when the CAJ ATTIME suspend function is used Note that this setting is released by P S ON OFF in the primary storage system Use preset mode to specify whether the status of a BC ...

Page 164: ... SS Specify the TIMEOUT parameter of the YKSUSPND command in minutes from 0 to 9999 The specified value is used as the timeout value when the CAJ ATTIME suspend function is used Timeout Minutes MMMM Specify the ATTIME parameter the time used as the ATTIME suspend time of the YKSUSPND command by using the number LOCAL Uses the local time as the ATTIME suspend time GMT Uses Greenwich Mean Time as th...

Page 165: ...TIME parameter can be added or cancelled for BC and TCA copy groups with a consistency group ID The YKSUSPND command terminates successfully when the instruction to the copy pair succeeded Even if the command has terminated successfully make sure that the transition of the copy pair status was performed using the YKQUERY command or the YKEWAIT command If there is a volume whose status has not been...

Page 166: ...oup Resync Options Panel Figure 127 CAJ Copy Group Resync Options Panel Displayed from the Manage Copy Groups Panel Figure 128 CAJ Copy Group Resync Options Panel Displayed from the Copy Group Pair Status Panel 166 ISPF Panels ...

Page 167: ... Select target copy pairs based on the volume status of the copy pair You can specify this mode for BC Pair Selection Specify the option of the copy mode by using the number QUICK Changes to DUPLEX status quickly NORMAL Changes to DUPLEX status after the copy finishes Copy Mode Specify the DELTAJNL ALLJNL PREPARE or ERRCHK parameter of the YKRESYNC command by using the number Delta Journal Execute...

Page 168: ...s 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 YKRESYNC command with the VOLUNIT parameter specified for all the copy pairs NOTE Remember the following while performing copy operations If the copy direction of copy groups is changed b...

Page 169: ...e items in the Watch Options panel Table 87 Contents of the Watch Options Panel Description Item Copy group ID Copy Group ID Specify the waiting status for the YKWATCH 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 Simplex Waits for the volume to change to the SIMPLEX status Watch transition to Spe...

Page 170: ...column in the Manage Copy Groups panel the YKEWAIT command will be executed and the Wait Options panel for specifying the parameters of the YKEWAIT command is displayed Figure 130 page 170 and Figure 131 page 170 show the Wait Options panel Figure 130 Wait Options Panel for BC CA or CAA Figure 131 CAJ Copy Group Wait Options Panel Contents of the Wait Options Panel page 171 describes the items in ...

Page 171: ...ied The detection of invalid statuses is disabled N The NOINVALIDCHECK parameter is not specified The detection of invalid statuses is enabled NOINVALIDCHECK The Status column displays EWAIT GOTO status SUCCESSFULLY when the YKEWAIT startup succeeds it displays EWAIT ERRORS YKEWAIT RC xx when the YKEWAIT startup fails Executing YKRECVER When specifying c in the AC column in the Manage Copy Groups ...

Page 172: ...is CU nothing is displayed PathID Primary control unit number CU Primary SSID SSID Path direction Dir Serial number of the secondary disk controller Serial Secondary Secondary path ID When the path type is CU nothing is displayed PathID Secondary control unit number CU Secondary SSID SSID Status of the logical path used by the copy pair ESTABLISHED n n PORT S All defined physical paths have been e...

Page 173: ...torage system View the Volume Query Information panel for the relevant copy pair to check the configuration 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 wh...

Page 174: ...er control unit logical path DKC Inter disk controller logical path Type Primary storage system serial number S N Primary Primary path ID When the path type is CU nothing is displayed PathID Primary control unit number CU Primary SSID SSID Secondary storage system serial number S N Secondary Secondary path ID When the path type is CU nothing is displayed PathID Secondary control unit number CU Sec...

Page 175: ...fied in AC in the Manage Copy Groups panel the Confirm Execution Dissolve panel is displayed prompting you to confirm whether the copy pair is dissolved Figure 134 page 175 shows the Confirm Execution Dissolve panel Figure 134 Confirm Execution Dissolve Panel Contents of the Confirm Execution Dissolve Panel page 175 describes the item in the Confirm Execution Dissolve panel Table 92 Contents of th...

Page 176: ... display the Confirm Execution Recover panel This setting remains in effect until you return to the Main Menu panel Selected Do not display the Confirm panel when c is specified Cleared Display the Confirm panel Set recover execution confirmation off Pressing the Enter key dissolves the copy pair Pressing the F12 Cancel key cancels the dissolving of the copy pair Confirm Command Device Build Panel...

Page 177: ...ant to cancel the update However after an error occurred during an update of the configuration file if you attempt to cancel the update the Cancellation Warning panel is displayed instead of the Confirm Cancellation of Changes panel Figure 137 page 177 shows the Confirm Cancellation of Changes panel Figure 137 Confirm Cancellation of Changes Panel Pressing the Enter key cancels the update of the c...

Page 178: ...t you can delete a command device registered in the storage system Figure 139 page 178 shows the Confirm Command Device Delete panel Figure 139 Confirm Command Device Delete Panel displayed from Route Status Panel Contents of the Confirm Command Device Delete Panel displayed from Route Status Panel page 178 describes the items in the Confirm Command Device Delete panel Table 95 Contents of the Con...

Page 179: ...tra Command Device Direct Operation Panel page 179 lists the items displayed in the Confirm Command Device Delete panel Table 96 Contents of the Confirm Command Device Delete Panel displayed from Extra Command Device Direct Operation Panel Description Item Device number of the specified command device DEVN Specified DAD ID DADID Model name of the storage system to which the specified command devic...

Page 180: ...the Confirm Configuration File Delete panel appears prompting you to confirm whether to perform the deletion Figure 141 page 180 shows the Confirm Configuration File Delete panel Figure 141 Confirm Configuration File Delete Panel Pressing the Enter key deletes the configuration file Pressing the F12 Cancel key cancels the deletion of the configuration file Confirm Configuration File Update Panel W...

Page 181: ...ing 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 When you moved to the Add Copy Group panel by pressing F5 Add in the Copy Group Selection List panel if you press F12 Cancel in the Confirm Configuration File Update panel the display returns t...

Page 182: ...itten when the YKMAKE or YKRESYNC command is executed 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 Confirm Path Delete Panel If d is specified in AC in the Manage Path Set panel or Path Set Status panel the Confirm Path Delete panel is displayed to confirm wheth...

Page 183: ...nel When you specify b or q in AC of the Manage Path Set panel without executing the YKLOAD command the Confirm Path Set Load panel is displayed requesting the loading of the path set Figure 146 page 183 shows the Confirm Path Set Load panel Figure 146 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...

Page 184: ... is not changed N is displayed from the beginning Confirm Retry of Configuration File Create Panel In defining copy groups if an error occurs during creation of the configuration file the Confirm Retry of Configuration File Create panel is displayed asking you whether you want to create the configuration file again If an error occurs during creation of the configuration file an unusable configurat...

Page 185: ...MF Consistency Group Suspension panel Figure 150 Confirm Open MF Consistency Group Suspension Panel Contents of the Confirm Open MF Consistency Group Suspension Panel page 185 lists and describes the items in the Confirm Open MF Consistency Group Suspension panel Table 98 Contents of the Confirm Open MF Consistency Group Suspension Panel Description Item Specify whether the Confirm Open MF Consist...

Page 186: ...DE Command page 208 YKEWAIT Command page 209 YKEXPORT Command page 213 YKFCSTAT Command page 214 YKFREEZE Command page 215 YKH2B Command page 217 YKIMPORT Command page 219 YKINSCHK Command page 220 YKLOAD Command page 223 YKMAKE Command page 226 YKQHPATH Command page 229 YKQRYDEV Command page 229 YKQRYPTH Command page 232 YKQUERY Command page 235 YKRECVER Command page 237 YKRESYNC Command page 239...

Page 187: ...those parameters may be interpreted to perform an action different from the intended operation To prevent unexpected results be sure to use the correct syntax when specifying parameters List of Functions Table 99 page 187 shows the correspondence between the functions supported by Business Continuity Manager and its commands Commands are listed in alphabetical order Some CLI commands initialize th...

Page 188: ...n loaded by the YKLOAD command YKQRYPTH Displays copy pair information YKQUERY Dissolves a copy pair from an S VOL and changes the volume status to the SIMPLEX status YKRECVER Resynchronizes a copy pair by differential copy and changes the volume status to the DUPLEX status YKRESYNC Cancels the SCP status for the specified copy group and makes the update I O for P VOL enabled YKRUN Scans the entir...

Page 189: ...the P VOL remote storage system or the S VOL Non Gen ed volume The copy type parameter is BC and the host does not recognize the P VOL Non Gen ed volume but recognizes the S VOL Table 100 Configuration Files That Must Be Loaded Before Command Execution When the Environment Does Not Contain a Non Gen ed Volume Configuration file that must be loaded Command name Path set definition file Route list d...

Page 190: ...You need to load the configuration file when acquiring information about an S VOL that is not recognized by the host 4 You need to load the configuration file when you operate a CG container with EXCTG ID specified 5 You need to load the configuration file when the copy type is CA CAA or CAJ and when you specify the REVERSE parameter Legend Y You need to load the configuration file D Whether you n...

Page 191: ...lumes in the CU are Non Gen ed volumes when operating an inter CU logical path 2 You need to load the configuration file when the copy type is CAJ Legend Y You need to load the configuration file 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 synta...

Page 192: ...rder defined in the route list Enter for the primary site first and then for the secondary site Do not delete paths inter CU logical paths or inter DKC logical paths among storage systems when a command device is registered The corresponding command device should be offline before the YKBLDCMD command is executed Return Codes Table 102 page 192 lists the return codes to be returned when the YKBLDC...

Page 193: ...he path set structure specified for the STEM parameter inter CU logical paths will be established that treat CUs within storage systems that have the serial number specified by this parameter as MCUs and inter DKC logical paths will be established that treat the storage system that has the serial number specified by this parameter as the primary storage system If neither this parameter nor any oth...

Page 194: ...in STEM parameterPATH n Pri to the target node defined by stem name specified in STEM parameterPATH n Sec in the forward direction REVERSE The command establishes the logical paths that are identified in the path set stored in the path set structure specified by the STEM parameter Each path extends from the initiator node defined by stem name specified in STEM parameterPATH n Sec to the target nod...

Page 195: ...the RACF program control function 3 An interruption occurred during execution 1 The command completed normally 0 I O errors were encountered None or only some of the logical paths were established A change to an I O configuration definition was detected 32 Processing was interrupted because a REXX variable with an invalid value was encountered No logical paths were established No path to be establ...

Page 196: ...fy a timeout value for monitoring messages in seconds The default value is 15 OP OPEN GET CLOSE This parameter specifies a process type OPEN This parameter establishes the EMCS console interface for message monitoring The normal termination message returns the handle value to be used in the OP GET and OP CLOSE requests GET This parameter returns IEA494I messages IOSHM0414I messages or user specifi...

Page 197: ...Consequently the YKCONMSG command cannot monitor the completion of HyperSwaps of a copy pair at a remote site When using a CAJ copy pair even if the copy pair status changes the IEA494I message is not displayed on the MVS console Thus the YKCONMSG command cannot monitor the status transitions of the CAJ copy pair The YKCONMSG command cannot monitor Non Gen ed volumes Return Codes Table 104 page 19...

Page 198: ...ystem of the command device This deletes the command device corresponding to the specified storage system serial number CU number and CCA number If this parameter is omitted the command device defined in the route list will be used APID apid 4 digit hexadecimal number Specify the value of the APID registered in the storage system You can omit this parameter when the SN parameter is specified and n...

Page 199: ...nd terminates Table 105 YKDELCMD Command Return Code List Meaning Return Code The command terminated abnormally possibly because the user SVC routine has not been included properly 4095 to 4040 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 3 An interruption occurred during execution 1 ...

Page 200: ...acters 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 called DEVN p vol device number s vol device number 4 digit hexadecimal number 4 digit hexadecimal number Specify the ...

Page 201: ... 106 page 201 lists the return codes to be returned when the YKDELETE command terminates Table 106 YKDELETE Command Return Code List Meaning Return Code The command terminated abnormally possibly because the user SVC routine has not been included properly 4095 to 4040 The module cannot be loaded Possible causes are as follows The library dataset has not been linked The module is protected by the R...

Page 202: ... this parameter as MCUs and inter DKC logical paths will be deleted in all cases where the paths treat the storage system that has the serial number specified by this parameter as the primary storage system If neither this parameter nor any other parameters are specified the command deletes all nonshared logical paths PCU cu number 2 digit hexadecimal number If this parameter is specified out of t...

Page 203: ...re specified by the STEM parameter Each path is a reverse logical path from the initiator node defined by stem name specified in STEM parameterPATH n Sec to the target node defined by stem name specified in STEM parameterPATH n Pri 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 com...

Page 204: ...e causes are as follows The library dataset has not been linked The module is protected by the RACF program control function 3 An interruption occurred during execution 1 The command completed normally 0 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 32 Processing was interrupted because a REXX variable with ...

Page 205: ...structures will be dropped If you specify the PTH parameter the REXX variable structures related to the path set structures will be dropped Specifies the prefix of the copy group structure that contains information about the copy groups whose REXX variable structures are to be dropped This must be the same as the character string that was specified in the STEM parameter of the YKLOAD command that ...

Page 206: ...ger environment variables to the TSO E terminal The two types of information that are output are summary information and detailed information Parameters None Return codes The table below lists and describes the return codes that are returned when the YKENV command terminates Table 109 YKENV Command Return Code List Meaning Return code The command terminated normally 0 A module could not be loaded ...

Page 207: ...F If YKCMDIF is not set N A is displayed YKCMDIF Value of the Business Continuity Manager environment variable YKLCNSE which was set by the YKSETENV command If YKLCNSE is not set N A is displayed YKLCNSE Value of the system symbol YKLCNSE If YKLCNSE is not set N A is displayed YKLCNSE Value of the Business Continuity Manager environment variable YKLCNS2 which was set by the YKSETENV command If YKL...

Page 208: ...adecimal characters Specify the storage system sense byte information error code that is included in the message displayed by Business Continuity Manager For details on error codes see the section that describes storage system sense byte information in the HP StorageWorks P9000 for Business Continuity Manager Software Messages Example The following shows an example of executing the YKERCODE comman...

Page 209: ... copy pairs for the specified copy group and waits for a certain specified status Works when the storage system has corresponding function Parameters STEM stem name 1 REXX prefix of 64 or fewer characters Specify the prefix of the name of the copy group structure that stores information about the copy group to be monitored Specify the same character string as the one specified in the STEM paramete...

Page 210: ...CONSLOST or INVALID status the YKEWAIT command terminates abnormally with return code 8 HOLD Applies to Continuous Access Journal for Mainframe The command waits for all copy pairs in the group to reach the HOLD status However if any copy pair takes the SIMPLEX SUSPER SUSPCU HOLDER NODELTA or INVALID status the YKEWAIT command terminates abnormally with return code 8 In rare cases delta resync pai...

Page 211: ...SLOST or INVALID DUPLEX SIMPLEX SUSPER SUSPCU HOLD HOLDER HOLDTRNS NODELTA CONSLOST or INVALID statuses SUSPEND SUSPER SUSPCU HOLDER CONSLOST or INVALID statuses SIMPLEX SUSPER SIMPLEX SUSPCU HOLD HOLDER HOLDTRNS NODELTA CONSLOST or INVALID statuses SUSPVS SIMPLEX SUSPER SUSPCU HOLDER NODELTA or INVALID statuses HOLD SIMPLEX HOLD HOLDER HOLDTRNS NODELTA CONSLOST or INVALID statuses SWAPPING When t...

Page 212: ...ach volume Return Codes Table 1 13 page 212 lists the return codes to be returned when the YKEWAIT command terminates Table 1 13 YKEWAIT Command Return Code List Meaning Return Code The command terminated abnormally possibly because the user SVC routine has not been included properly 4095 to 4040 The module cannot be loaded Possible causes are as follows The library dataset has not been linked The...

Page 213: ...ous for Mainframe with the HyperSwap attribute Continuous Access Asynchronous for Mainframe and Continuous Access Journal for Mainframe Format YKEXPORT 1PREFIX prefix 1GROUP copy group ID Function This is a TSO E command This command reads a specified copy group definition file and creates the following CSV files based on the copy group information Pair information CSV file CSV file containing cop...

Page 214: ...ation due to invalid parameters 48 An error occurred during REXX processing 64 YKFCSTAT Command Applies to Continuous Access Synchronous for Mainframe Continuous Access Synchronous for Mainframe with the HyperSwap attribute Continuous Access Asynchronous for Mainframe and Continuous Access Journal for Mainframe Format YKFCSTAT 1STEM stem name 1 1MSG stem name 2 1DEVN device number Function This is...

Page 215: ...rn Codes Table 1 15 page 215 lists the return codes to be returned when the YKFCSTAT command terminates Table 1 15 YKFCSTAT Command Return Code List Meaning Return Code The command terminated abnormally A possible cause is as follows The user SVC routine has not been included properly 4095 to 4040 The module cannot be loaded Possible causes are as follows The library dataset has not been linked Th...

Page 216: ...same name as the MSG parameter is called TIMEOUT timeout value numeric characters 100 5000 1000 Specify the timeout value in milliseconds When the time specified with this value has elapsed after executing the YKFREEZE command the system automatically resets the SCP status You can specify a value up to 5000 milliseconds in increments of 100 milliseconds If you omit this parameter 1000 milliseconds...

Page 217: ...opy group definition file is created as follows For a CA copy group with the HyperSwap attribute A single copy group definition file is created for all detected copy pairs Parameters PREFIX prefix prefix of 25 or fewer characters Specify the prefix of a disk configuration definition file that has already been created by Business Continuity Manager and of the copy group definition file to be create...

Page 218: ... enabled are included in the scan range the copy pairs will be processed as PPRC copy pairs for which HyperSwap is enabled They will also be defined together as a TrueCopy copy group with the HyperSwap attribute Return codes Table 1 17 page 218 lists the return codes to be returned when the YKH2B command terminates Table 1 17 YKH2B Command Return Code List Meaning Return Code The command terminate...

Page 219: ... the CSV files under the following DD names and catalog the files Pair information CSV file INPAIR EXCTG information CSV file INEXCTG For details about CSV files see CSV Files Used by the Copy Group Definition File Generation Function page 355 Parameters PREFIX prefix prefix of 25 or fewer characters Specify the prefix of the copy group definition file BASEGROUP copy group ID GROUP string Specify ...

Page 220: ...nd is a TSO E command called from REXX scripts This command verifies whether the settings required during an installation and setup have been specified correctly Then this command outputs a verification result message and the setting information to the TSO E panel Parameters None Return codes Table 1 19 page 220 lists the return codes to be returned when the YKINSCHK command terminates Table 1 19 ...

Page 221: ...quired N A is output Current User SVC SVC Number Outputs the user SVC version that is currently enabled If version information cannot be acquired N A is output Current User SVC Version 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 Dynamic registered user SVC SVC Number Outputs the version of the user SV...

Page 222: ...z Directions The current users SVC routine registration number and version are listed above User SVC numbers and versions that have not been acquired are listed as N A If a Dynamic registered User SVC exists the Dynamic registered User SVC will become the Current User SVC If a Dynamic registered User SVC does not exist and a Static installed User SVC exists the Static installed User SVC will becom...

Page 223: ... specified parameters For details about REXX variable structures see About REXX Variable Structures page 323 Table 121 page 223 describes which configuration files result in which REXX variable structures for each parameter Table 121 Which File Results in Which REXX Variable Structure REXX variable structure that is created Loaded file Specified parameter Copy group structure Host Discovered Array...

Page 224: ...fy the DAD ID host DAD ID specified in the current host DAD ID You must specify this parameter when you operate the copy group Maximum length that can actually be specified 44 13 PREFIX length ROUTE route list id ROUTE string of 8 or fewer characters Specify the route list ID to be loaded This parameter should be specified in the following cases When using the TrueCopy consistency preservation fun...

Page 225: ...structures make sure that you drop all of them When you issue a command that requires a copy group stem name as the input condition execute the YKLOAD command before executing that command Even if the GROUP parameter is not specified the YKL007E message is not displayed if the ROUTE or PATH parameter is specified If none of the GROUP ROUTE and PATH parameters are specified the YKL201E message will...

Page 226: ...after the copy pairs are made Parameters STEM stem name 1 REXX prefix of 64 or fewer characters Specify the prefix of the name of the copy group structure that stores information about the copy group for which you want to make copy pairs Specify the same character string as the one specified in the STEM parameter of the YKLOAD command that loaded the corresponding copy group You must also include ...

Page 227: ...Continuity Manager Software Users Guide For CG containers specified by EXCTG ID journal groups not registered in EXCTG are registered even if there is no volume that is manipulated by the command DEVN p vol device number s vol device number 4 digit hexadecimal number 4 digit hexadecimal number Specify the device number of the copy pair P VOL and S VOL to operate If this parameter is specified for ...

Page 228: ...3688 occurs when the YKMAKE YKQUERY or YKEWAIT command is executed re execute the YKMAKE command specifying SELECT COND to register the journal group in the EXCTG Return Codes Return codes when the YKMAKE command terminates page 228 lists the return codes to be returned when the YKMAKE command terminates Table 123 Return codes when the YKMAKE command terminates Meaning Return Code The command term...

Page 229: ...een linked The module is protected by the RACF program control function 3 An interruption occurred during execution 1 I O path of the specified device is available 0 Acquisition of I O path status failed because the version of the user SVC routine was too old 4 There was no available I O path for the specified device 8 The specified device was not found or the specified device was not DASD or an A...

Page 230: ...e route list needs to be loaded before the command is executed CCA cca number 2 digit hexadecimal number Specify the CCA 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 DEVN device number 4 digit hexadecimal number Specify the device number of the volume for obtaining storage system info...

Page 231: ...StorageWorks XP12000 XP10000 Disk Array USPV Specify this option when the model of the secondary storage system for the inter DKC logical path you want to obtain is HP StorageWorks XP24000 XP20000 Disk Array VSP Specify this option when the model of the secondary storage system for the inter disk controller logical path you want to obtain is VSP Return Codes Table 125 page 231 lists the return cod...

Page 232: ...ng period character The message structure is initialized when the CLI command with the same name as the MSG parameter is specified PSN storage system serial number from 5 to 12 alphanumeric characters If this parameter is specified for each logical path within the path set stored in the path set structure specified for the STEM parameter inter CU logical paths will be acquired in all cases where t...

Page 233: ...s specified the command will acquire the status of a bidirectional logical path FORWARD The command acquires the status of forward logical paths that are identified in the path set stored in the path set structure specified by the STEM parameter each of which extends from the initiator node defined by stem name specified in STEM parameterPATH n Pri to the target node defined by stem name specified...

Page 234: ...y because the user SVC routine has not been included properly 4095 to 4040 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 3 An interruption occurred during execution 1 The command completed normally All paths are established 0 Successful completion A logical path exists for which not al...

Page 235: ...AD command that loaded the corresponding copy group You must also include a trailing period character MSG stem name 2 REXX prefix of 64 or fewer characters Specify an optional prefix for the name of the message structure used to store the messages to be generated by this command You must also include a trailing period character The message structure is initialized when the CLI command with the sam...

Page 236: ...tainers specified by EXCTG ID HP recommends that you execute the YKDELETE command and then the YKEWAIT GOTO SIMPLEX command wait until the copy pair status changes to SIMPLEX and then execute the YKQUERY command If all of the following conditions are satisfied the status cannot be acquired even if the TO parameter is specified When the copy type is BC When the volume is a Non Gen ed volume When an...

Page 237: ... while a REXX variable was being written 40 Terminating due to processing errors This return code appears for example in the following cases A GETMAIN error has occurred For CG containers specified by EXCTG ID journal groups have not yet been registered in EXCTG 44 Terminating due to invalid parameters This return code appears for example when the copy pair corresponding to the device number speci...

Page 238: ...eriod character MSG stem name 2 REXX prefix of 64 or fewer characters Specify an optional prefix for the name of the message structure used to store the messages to be generated by this command 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 DEVN p vol device number s vol device number ...

Page 239: ...ferential copy for the specified copy group and changes the volume status to the DUPLEX status Parameters STEM stem name 1 REXX prefix of 64 or fewer characters Specify the prefix of the name of the copy group structure that stores information about the copy group for which you want to synchronize a copy pair Specify the same character string as the one specified in the STEM parameter of the YKLOA...

Page 240: ... of the copy pairs in the SUSPOP status are copied A copy pair with the S VOL SWAP status is not copied Even for RESYNC the direction of the copy does not change FORWARD In BC the difference is copied from P VOL to S VOL In CA or CAA or CAJ the difference is copied from the primary site to the secondary site REVERSE In BC the difference is copied from S VOL to P VOL In CA or CAA or CAJ the differe...

Page 241: ...irs in the NODELTA status perform the following procedure 1 Execute the YKRESYNC command with both the ALLJNL parameter and the ERRCHK parameter to make sure the command terminates successfully with the return code 0 2 Execute the YKRESYNC command with only the ALLJNL parameter to make sure there all copy pairs can perform full copy ERRCHK Applies to Continuous Access Journal for Mainframe Identif...

Page 242: ... When this parameter is specified commands can be executed whether S VOL is online or offline regardless of the specification in the ONLINE parameter ONLINE YES NO Specify whether to make a copy pair if the copy destination volume is online YES The command makes copy pairs even when the S VOL P VOL if the REVERSE parameter is specified is online NO The command does not make copy pairs when the S V...

Page 243: ...all the copy pairs If ONLINE YES parameter 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 the time periods when the S VOL is not being used To use the YKRESYNC command to reflect the change in the ERRORLEVEL attribute on the device specify the VO...

Page 244: ... from REXX scripts Cancels the SCP status for the specified copy group and makes the update I O for P VOL enabled Is executable for a copy group specified by consistency group ID Works when the storage system has the corresponding function Parameters STEM stem name 1 REXX prefix of 64 or fewer characters Specify the prefix of the name of the copy group structure that stores information about the c...

Page 245: ... Command Format YKSCAN 1STEM stem name 1 1FROM X nnnn 1TO X nnnn 1FROMVSN volser 1TOVSN volser 1MSG stem name 2 1ARRAYS stem name 3 Function This command is a TSO E command called from REXX scripts This command scans the entire range of device numbers subchannel addresses and generates the REXX variables for the detected volumes The configuration file is manipulated when the command is executed Pa...

Page 246: ...s detected to stem name specified in ARRAYS parameter0 and returns the information about the nth detected storage system to the corresponding REXX variable the REXX variable with the name formed by appending n to the stem name specified by the ARRAYS parameter NOTE Before creating a copy group use the YKSCAN command to obtain the information on the volumes available on this site If storage system ...

Page 247: ...invalid parameters 48 The command terminated abnormally The user does not have permission to execute this command 128 YKSLEEP Command Format YKSLEEP 1 SEC timeout value MIN minutes Function This command is a TSO E command called from REXX scripts This command temporarily stops script execution for the specified time Parameters SEC timeout value numeric characters 1 to 9999 Specify the time in seco...

Page 248: ...ame of the copy group structure that stores information about the copy group for which you want to acquire operating information Specify the same character string as the one specified in the STEM parameter of the YKLOAD command that loaded the corresponding copy group You must also include a trailing period character The operating information is set under STATS n in the copy group structure MSG st...

Page 249: ...to check if the copy pair status has been set If no command is entered a determination is made based on the copy group status for the YKQUERY YKEWAIT command and N A might be displayed for operating information Return Codes Table 134 page 249 lists the return codes to be returned when the YKSTATS command terminates Table 134 YKSTATS Command Return Code List Meaning Return Code The command terminat...

Page 250: ... 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 PATH Specify this parameter to store path set information in the path set definition file The information other than path sets is not stored UIDCHK Specify this parameter if you want to compare...

Page 251: ...vice number 1VOLUNIT DRAIN 1SVOL PROTECT PERMIT 1DEVN p vol device number s vol device number 1VOLUNIT PURGE 1SVOL PROTECT PERMIT 1DEVN p vol device number s vol device number 1VOLUNIT FLUSH 1SVOL PROTECT PERMIT 1DEVN p vol device number s vol device number 1VOLUNIT QUICK 1SVOL PROTECT PERMIT 1DEVN p vol device number s vol device number 1VOLUNIT FORWARD 1SVOL PROTECT PERMIT 1DEVN p vol device num...

Page 252: ...p structure that stores information about the copy group for which you want to suspend the copy pair Specify the same character string as the one specified in the STEM parameter of the YKLOAD command that loaded the corresponding copy group You must also include a trailing period character MSG stem name 2 REXX prefix of 64 or fewer characters Specify an optional prefix for the name of the message ...

Page 253: ...Specify the second mmmm numeric characters 0000 to 9999 Specify an offset value from the time specified in YYYYMMDD HHMMSS in minute ss numeric characters 00 to 99 Specify an offset value from the time specified in YYYYMMDD HHMMSS in second LOCAL This value means that the specified time is in local time GMT This value means that the specified time is in GMT NOTE When you specify the time using ATT...

Page 254: ...USPEND status at the ATTIME suspend time the value specified in the TIMEOUT parameter will become invalid and the BC copy pair will be suspended at the ATTIME suspend time If you specify 0 or omit this parameter the timeout value determined by the storage system will be set If you do not use the CAJ ATTIME suspend function the value specified in the TIMEOUT parameter will become invalid and if no ...

Page 255: ... copy group is canceled Table 137 Operation When the ATTIME Suspend Time Is Canceled in BC Operation when the ATTIME suspend time is canceled Setting of the ATTIME suspend time Target storage system or copy group NORMAL ATTIME suspend time CAJ ATTIME suspend time NORMAL ATTIME suspend time CAJ ATTIME suspend time The CAJ ATTIME suspend time is canceled Specified Storage system that is not directly...

Page 256: ...e The S VOL can be read or written even when data is being copied When this parameter is not specified the S VOL can be read or written after data copying and transition to the SUSPOP status have finished For details on what happens when the ATTIME parameter is specified for the NORMAL ATTIME suspend function see the HP StorageWorks P9000 Business Copy for Mainframe Systems User Guide HP XP24000 D...

Page 257: ... that used when the DRAIN parameter is specified If this parameter is specified for Continuous Access Journal for Mainframe the data synchronization method during the suspension will be the same as that used when the FLUSH parameter is specified 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...

Page 258: ...en if the YKSUSPND command has terminated with return code 0 the copy pair might not be in the SUSPOP or SWAPPING status Therefore after you have executed the YKSUSPND command use the YKQUERY or YKEWAIT command to make sure that the copy pair status has changed to SUSPOP or SWAPPING If there is a volume whose status has not been changed re execute the YKSUSPND command with the VOLUNIT parameter sp...

Page 259: ...pecified When the ATTIME parameter and VOLUNIT parameter are both specified When a suspend that changes the copy direction for a CAA or CAJ after RESYNC is performed with the VOLUNIT or DEVN parameter specified 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...

Page 260: ...the return code 8 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 t...

Page 261: ...ansition of the copy pair on the remote site Use the YKEWAIT command When using a CAJ copy pair the YKWATCH command cannot monitor the status transition of the CAJ copy pair Use the YKEWAIT command Execute the YKWATCH command when device numbers are assigned for P VOLs of all copy pairs in the copy group specified in the GROUP parameter and the P VOLs are online You cannot specify a console ID for...

Page 262: ...g 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 W Specify this for a warning message The message is output by using the destination indicating code 6 E An error message The message is output by using the destination indicating code 6 text str...

Page 263: ...he command completed normally 0 No type has been specified 1004 The specified type is invalid 1008 No text has been specified 1012 The specified text is invalid 1016 A system error occurred 2000 Refer to the return code of the WTO macro For details see the IBM documentation MVS Programming Assembler Services Reference Other than above CLI Command Coding Examples Coding examples for each CLI comman...

Page 264: ...ommand YKDEMO06 Shows an example of using the YKRECVER command YKDEMO07 Shows an example of failing over a 2DC configuration with HyperSwap and CAJ YKDEMO08 Shows an example of failing back a 2DC configuration with HyperSwap and CAJ YKDEMO09 Uses the following CLI commands to show an example of outputting the status of a specified device to the OS console YKQRYDEV YKWTOMSG YKDEMO10 Shows an exampl...

Page 265: ...OAD calling the information about MYTCS in BCM DEMO is loaded and stored into the REXX variable structure beginning with DEMO_INFO One or more error messages that may be generated during execution of a CLI command will be stored in the message structure with the prefix that is specified by the MSG parameter In this example the message structure is assumed to have the prefix DEMO_MSG Notice that YK...

Page 266: ...the purpose of simply updating the Copy Group structure make sure the following parameter specification TIMEOUT parameter should have the value zero 0 for immediate completion of YKEWAIT NOINVALIDCHECK parameter should be specified GOTO parameter should have the value SIMPLEX address TSO YKEWAIT STEM DEMO_INFO MSG DEMO_MSG GOTO SIMPLEX TIMEOUT 0 NOINVALIDCHECK Like YKQUERY check the return code to...

Page 267: ...t end else nop call printCopyGroupStatus Suspend all copy pairs in MYTCS copy group Like YKMAKE use SELECT COND to let YKSUSPND skip a copy pair which is already being suspended Although you can omit specification of FORWARD REVERSE parameter it is strongly recommended to specify the parameter to clarify your intention address TSO YKSUSPND STEM DEMO_INFO MSG DEMO_MSG FORWARD SELECT COND Check the ...

Page 268: ...o 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 if rc 0 then do call printErrorMessage exit end else nop call printCopyGroupStatus Dissolve all copy pairs in MYTCS copy group putting them b...

Page 269: ...everity DEMO_MSG x Severity say Text DEMO_MSG x Text say Value DEMO_MSG x Value end return 0 printCopyGroupStatus This procedure prints the status information of copy pairs in the copy group MYTCS printCopyGroupStatus procedure expose DEMO_INFO say DEMO_INFO ID status information say Simplex pairs DEMO_INFO SimplexCt say Duplex pairs DEMO_INFO DuplexCt say Suspend pairs DEMO_INFO SuspendOpCt retur...

Page 270: ...m 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 if rc 0 then do call printErrorMessage exit end else nop DEMO_INFO TARGET STATE0 shows the status of a FlashCopy pair STATE0 0 ...

Page 271: ...etween two storage systems are established the script will then build a command device in the primary storage system first then a command device at the secondary storage system Once the command devices are established the sample script then deletes the command devices in reverse order then finally deletes the logical paths that it established in the beginning of the script This sample script uses ...

Page 272: ...ge exit end else nop Query for the information of the logical paths that were built in the previous call of YKBLDPTH The updated information will be stored in the REXX variable under DEMO_INFO PATH You may also check the return code for being larger than 4 as 4 also indicates successful completion of the command with some logical paths being identified to be in invalid condition address TSO YKQRYP...

Page 273: ...he storage system with SN parameter such as SN 12345 address TSO YKBLDCMD SN MSG DEMO_MSG Check the return code to see if it is 0 or not if rc 0 then do call printErrorMessage exit end else nop YKQRYDEV retrieves the information about a volume device that was specified in its parameters The following example retrieves the information about the command device in the primary storage system The infor...

Page 274: ...12345 CU 10 CCA 20 address TSO YKQRYDEV STEM DEMO_CDEVS SN CU CCA MSG DEMO_MSG Check the return code to see if it is 0 or not if rc 0 then do call printErrorMessage exit end else nop Print the information in the command device in the secondary storage system say say CDEV Secondary DKC s SSID DEMO_CDEVS SSID say CDEV Secondary is valid DEMO_CDEVS Cdev Info say CDEV Secondary is status DEMO_CDEVS Cd...

Page 275: ...pecify CU CCA and APID parameters address TSO YKDELCMD SN MSG DEMO_MSG CU CCA APID Check the return code to see if it is 0 or not if rc 0 then do call printErrorMessage exit end else nop Delete the logical paths to clean up the configuration If a logical path is defined and built as a shared path the FORCE option must be specified to delete such path When using this option make sure that no one el...

Page 276: ...opy pair in the given TC Sync copy group for 120 seconds This sample script uses the following CLI commands YKLOAD YKEWAIT YKCONMSG YKFREEZE YKSUSPND YKRUN 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 Dom...

Page 277: ... return code for successful completion of YKCONMSG with OP OPEN is 0 temp OUTTRAP MyHandle address TSO YKCONMSG OP OPEN temp OUTTRAP OFF if rc 0 then do say YKCONMSG OP OPEN failed exit end else nop Get the handler value that was obtained via YKCONMSG OP OPEN parse var MyHandle 1 HANDLE x HandlerValue Start counting the elapsed time for 120 seconds elapsedTime time e This forever loop keeps invoki...

Page 278: ...odify the value of myDevn below to the device number of a volume of a relevant copy pair to run this script myDevn devnFound pos myDevn IEA494Imsg suspFound pos PAIR SUSPENDED IEA494Imsg If the relevant copy pair became suspended then suspend the TC Sync copy group if devnFound 0 suspFound 0 then do say IEA494I message was captured for myDevn The following lines do not check the return code of eac...

Page 279: ...HANDLE x HandlerValue Check the return code to see if it is 6 or not Note that the return code for YKCONMSG with OP CLOSE is 6 for successful completion if rc 6 then say YKCONMSG OP CLOSE failed else nop exit end else nop leave Exit the loop end end Check if 120 seconds have elapsed after starting the loop elapsedTime time e if elapsedTime 120 then do say 120 seconds have elapsed Stop monitoring I...

Page 280: ...chi Ltd YKDEMO05 A sample demonstration script that illustrates how to use the Business Continuity Manager s REXX CLI commands for obtaining various copy group information This sample script uses the following CLI commands YKLOAD YKQUERY YKSTATS This sample script assumes the following settings 1 The definition files are stored in the dataset with the prefix BCM DEMO 2 TC Async copy group is used ...

Page 281: ... nop Establish all copy pairs in MYTCA copy group into DUPLEX This is for demonstration purpose only In reality you may already have a copy group up and running address TSO YKMAKE STEM DEMO_INFO MSG DEMO_MSG SELECT COND Check the return code to see if it is 0 or not if rc 0 then do call printErrorMessage exit end else nop Call YKQUERY to fully update the information in the Copy Group structure of ...

Page 282: ...FO CopyGroup 0 say Copy Group Name DEMO_INFO CopyGroup x ID say Copy Type DEMO_INFO CopyGroup x CopyType say Matching Percent DEMO_INFO CopyGroup x MatchingPerCent say C T Delta of a pair DEMO_INFO CopyGroup x Pair 1 CTDelta Some information items such as shown below are specific to either TC Async or UR The following piece of code displays some of the information items for each of TC Async and UR...

Page 283: ...s 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 YKDEMO06 address TSO YKENV YKLOAD should be called before manipulating MYTCS to make definition information of MYTCS available on the REXX environment call YK...

Page 284: ...orMessage exit end else nop Use YKWATCH to let BC Manager notify the state transition of MYTCS when it became DUPLEX You may use YKWATCH for other copy group statuses too In this example YKWATCH monitors MYTCS copy group to become DUPLEX for 30 minutes and notifies a user about such status transition by sending a notification message to the current user s console call YKWATCH PREFIX BCM DEMO GROUP...

Page 285: ...te list ID is DEMORLST 4 The primary Device Address Domain ID is PRIM Sample script begins say BEGIN YKDEMO07 address TSO YKENV YKLOAD should be called before manipulating MYTCS to make definition information of MYTCS available on the REXX environment call YKLOAD STEM DEMO_INFO PREFIX BCM DEMO GROUP MYTCS DAD PRIM MSG DEMO_MSG ROUTE DEMORLST Check the return code of YKLOAD to see if it is 0 or not...

Page 286: ...k the return code to see if it is 0 or not if rc 0 then do call printErrorMessage exit end else nop The line below shows how to execute YKRECVER The situation in which you have to use this command is rare but this command is useful when the primary site failed and a copy group between the primary and the secondary sites cannot be dissolved from the primary site In such a case YKRECVER should be us...

Page 287: ... has occurred This sample script assumes the following settings 1 The definition files are stored in the dataset with the prefix BCM DEMO 2 The TC copy group s copy group ID is MYTCHS 3 The copy group ID between the primary and remote sites is MYUR1 4 The copy group ID between the local and remote sites is MYUR2 5 The route list ID is DEMORLST 6 The primary Device Address Domain ID is PRIM The det...

Page 288: ...ssage 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 GOTO DUPLEX TIMEOUT 0 NOINVALIDCHECK Check the return code of YKEWAIT if rc 0 then do call printErrorMessage exit end else nop Check the status of MYUR1 to confirm the ready status for operations in 2DC confi...

Page 289: ... OUTTRAP to acquire the handler value that needs to be referenced in subsequent YKCONMSG calls The return code for the successful completion of YKCONMSG with the OP OPEN parameter is 0 temp OUTTRAP MyHandle address TSO YKCONMSG OP OPEN MSGID IOSHM0414I temp OUTTRAP OFF if rc 0 then do say YKCONMSG OP OPEN failed exit end else nop Get the handler value that was obtained via YKCONMSG OP OPEN parse v...

Page 290: ...from the captured IOSHM0414I string parse var MyHandle 1 IOSHM0414Imsg Check to see if the captured IOSHM0414I message is generated due to the relevant copy pair in the MYTCHS copy group performing a planned or unplanned HyperSwap PlannedFound pos Planned IOSHM0414Imsg UnplannedFound pos Unplanned IOSHM0414Imsg If a HyperSwap has occurred in the relevant copy pair then resync MYUR2 if PlannedFound...

Page 291: ...formed 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 end else nop Suspend the MYUR1 copy pair to change the status of MYUR1 into one where a DeltaResync can be performed address TSO YKSUSPND STEM DEMO_INFO MYUR1 MSG DEMO_MSG FLUSH Check the return code of YKSUSPND if rc 0 th...

Page 292: ... 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 if rc 0 then do call printErrorMessage leave Exit the loop end else nop leave Exit the loop end end Check if 120 seconds have elapsed after starting the loop el...

Page 293: ...MO_MSG x Severity say Text DEMO_MSG x Text say Value DEMO_MSG x Value end return 0 YKDEMO09 REXX All Rights Reserved Copyright C 2009 2010 Hitachi Ltd YKDEMO09 A sample demonstration script that illustrates how to use the Business Continuity Manager s CLI commands to perform fail back operations in a 2DC configuration with HyperSwap and UR This script can be used when DKC at the primary site has b...

Page 294: ...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 DEMO GROUP MYTCHS DAD PRIM MSG DEMO_MSG ROUTE DEMORLST Chec...

Page 295: ...failure configuration Delete the MYUR1 copy pair when a failure occurs address TSO YKDELETE STEM DEMO_INFO MYUR1 MSG DEMO_MSG Check the return code of YKDELETE if rc 0 then do call printErrorMessage end else nop Confirm that the status of the MYUR1 copy pair is one where the copy pair can be copied address TSO YKEWAIT STEM DEMO_INFO MYUR1 MSG DEMO_MSG GOTO SIMPLEX TIMEOUT 10 Check the return code ...

Page 296: ...re 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 GOTO HOLD TIMEOUT 10 Check the return code of YKEWAIT if rc 0 then do call prin...

Page 297: ...ne 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 GOTO SUSPEND TIMEOUT 10 Check the return code of YKEWAIT if rc ...

Page 298: ...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 0 say Severity DEMO_MSG x Severity say Text DEMO_MSG x Text say Value DEMO_MSG x Value end return 0 YKDEMO10 REXX All Rights Reserved Copyright C 200...

Page 299: ...cedure 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 retcode rc Check the return code of YKQRYDEV if retcode 0 then do Found errors during YKQRYDEV Writing USR001E message with retu...

Page 300: ... ID LicDSN Prefix of the license information dataset BCMLog Output method of the BCM log CLILog Output setting for the CLI command execution logs HostID N A LicDSN N A BCMLog N A CLILog N A Execute OUTTRAP function on the YKDSPENV style output All statuses are stored in LINE push_trap Outtrap void Outtrap line Address TSO YKENV YKENV indicates YKDSPENV style output save_retc rc void Outtrap push_t...

Page 301: ...Say 1 Host ID HostID Say 2 License info DSN prefix LicDSN Say 3 BCM log output method BCMLog Say 4 CLI log output settings CLILog Exit save_retc Command details 301 ...

Page 302: ...YKDEMO12 302 CLI Commands ...

Page 303: ...Copy copy process or not When TC pair became inconsistent because of interrupted FlashCopy copy process go to step 3 3 Check the status of each pairs When the status is CONSLOST go to step 4 and 5 4 Delete the pair of which the status is CONSLOST in MYTCS 5 Re make the deleted pair again Sample script begins Say BEGIN YKDEMO12 Call YKLOAD STEM DEMO_INFO PREFIX BCM DEMO GROUP MYTCS DAD PRIM MSG DEM...

Page 304: ... End Else Nop Confirm that the status of the deleted pair is one where the copy pair can be copied Address TSO YKEWAIT STEM DEMO_INFO MSG DEMO_MSG GOTO SIMPLEX TIMEOUT 1 NOINVALIDCHECK DEVN P_DEVN S_DEVN Check the return code of YKEWAIT If rc 0 Then Do Call PrintErrorMessage Exit End Else Nop Re make the deleted pair in MYTCS Address TSO YKMAKE STEM DEMO_INFO MSG DEMO_MSG DEVN P_DEVN S_DEVN Check ...

Page 305: ... 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 Value End Return 0 Command details 305 ...

Page 306: ... XML format see XML Document Type Definitions page 308 NOTE When data objects are saved HP StorageWorks XP24000 Disk Array is written as USPV in the file Conversion from the configuration files to the REXX variables is executed by the YKLOAD command Conversion from the REXX variables to the configuration files is executed by the YKSTORE command Executing the YKLOAD command converts the configurati...

Page 307: ...er of command devices included in the route list definition file G Number of command devices included in the command device definition file H Total number of inter CU logical paths and inter DKC logical paths that are included in the path set definition file I Number of digits in the number of copy pairs included in the copy group definition file J The configuration file dataset formats are listed...

Page 308: ...pace will increase according to the number of included characters Size to be increased for each character specified bytes Character 3 3 5 5 4 Table 145 Size to Be Increased When a Condition is Satisfied Size to be increased bytes Condition for the size to be increased Type of the configuration file No 400 A x 210 The EXCTG attribute has been defined Copy group definition file 1 400 J x 16 A x 2 76...

Page 309: ...ing of the attribute of the APIInfo elements Meaning Attribute name API level Level Last update ID UpdateID Disk Device ELEMENT DiskDevice EMPTY ATTLIST DiskDevice SerialNum CDATA REQUIRED CUNum CDATA REQUIRED SSID CDATA REQUIRED CCA CDATA REQUIRED External Y N IMPLIED The following table gives the meanings of the attributes of the DiskDevice elements Meaning Attribute name Storage system serial n...

Page 310: ...ns elements Meaning Attribute name Consistency group ID GroupID Handling of P VOL after suspending FenceLevel When Y makes SCP if SUSPER FreezeScpMode When Y the timestamp transfer mode is enabled TimeStampMode Unit of difference management Map When Y the Open MF Consistency Preservation Function is used OpenMF TCA Option ELEMENT TCA_Options EMPTY ATTLIST TCA_Options GroupID CDATA REQUIRED ErrorLe...

Page 311: ...whether secondary volumes transitioning to the suspend status can be accessed or updated AttimeSplitMode UR Option ELEMENT UR_Options EMPTY ATTLIST UR_Options GroupID CDATA REQUIRED subGroupID CDATA REQUIRED MirrorID 0 1 2 3 REQUIRED ErrorLevel GROUP VOLUME IMPLIED CTTimeMode JOURNAL VOLUME ASIS IMPLIED The following table gives the meanings of the attributes of the UR_Options elements Meaning Att...

Page 312: ...che usage rate RSF_All Reserve sidefile cache usage rate for C T RSF_CT Metadata usage rate in the journal volume JNL_Meta Journal data usage rate in the journal volume JNL_Data Operating information between journal groups JNL_Trfr Cache capacity in the journal volume GB JNL_Cache_Capacity Data capacity in the journal volume GB JNL_Data_Capacity RelatedDKCState ELEMENT RelatedDKCState DKCState DKC...

Page 313: ...D ReversedCt CDATA IMPLIED HoldCt CDATA IMPLIED HoldErCt CDATA IMPLIED ChkJnlCt CDATA IMPLIED HoldTrnsCt CDATA IMPLIED NoDeltaCt CDATA IMPLIED ConslostCt CDATA IMPLIED CurrentTime CDATA IMPLIED MatchingPercent CDATA IMPLIED InitPace SLOW NORMAL IMPLIED ProtectMode PROTECT PERMIT REQUIRED LinkageOption NONE HS IMPLIED The following table gives the meanings of the attributes of the CopyGroup element...

Page 314: ...exCt CDATA IMPLIED PendingCt CDATA IMPLIED DuplexCt CDATA IMPLIED TransitionCt CDATA IMPLIED SuspendCuCt CDATA IMPLIED SuspendOpCt CDATA IMPLIED SuspendVSCt CDATA IMPLIED SuspendErCt CDATA IMPLIED InvalidCt CDATA IMPLIED SwappingCt CDATA IMPLIED RevresyncCt CDATA IMPLIED ReversedCt CDATA IMPLIED HoldCt CDATA IMPLIED HoldErCt CDATA IMPLIED ChkJnlCt CDATA IMPLIED HoldTrnsCt CDATA IMPLIED NoDeltaCt C...

Page 315: ..._DefInfo ELEMENT EX_DefInfo EMPTY ATTLIST EX_DefInfo FwdEnable 0 1 IMPLIED RevEnable 0 1 IMPLIED FwdExctgID CDATA IMPLIED RevExctgID CDATA IMPLIED FwdSuper_Model CDATA IMPLIED RevSuper_Model CDATA IMPLIED FwdSuper_SerialNum CDATA IMPLIED RevSuper_SerialNum CDATA IMPLIED The following table gives the meanings of the attributes of the EX_DefInfo elements Meaning Attribute name Whether to use the EXC...

Page 316: ...on FwdModel Storage system model during a reverse operation RevModel Storage system serial number during a forward operation FwdSerialNum Storage system serial number during a reverse operation RevSerialNum Arbitration command device during a forward operation FwdArbCmdNo Arbitration command device during a reverse operation RevArbCmdNo Host Addressed Disk Device ELEMENT HostAddressedDisk DiskDevi...

Page 317: ...QUIRED PriCCA CDATA IMPLIED SecCCA CDATA IMPLIED ELEMENT DKCPath Ports ATTLIST DKCPath Shared Y N IMPLIED PriModel CDATA IMPLIED SecModel CDATA IMPLIED PriIFType CDATA IMPLIED SecIFType CDATA IMPLIED PriSerialNum CDATA REQUIRED SecSerialNum CDATA REQUIRED PriPathID CDATA IMPLIED SecPathID CDATA IMPLIED PriCUNum CDATA IMPLIED SecCUNum CDATA IMPLIED PriCCA CDATA IMPLIED SecCCA CDATA IMPLIED The foll...

Page 318: ...ments Meaning Attribute name Existence of sharing Shared Primary storage system model PriModel Secondary storage system model SecModel Primary storage system interface version PriIFType Secondary storage system interface version SecIFType Primary storage system serial number PriSerialNum Secondary storage system serial number SecSerialNum Primary path ID PriPathID Secondary path ID SecPathID Prima...

Page 319: ...ED CYL CDATA IMPLIED HD CDATA IMPLIED SLOTSIZE CDATA IMPLIED The following table gives the meanings of the attributes of the CDEVGRP elements Meaning Attribute name DAD ID to which a command device belongs DADID APID APID First cylinder fixed value of 0001 CYL First track fixed value of 00 HD Slot size of dummy dataset fixed value of 2000 SLOTSIZE Command Device ELEMENT CDEV DiskDevice ATTLIST CDE...

Page 320: ...n ed DAD ID 1 Non Gen ed DAD ID The default is 0 NGDADIDEnable Serial number of the scanned storage system SerialNum Storage system model Model Microcode number Microcode Interface version IFType Physical storage system serial number PhysicalSerialNum DKC ELEMENT DKC EMPTY ATTLIST DKC SerialNum CDATA REQUIRED DADID CDATA REQUIRED The following table gives the meaning of the attribute of the DKC el...

Page 321: ...wdExctgID 2 RevExctgID 1 FwdSuper_Model USPV RevSuper_Model USPV FwdSuper_SerialNum FGHK2 RevSuper_SerialNum ABCD1 ExctgDef CopyGroup ID LOS TO NY PrimaryDADID LOS SecondaryDADID NY SimplexCt 0 DuplexCt 0 PendingCt 0 SuspendOpCt 0 SuspendCuCt 0 SuspendVSCt 0 SuspendErCt 0 TransitionCt 0 SwappingCt 0 RevresyncCt 0 InvalidCt 0 ReversedCt 0 HoldCt 0 HoldErCt 0 HoldTrnsCt 0 NoDeltaCt 0 InitPace NORMAL...

Page 322: ...GHK2 CUNum 00 SSID 2340 CCA 14 External N HostAddressedDisk HostAddressedDisk Devn 7315 DiskDevice SerialNum FGHK2 CUNum 00 SSID 2340 CCA 15 External Y HostAddressedDisk HostAddressedDisk Devn 7316 DiskDevice SerialNum FGHK2 CUNum 00 SSID 2340 CCA 16 External Y HostAddressedDisk HostAddressedDisk Devn 7317 DiskDevice SerialNum FGHK2 CUNum 00 SSID 2340 CCA 17 External Y HostAddressedDisk HostDiscov...

Page 323: ...HK2 SecModel USPV SecIFType 2020 SecPathID 00 Ports Direction FORWARD Port PriPort 00 SecPort 00 Ports Ports Direction REVERSE Port PriPort 01 SecPort 01 Ports DKCPath Paths APIInfo About REXX Variable Structures The XML format configuration files in XML Document Type Definitions page 308 are loaded to the REXX variable structures by YKLOAD command that Business Continuity Manager processes with t...

Page 324: ...count sum value of CopyGroup n SuspendOpCt SuspendOpCt SUSPCU count sum value of CopyGroup n SuspendCuCt SuspendCuCt SUSPVS count sum value of CopyGroup n SuspendVSCt SuspendVSCt SWAPPING count sum value of CopyGroup n SwappingCt SwappingCt1 Count of copy pairs with reverse direction from Secondary to Primary sum value of CopyGroup n ReversedCt ReversedCt SUSPER count sum value of CopyGroup n Susp...

Page 325: ... site PriSIKeys Minimum secondary interface version value minimum value of IFType in the Host Discovered Array structure of the storage system at the secondary site SecIFMin Secondary CA key minimum value of Key TC in the Host Discovered Array structure of the storage system at the secondary site SecTCKeys Secondary TCA key minimum value of Key TCA in the Host Discovered Array structure of the DKC...

Page 326: ...t PENDING count PendingCt SUSPOP count SuspendOpCt SUSPCU count SuspendCuCt SUSPVS count SuspendVSCt SUSPER count SuspendErCt TRANS count TransitionCt Count of copy pairs with reverse direction from Secondary to Primary ReversedCt SWAPPING count SwappingCt1 REVRSY count RevrsyncCt HOLD count HoldCt HOLDER count HoldErCt CHKJNL count ChkJnlCt20 HOLDTRNS count HoldTrnsCt NODELTA count NoDeltaCt CONS...

Page 327: ...nkage option NONE HS LinkageOption Handling of P VOL after suspending NEVER STATUS DATA CA_FenceLevel Unit of difference management TRK CYL CA_Map When Y the Open MF Consistency Preservation Function is used CA_OpenMF Unit for suspending GROUP VOLUME TCA_ErrorLevel Flow Control TCA_FlowControl Unit of difference management TRK CYL TCA_Map C T group timer type for Forward TCA_F_Timer_Type C T group...

Page 328: ...y operation is completed QUICK Volumes can be accessed or updated even while the copy operation is in progress AttimeSplitMode Model XP10000 or XP12000 XP20000 or XP24000 P9500 Model Fwd13 Exctg12 Serial number SerialNum Arbitration command device ArbCmdNo15 Arbitration count time yyyymmdd hh mm ss nnnnnn ArbCTTime16 17 Journal group registration status 0 Not registered in EXCTG when an error occu...

Page 329: ...Primary storage system serial number Pri_Serialnum n5 Primary write pending rate Pri_WPR_All Primary reserve sidefile cache usage rate Pri_RSF_All9 Primary reserve sidefile cache usage rate for C T Pri_RSF_CT Secondary storage system serial number Sec_Serialnum19 Secondary write pending rate Sec_WPR_All Secondary reserve sidefile cache usage rate Sec_RSF_All9 19 Secondary reserve sidefile cache us...

Page 330: ...NL_Trfr Operating information between JNL groups in Secondary storage system Sec_JNL_Trfr19 Cache capacity in the M JNL volume GB Pri_JNL_Cache_Capacity1 0 Data capacity in the M JNL volume GB Pri_JNL_Data_Capacity Cache capacity in the R JNL volume GB Sec_JNL_Cache_Capacity1 0 19 Data capacity in the R JNL volume GB Sec_JNL_Data_Capacity1 9 Number of copy pairs number of n 0 Pair Copy pair status...

Page 331: ...or each CopyGroup information item This value is the copy group number 4 Average matching rate of copy pairs in a copy group 5 Created for each Stats information item 6 Created for each Pair information item The value is the copy pair number 7 The value acquired from the primary site is set If information is not acquired the value is 0 Note that if the copy type is BC a value acquired from the Pri...

Page 332: ...value for the entire consistency group Copy group container that is not EXCTG Minimum C T delta value for the entire consistency group EXCTG null Copy group contains one or more consistency groups for which a C T delta value cannot be acquired consistency cannot be preserved 22 If consistency cannot be preserved for each consistency group the value is null 23 This value is invalid for a PPRC copy ...

Page 333: ...hexadecimal value Example of CUMap For CUMap 1 is assigned to the area that conforms to the CU number When defined CU number is 00 01 03 and 05 the value for CUMap is 11 1 1 Example of CCAMap For CCAMap 1 is assigned to the area that conforms to the CCA When defined CCA is 01 02 05 and 06 the value for CCAMap is 11 1 1 Example of CUxx If 11 1 1 is set to CCAMap of CU 05 the value for CU05 CCAMap i...

Page 334: ... SNnnnnn Descriptions added by the user Description Storage system serial number SerialNum Storage system Model XP256 XP48 or XP512 XP128 or XP1024 XP10000 or XP12000 XP20000 or XP24000 P9500 Model Microcode number Microcode Interface version IFType Physical DKC serial number PhysicalSerialNum1 Logical DKC number LDKCNum2 BC key Key BC CA key Key CA CAJ key Key CAJ TCA key Key TCA Non Gen ed funct...

Page 335: ... value Example of CCAxx If STRG01 is set to the volume serial number of CCA FF within CU 05 the value for CU05 CCAFF Volser is STRG01 5 External volume information can be obtained when Business Continuity Manager 4 1 or later scans a device that exists in either of the following disk array models If information cannot be obtained the value is null HP StorageWorks XP12000 XP10000 Disk Array HP Stor...

Page 336: ...ription of each command for how the message structure is used Table 150 Message Structure Description REXX variables Number of messages number of n 0 Severity level Severity n1 Message ID and Message text Text Additional information Value 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...

Page 337: ...l DKC DKCMAIN microcode version Microcode Interface version IFType information for installed program product PPInfo Existence of volume attribute information Valid Info1 VOL Volume attribute NORMAL JOURNAL COMMAND Attr8 Existence of Cdev information Valid Info1 Cdev Status of command device CDEV Status2 APID APID2 Existence of copy pair information Valid Info1 Pair Number of CA copy pairs 0 1 0 CA...

Page 338: ...ir CONSLOST status Y The copy process of the related FlashCopy was interrupted N Normal status CONSLOST Status of path Active Inactive Path Fence level NEVER STATUS DATA FenceLevel3 Error level GROUP VOLUME ErrorLevel4 SSID of P VOL SSID Pri Storage system serial number of P VOL Serialnum CU number of P VOL CUNum CCA of P VOL CCA SSID of S VOL SSID Sec Storage system serial number of S VOL Serialn...

Page 339: ...1 1 Copy pace SLOW NORMAL InitPace2 Consistency group ID ID4 5 CT C T group timer type SYSTEM LOCAL NONE TimerType4 C T status Status4 Consistency time yyyymmdd hh mm ss nnnnnn Time4 6 Use of the Open MF Consistency Preservation Function Y N OpenMF5 Existence of ATTIME suspend information Valid Info1 AT Generation ID GenID4 Suspend time according to GMT yyyymmdd hh mm ss nnnnnn Time4 6 Timeout val...

Page 340: ...OpCt4 Number of suspending copy pairs TransCt4 Number of failure suspended copy pairs SuspendErCt4 Time remaining until timeout minutes Trem4 Number of BC copy pairs 0 to 3 0 BC Status of BC copy pair PENDING 01 DUPLEX 02 TRANS 03 SUSPOP 04 PENDING 05 SUSPER 06 SUSPVS 07 REVRSY 08 TRANS 09 State n Protect mode PROTECT PERMIT ProtectMode Copy pace SLOW NORMAL InitPace Copy pair matching rate Matchi...

Page 341: ...Suspend was performed because a timeout occurred Status Number of copy pairs in the C T group PairCt Number of suspended copy pairs SuspendOpCt Number of suspending copy pairs TransCt Number of failure suspended copy pairs SuspendErCt Time remaining until timeout minutes Trem Number of copy pairs made by full copy PendingCt Number of Duplex copy pairs in the C T group to which the specified device...

Page 342: ...ause no update journal was detected Status 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 BCStatus The status of the CAJ copy group when the BC copy group is suspended DUPLEX When suspend was performed all CAJ copy pairs were in DUPLEX status UNEXPECTED...

Page 343: ...tect mode PROTECT PERMIT ProtectMode 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 ExctgRegistFlag EXCTG registration flag for pair target journal group 0 1 If the EXCTG function is applied 1 is set only when the journal group that has the pair target volume of the applicable volume has ...

Page 344: ...ency time acquired from the volume TOD or DKC Time SVOL_TIME Existence of inter CU path information Valid Info1 CUxx Path Number of inter CU logical paths established from the CU to which this device belongs 0 to 4 0 Path type ESCON FIBRE type n Model of secondary Storage system XP48 or XP512 XP128 or XP1024 XP10000 or XP12000 XP20000 or XP24000 P9500 Model Sec Serial number of secondary storage s...

Page 345: ...ndary storage system Serialnum Number of path IDs established from the storage system to which this device belongs to the storage system of Sec SerialNum 0 to 64 0 Path ID PATHID n Number of path IDs established from the storage system to which this device belongs to the storage system of Sec SerialNum 0 to 8 0 Status of physical path NO PATH ESTABLISHED INIT FAILED TIME OUT NO RESOURCES AT PRI NO...

Page 346: ...sk Array HP StorageWorks XP24000 XP20000 Disk Array HP StorageWorks P9500 Disk Array When information could not be acquired the value becomes null 10 Information can be acquired for HP StorageWorks XP24000 XP20000 Disk Array 1 1 This value is invalid for a PPRC copy pair Path Set Structure Table 152 page 346 shows the path set structure Prefixes for the name of the path set structure is stem name ...

Page 347: ...P128 or XP1024 XP10000 or XP12000 XP20000 or XP24000 P9500 Model Interface version of secondary storage system IFType Secondary path ID PathID1 Secondary SSID SSID2 Secondary CU number CUNum 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 CCA The device number of the device to which I Os are issued when path operations ...

Page 348: ...re loaded from the configuration file and set as REXX variables When the YKQRYPTH command is executed REXX variables are updated FlashCopy Information Structure Table 153 page 348 shows the FlashCopy information structure The prefix for the name of the FlashCopy information structure is stem name specified in STEM parameter Each REXX variable is preceded by a period Table 153 FlashCopy Information...

Page 349: ...KQUERY command and the YKEWAIT command REXX variables that are not affected by either of the commands are omitted from the tables Table 154 REXX Variables Updated by YKQUERY and YKEWAIT YKEWAIT YKQUERY REXX variables DEVN not specified DEVN specified DEVN not specified DEVN specified Y N Y N SimplexCt Y N Y N PendingCt Y N Y N DuplexCt Y N Y N TransitionCt Y N Y N SuspendOpCt Y N Y N SuspendCuCt Y...

Page 350: ...Ct Y N Y N SuspendErCt Y N Y N TransitionCt Y N Y N ReversedCt Y N Y N SwappingCt Y N Y N RevrsyncCt Y N Y N HoldCt Y N Y N HoldErCt Y N Y N HoldTrnsCt Y N Y N NoDeltaCt Y N Y N ConslostCt Y N Y N CurrentTime N N Y N CTTime N N Y N CTDelta N N Y N MatchingPerCent N N Y N ArbCTTime Fwd Rev Exctg N N Y N JNLGValid N N Y N JNLGType N N Y N JNLState N N Y N ErrorCode 0 Pair Y Y Y Y State specified pai...

Page 351: ...TO parameter specified The tables omits REXX variables that are not affected by the YKQUERY command with the TO parameter specified Table 155 REXX Variables Updated by YKQUERY Command with the TO Parameter Specified Copy direction Reverse1 Copy direction Forward REXX variables SECONDARY specified PRIMARY specified SECONDARY specified PRIMARY specified Y Y Y Y SimplexCt Y Y Y Y PendingCt Y Y Y Y Du...

Page 352: ...t 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 Y Y Y ReversedCt Y Y Y Y SwappingCt Y Y Y Y RevrsyncCt Y Y Y Y HoldCt Y F2 F2 Y HoldErCt Y F2 F2 Y HoldTrnsCt Y F2 F2 Y NoDeltaCt Y Y Y Y ConslostCt Y Y Y Y CurrentTime F3 Y4 Y4 F3 CTTime F3 Y4 Y4 F3 CTDelta Y F2 F2 5 Y MatchingPerCent Y N Y N ArbCTTime Fwd E...

Page 353: ... the value 5 A value is set if the copy type is BC 6 00 is set for the value 7 If the copy type is BC or CA null is set for the value because information cannot be acquired Legend Y Updated F Updated to a fixed value N Not updated Not applicable REXX Variables Updated by the YKEWAIT Command with the TO Parameter Specified Table 156 page 353 shows the copy group structure s REXX variables that are ...

Page 354: ... SuspendErCt Y Y Y Y InvalidCt Y Y Y Y RevrsyncCt Y Y Y Y HoldCt Y F1 F1 Y HoldErCt Y F1 F1 Y HoldTrnsCt Y F1 F1 Y NoDeltaCt Y Y Y Y ConslostCt 0 CopyGroup Y Y Y Y SimplexCt n 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 Y Y Y ReversedCt Y Y Y Y SwappingCt Y Y Y Y RevrsyncCt Y Y Y Y HoldC...

Page 355: ...File Dataset Formats BLKSIZE bytes LRECL RECFM DSORG Type of CSV file Any 128 or more Pair information CSV file VB PS PO1 FB V F Any 128 or more EXCTG information CSV file VB PS PO1 FB V F 1 The YKEXPORT command does not support a dataset whose DSORG is PO Table 158 page 355 shows the disk requirements for CSV files When you determine the disk capacity take into account the need to make backup fil...

Page 356: ...e and after an item are ignored Character encoding must be EBCDIC CSV files generated by the YKEXPORT command If an item has no value an equal number of space characters are inserted A header line is always inserted All character strings are in uppercase letters Specification Format for a Pair Information CSV File Specify a pair information CSV file in the following format PDEVN PSN PCU PCCA SDEVN...

Page 357: ...ber If both methods are used the device number specification takes precedence 3 For only part of the specified number the volumes that exist at consecutive addresses are defined as a copy pairs The definition depends on the P VOL and S VOL specification method When volumes are specified by the device number Volumes with consecutive device numbers are defined as a copy pair When volumes are specifi...

Page 358: ...Subconsistency group ID2 SubCTID 1 Decimal Specify in the range from 0 to 3 EXCTG ID in the forward direction3 FEXCTG 1 S3 4 FSpDKC 1 5 Hexadecimal Arbitration command device of the secondary site3 FarbCDEV 1 Decimal Specify in the range from 0 to 3 EXCTG ID in the reverse direction5 REXCTG 1 S5 6 RSpDKC 1 4 Hexadecimal Arbitration command device of the primary site5 RarbCDEV 1 For details about d...

Page 359: ...1 page 359 Insert spaces appropriately The first line is a header comment Figure 151 Example of a 4x4 Configuration Defined by the YKIMPORT Command Pair information CSV file PDEVN PSN PCU PCCA SDEVN SSN SCU SCCA CTID SubCTID Number Of Pairs F101 A101 01 02 1 F201 A201 03 04 1 EXCTG information CSV file PSN SSN CTID SubCTID FEXCTG FSpDKC FarbCDEV REXCTG RSpDKC RarbCDEV 14002 14001 01 02 1 S 64051 6...

Page 360: ...G information CSV file PSN SSN CTID SubCTID FEXCTG FSpDKC FarbCDEV REXCTG RSpDKC RarbCDEV 14002 14001 01 02 1 S 64051 64050 03 04 1 002F Calling HP Technical Support If you need to call HP technical support be sure to provide as much information about the problem as possible Include the circumstances surrounding the error or failure and the exact content of any error codes and or messages displaye...

Page 361: ... details actions YKMONCG file Dataset Format Dataset Format of BCM Monitor Parameter Files page 361 shows the dataset format of BCM Monitor parameter files Table 160 Dataset Format of BCM Monitor Parameter Files BLKSIZE bytes LRECL bytes RECFM DSORG Parameter file Multiple of LRECL 80 or more V VB F or FB PS or PO YKMONOPT file Multiple of LRECL 80 or more V VB F or FB PS or PO YKMONCG file Format...

Page 362: ...an 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 Specifying comments Specify a comment symbol or at the beginning of a line or anywhere in a line that follows a space and then specify any c...

Page 363: ...in minutes to use when no timeout value is specified for the YKEWAIT command in the ACTION WAITFOR parameter in the YKMONCG file This value is also used as the timeout value for the YKEWAIT command which is issued when the CGSTARTUPSTATUS parameter is specified in the YKMONCG file MSGLEVEL SYSTSPRT message level console message level INFO CONS Specifies the message level of the messages to be outp...

Page 364: ...eturn code HP recommends that you specify a value other than 0 4 8 or 12 because these numbers are already used as BCM Monitor return codes NOTE Depending on the configuration of copy groups and the information specified in the YKMONCG file the copy group status monitoring cycle might exceed the value specified in the CYCLETIME parameter Even if you choose to omit all the parameters you still need...

Page 365: ...ucture of the YKMONCG File Structure of Parameters in the YKMONCG File page 365 shows the structure of parameters in the YKMONCG file Figure 153 Structure of Parameters in the YKMONCG File YKMONCG File 365 ...

Page 366: ...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 Values That Can Be Specified in the Startup Status and Startup Action Parameters page 366 lists the values that can be specified for the startup status and startup action Table 163 Values That Can Be Specified in the Startup Status and Startup Action Parameters Value Item SIMPL...

Page 367: ...arameter specified specify NOCANCEL If the copy group contains a copy pair in the TRANS or HOLDTRNS status CGSTARTUPSTATUS parameter processing is executed after the following processing is performed When there is a copy pair in the TRANS status The YKEWAIT GOTO SUSPEND TIMEOUT WAITTIMEOUT command is executed When there is a copy pair in the HOLDTRNS status The YKEWAIT GOTO HOLD TIMEOUT WAITTIMEOU...

Page 368: ...S parameter The copy group is sequentially searched for a copy pair in the status indicated in the copy pair status column in Processing for the Specified Startup Status page 368 If such a copy pair with the indicated status is found the processing in the processing column is performed for the copy group Table 164 Processing for the Specified Startup Status Processing Copy pair status Specified st...

Page 369: ...HOLDTRNS NODELTA REVRSY INVALID CONSLOST Executes the following commands YKRESYNC YKEWAIT GOTO DUPLEX SUSPOP SUSPCU SUSPVS Does nothing All SUSPOP SUSPOP SUSPVS Places the monitoring status of all copy groups specified in the CGID parameter to INACTIVE SIMPLEX SWAPPING REVRSY SUSPER TRANS HOLD HOLDER HOLDTRNS NODELTA INVALID CONSLOST Executes the following commands YKRESYNC YKEWAIT GOTO DUPLEX YKS...

Page 370: ...specified target status the specified action will be executed If the action execution results in an error the specified error action will be executed If you want to execute multiple actions specify the parameters with the same target status in the order you desire An example is shown below STATUS SUSPOP ACTION RESYNC MYSI 0 FORWARD STATUS SUSPOP ACTION WAITFOR MYSI DUPLEX STATUS SUSPOP ACTION SUSP...

Page 371: ...ifiable values see Combinations of Target Statuses and Actions That Can Be Specified page 370 For details on how the copy group status is determined when there are multiple copy pair statuses in the copy group see When there are multiple copy pair statuses in a copy group page 375 action Specifies the action to be executed if the copy group is in the target status The copy group specified in the Y...

Page 372: ... 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 DETAIL Outputs detailed information about the copy group STATS Outputs operating information for the copy grou...

Page 373: ...are ignored even if they are specified For details on the specifiable parameters see the description of parameters in YKRESYNC Command page 239 SUSPEND copy group ID command parameter Executes the YKSUSPND command with the specified command parameters on the specified copy group command parameter up to 256 characters of command parameter string Specifies the parameters of the YKSUSPND command The ...

Page 374: ...32 characters Specifies the label name that is to be specified in the STOP or SLEEP operator command When the STOP or SLEEP command with a label name specified is executed BCM Monitor stops or sleeps at the point of the label name PAUSE sleep time numeric characters 0 to 9999 Sleeps BCM Monitor for the period specified in sleep time Specify the sleep time in minutes BCM Monitor is released from th...

Page 375: ...irs in the INVALID status but there is a copy pair in the SUSPER status then the corresponding copy group is treated as being in the SUSPER status If there are no copy pairs in the INVALID or SUSPER status but there is a copy pair in the NODELTA status then the corresponding copy group is treated as being in the NODELTA status Table 167 Copy Pair Status Priority Copy pair status Priority INVALID 1...

Page 376: ... is executed the SELECT COND parameter is the default value However in the case of the YKSUSPND command SELECT ALL is the default value If the attempted action fails summary information about the copy group will be output regardless of the specified message level If you specify parameters for a single copy group without grouping them by the target status actions are grouped by the target status Th...

Page 377: ...storagedocsfeedback hp com Include the document title and manufacturing part number All submissions become the property of HP Related information This manual is part of a related set of manuals that include the following manuals HP StorageWorks P9000 for Business Continuity Manager Software Users Guide HP StorageWorks P9000 for Business Continuity Manager Software Messages HP StorageWorks P9000 fo...

Page 378: ...mmunications 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 ...

Page 379: ...r storage capacity values P9000 disk arrays use the following values to calculate physical storage capacity values hard disk drives 1 KB kilobyte 1 000 bytes 1 MB megabyte 1 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 P9000 disk arrays use the following values to calculate logical storage capacity values logical devices 1 KB...

Page 380: ... their arguments and argument values Monospace text Code variables Command variables Monospace italic text Emphasized monospace text Monospace bold text WARNING Indicates that failure to follow directions could result in bodily harm or death CAUTION Indicates that failure to follow directions could result in damage to equipment or data IMPORTANT Provides clarifying information or specific instruct...

Page 381: ...DED TIME 16 19 34 16 19 34 JOB00213 HASP395 USERIDA ENDED 0 JES2 JOB STATISTICS 18 SEP 2009 JOB EXECUTION DATE 15 CARDS READ 114 SYSOUT PRINT RECORDS 0 SYSOUT PUNCH RECORDS 6 SYSOUT SPOOL KBYTES 0 03 MINUTES EXECUTION TIME 1 USERIDA JOB CLASS S MSGCLASS X NOTIFY USERID JOB00213 IEFC653I SUBSTITUTION JCL CLASS S MSGCLASS X NOTIFY USERID 2 S1 EXEC PROC YKWPROC 3 XXYKWPROC PROC XX XX XX All Rights Re...

Page 382: ...rage System panel The following indicates the correspondence between values specified for each item in the Scan Copy Pair Inside Storage System panel and items to be displayed in the underlined values in italics DEVN value specified in Device Num Start value specified in Device Num End DAD value specified in Primary value specified in Secondary value specified in BC Pair S VOL Non Gen ed CGNAME1 v...

Page 383: ...ccording to the syntax enclosed by or following this symbol Single angle brackets indicate a syntax element that must be followed for each item Double angle brackets indicate the default value Double brackets indicates the range of values that can be specified Table 170 Syntax Elements Example Specifiable characters Syntax element 0 1 2 3 4 5 6 7 8 9 Numeric characters A B C D E F G H I J K L M N ...

Page 384: ...anumeric characters or special characters and Note that this string must start with an alphabetic character or special character or User ID string a123 A string consisting of alphanumeric characters Note that this string must start with an alphabetic character or special character or Console name string AAA B C A string consisting of one or more parts joined by spaces Note that the first and last ...

Page 385: ...s CCA channel command word CCW command line interface CLI common service area CSA Channel Status Byte CSB controller unit CU device address domain DAD direct access storage device DASD double byte character set DBCS disk controller DKC distribution library DLIB Device Status Byte DSB data set organization DSORG extended consistency group EXCTG file transfer protocol FTP generalized trace facility ...

Page 386: ...F state change pending SCP system display and search facility SDSF system modification program extended SMP E storage system ID SSID supervisor call interruption SVC service processor SVP TrueCopy Asynchronous for Mainframe TCA IBM Tivoli Storage Productivity Center for Replication for System z TPC R Time Sharing Option Extensions TSO E HP XP XP12000 XP10000 Disk Array USP HP XP XP24000 XP20000 Di...

Page 387: ...ity Manager environment variable enables the following settings host ID prefix of the license information dataset whether to use the system logger service and whether to output the CLI command execution logs to SYSLOG C CANCEL command An operator command used to forcibly stop a Business Continuity Manager agent or BCM Monitor cataloged procedure for startup A cataloged procedure used for startup o...

Page 388: ...al data rate Rate of the difference between the contents of a P VOL and those of an S VOL A P VOL and an S VOL form a copy pair disaster recovery testing This function disconnects the primary site copy pair from the secondary site copy pair and tests the secondary site to determine if the DR configuration is operating normally When the test ends you must resynchronize the primary site with the sec...

Page 389: ...aphically Dispersed Parallel Sysplex HyperSwaps I initialization parameter A parameter used for setting up the environment of the Business Continuity Manager agent at the startup of the agent The following settings are available by using this parameter port number reception wait time host identification name prefix DAD ID on the local site route list ID device number and log output level initiator...

Page 390: ...rmation about mainframe storage systems in Device Manager or XP Replication Manager Software master journal The copy source journal for UR MCU Main control unit monitor mode A startup mode option for Business Continuity Manager agents If you start a Business Continuity Manager agent in the monitor mode you can only monitor copy groups from XP Replication Manager Software N NG scan A function for o...

Page 391: ...ogical paths The unit for controlling logical paths PathID Identifier for the inter disk controller logical paths established from the same DKC One PathID can specify up to eight physical paths Currently only PathID 00 is available physical DKC serial number A number assigned to each storage system physical path A path connected via a Fibre Channel interface cable or serial interface ESCON cable t...

Page 392: ...ied in the BCM Monitor parameter files By specifying this parameter in the MODIFY command you can change the CYCLETIME WAITTIMEOUT or MSGLEVEL values and change the monitoring status of a copy group between ACTIVE and INACTIVE SETINIT command An operator command used to set the initialization parameter for the Business Continuity Manager agent By specifying this parameter in the MODIFY command you...

Page 393: ...niversal Replicator Also known as HP XP Continuous Access Journal Cnt Acc J V VOLSER Volume serial number W WAKEUP command An operator command used to wake up BCM Monitor This command is specified in the MODIFY command Y YKAGENT An executable program of the Business Continuity Manager agent This is also the name of the standard startup cataloged procedure of the Business Continuity Manager agent Y...

Page 394: ...05 for pair 105 common displays among panels 15 configuration file dataset format 307 example 321 required disk space 307 that must be loaded before command execution 188 Confirm Cancellation of Changes Panel 177 Confirm Cancellation of Editing Panel 177 Confirm Command Build Device Panel 176 Confirm Command Device Delete Panel 178 Confirm Configuration File Delete Panel 180 Confirm Configuration ...

Page 395: ...nel 53 ERRCHK parameter YKRESYNC command 241 error level 81 example command device definition file 322 configuration file 321 copy group definition file 321 disk configuration definition file 322 path set definition file 323 route list definition file 322 example of scan result PPRC copy pair 381 Exception Message Panel 16 executing YKBLDCMD command 106 YKDELCMD 100 YKDELCMD command 107 YKDELETE 1...

Page 396: ... 1 1 LOCATE command 1 1 LOCATE command format 1 1 Logical Path Status panel 1 13 M Main Menu panel 20 Manage Copy Groups panel 1 15 Manage Licenses panel 29 Manage Path Set panel 109 Manage Route panel 98 Message Panel 30 message structure 336 MIN parameter YKSLEEP command 247 MSG parameter YKBLDCMD command 192 YKBLDPTH command 193 YKDELCMD command 198 YKDELETE command 200 YKDELPTH command 202 YKE...

Page 397: ...CVER command 238 YKRESYNC command 243 YKRUN command 244 YKSCAN command 246 YKSLEEP command 247 YKSTATS command 249 YKSTORE command 250 YKSUSPND command 258 YKWATCH command 261 REVERSE parameter YKBLDPTH command 194 YKDELPTH command 203 YKMAKE command 226 YKQRYPTH command 233 YKRESYNC command 240 YKSUSPND command 257 REXX variable structure 323 REXX variable updated by YKQUERY command and YKEWAIT c...

Page 398: ...379 Storage System Selection List panel 50 Storage System DAD Selection List panel 56 Storage System DADID Selection List panel 39 storage systems supported models 8 Subscriber s Choice HP 377 SVOL parameter YKSUSPND command 257 symbols in text 380 T technical support 360 HP 377 service locator website 379 text parameter YKWTOMSG command 262 text symbols 380 text 1 parameter YKWTOMSG command 262 t...

Page 399: ...w of sample script 264 sample script 298 YKDEMO1 1 overview of sample script 264 sample script 302 YKDEMO12 overview of sample script 264 YKDEMO1S overview of sample script 264 sample script 299 YKEWAIT command 209 TO parameter 212 YKEXPORT command 213 YKFCSTAT command 214 YKFREEZE command 215 YKH2B command 217 CGNAME parameter 218 DAD parameter 217 DEVN parameter 217 HS parameter 218 PREFIX param...

Reviews:

No comments

Brands by name

Popular brands

Load more brands