Home » HP Manuals » Storage Devices » HP XP P9500 » Manual Viewer

HP XP P9500 HP P9000 Business Continuity Manager Reference Guide (T5253-96058, - Page 215

CGNAME, HS{CHECK|NOCHECK}, <DAD string&gt, <string of 8 or fewer, characters&gt

Add to My Manuals
Save this manual to your list of manuals

Page 215 highlights

If device-number-2 is smaller than device-number-1, device-number-2 is treated as the starting DEVN of the scan range and device-number-1 is treated as the ending DEVN of the scan range. DAD(dad-id) ~ The maximum length of the specification must be 44 - (13 + PREFIX-length). CGNAME(name-of-TrueCopy-copy-group-with-HyperSwap-attribute) ~ Specify the name of a CA copy group with the HyperSwap attribute. HS({CHECK|NOCHECK}) Specify whether to check if HyperSwaps are enabled for the detected PPRC copy pairs. • CHECK Acquires the UCB information (UCBHSWAP) of the P-VOLs of detected PPRC copy pairs and checks whether HyperSwaps are enabled. Only those PPRC copy pairs for which UCBHSWAP is set to ON are defined as a CA copy group with the HyperSwap attribute. • NOCHECK Does not check whether HyperSwaps are enabled for the detected PPRC copy pairs. Instead, all detected copy pairs are defined as a CA copy group with the HyperSwap attribute. NOTE: • If a copy group definition file with the same name as the name specified in the CGNAME parameter already exists, executing the YKH2B command overwrites the existing file with the newly created file. To retain the existing file, specify in the CGNAME parameter a name that is different from any existing copy group definition file name. • When you specify NOCHECK for the HS parameter, for the scan range, include only PPRC TrueCopy copy pair volumes for which HyperSwap is enabled. If volumes of non-PPRC TrueCopy copy pairs or volumes of PPRC copy pairs for which HyperSwap is not 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 117 (page 215) lists the return codes to be returned when the YKH2B command terminates. Table 117 YKH2B Command Return Code List Return Code 0 Meaning The command terminated normally. A copy group definition file was created. 4 • The command terminated normally. No copy pairs were detected within the specified device number range. • Although a copy group definition file was generated, undefined volume information was detected in the disk configuration definition file at the site specified by the DAD parameter for a pair that is within the range specified by the DEVN parameter. • Although a copy group definition file was generated, a change was detected in an I/O configuration while the YKH2B command was being executed by omitting the HS parameter or by specifying CHECK. • Although a copy group definition file was generated, a storage system that does not support 2DC configurations with HyperSwap and CAJ was detected. 8 An I/O error occurred in a volume within the scan range. A copy group definition file was created for the successfully detected volumes. Command details 215

Section	Page
P9000 for Business Continuity Manager Software Reference Guide	1
Contents	3
1 ISPF Panels	8
Overview of ISPF Panels	8
ISPF Panel System	9
Operating Procedures	10
Function Keys	10
Panel Scrolling	11
Command Line Commands	11
LOCATE Command	11
SELECT Command	11
SORT Command	12
SCANPAIR Command	13
ERRCODE Command	13
Commands that Can Be Used on the Command Line	13
ISPF Settings	14
Setting the Position of the Command Line	14
Setting the Number of PF Keys that are Displayed	14
Common Displays Among Panels	15
Panel Help Information	15
Setting Information Panel	15
Exception Message Panel	16
Cancellation Warning Panel	17
Error Code Help Panel	18
Update Warning Panel	19
Capacity Warning Panel	20
Notes Common to All Panels	20
Main Menu Panel	20
Installation Verification Summary Panel (Environment Settings Verification)	23
Security Setting Information Panel	24
User SVC Information Panel	25
Set Defaults Panel (Prefix and DAD ID Settings)	26
Manage Licenses Panel (License Management)	29
Message Panel	30
Discover/Define Configuration Panel (Configuration File Definition)	30
Discover HP Storage System Panel	31
Scan Device Address Extent Panel	33
CU Selection List for Remote Storage Array Panel	35
CCA Selection List for Edit devn Panel	36
Edit Device Number for CU Panel	38
Storage System/DADID Selection List Panel	39
Control Unit Selection List Panel	39
Command Control Address (CCA) Selection List Panel	40
Scan Remote Device Address Extent Panel	41
Route Config Panel	42
Add Route List ID Panel	45
Route Information Panel	45
Add Route Panel	46
Add APID Panel	47
Inner Route Information Panel	48
Add Route Entry Panel	49
Add Remote Route Entry Panel	49
Storage System Selection List Panel	50
Define Command Device Panel	51
Sort the Define Command Device Panel	52
Edit APID Panel	53
Entire Route Information Panel	53
Add Route Entry Panel	55
Storage System/DAD Selection List Panel	56
Insert Route Entry Panel	57
Edit Route Entry Panel	57
Edit Remote Route Entry Panel	58
Insert Remote Route Entry Panel	59
Path Set Selection List Panel	60
Add Path Set Panel	61
Path Set Detail Panel	61
Edit Logical Path Definition Panel	63
Select Storage System Panel	65
Select SSID Panel	66
Edit Port Definition Panel	67
Assign Port Panel	68
Sort Logical Paths in Path Set Panel	68
Copy Group Selection List Panel	69
Add Copy Group Panel	72
Copy Group Detail Definition Panel	73
Copy Group Attributes Panel	76
Setting C/T ID Attributes Panel	85
Copy Group Pair Detail Panel	86
Pair Selection List (Primary) Panel	88
Import SMS Storage Group Panel	90
Import SMS Storage Group Result Panel	90
Pair Selection List (Secondary) Panel	91
Sort Copy Group Container Panel	92
Sort Copy Group Pairs List Panel	93
Scan Copy Pair Inside Storage System Panel	94
Browse Copy Group Detail Definition Panel	96
Browse Copy Group Pair Detail Panel	97
Manage Route Panel (Route Management)	97
Extra Command Device Direct Operation Panel	98
Executing YKDELCMD	100
Route Status Panel (Route Management)	100
Executing YKQRYDEV	103
Executing YKBLDCMD	105
Executing YKDELCMD	105
Command Device Selection Panel	106
Manage Path Set Panel (Logical Path Management)	107
Executing YKLOAD	109
Executing YKDELPTH	109
Path Set Status Panel (Executing YKQRYPTH)	109
Logical Path Status Panel	111
Executing YKQRYPTH with RESTRUCT Specified	113
Manage Copy Groups Panel (Copy Group Operation)	113
Sort the Copy Groups Panel	116
Executing YKLOAD	117
Copy Group Status Summary Panel (Executing YKQUERY)	118
Copy Group Storage System Summary Panel	121
CAA Copy Group Performance Statistics Panel	122
Sort CAA Copy Group Statistics Panel	124
CAJ Copy Group Performance Statistics Panel	125
Sort CAJ Copy Group Statistics Panel	128
Copy Group Pair Status Panel	129
Sort the Copy Group Pairs Status Panel	132
Volume Query Information (BC) Panel	132
Volume Query Information (CA) Panel	138
Volume Query Information (CAA) Panel	142
Volume Query Information (CAJ) Panel	148
Volume Query Information Panel (Executing YKQRYDEV)	155
Executing YKMAKE	156
Executing YKSUSPND	157
Executing YKRESYNC	162
Executing YKDELETE	165
Executing YKWATCH	165
Executing YKEWAIT	166
Executing YKRECVER	168
Path Set Status of Copy Group Pair Panel (YKQRYDEV with PATH Parameter Specified)	168
Logical Path Status of Copy Group Pair Panel	170
Confirmation Panels	171
Confirm Execution Dissolve Panel	171
Confirm Execution Recover Panel	172
Confirm Command Device Build Panel	173
Confirm Cancellation of Changes Panel	173
Confirm Cancellation of Editing Panel	174
Confirm Command Device Delete Panel	174
Displayed from Route Status Panel	174
Displayed from Extra Command Device Direct Operation Panel	175
Confirm Configuration File Delete Panel	176
Confirm Configuration File Update Panel	177
Confirm Copy Group Load Panel	178
Confirm Overwrite ONLINE Target Volume Panel	178
Confirm Path Delete Panel	179
Confirm Path Set Load Panel	179
Confirm Route Delete Panel	180
Confirm Route List Edit Panel	180
Confirm Retry of Configuration File Create Panel	181
Confirm Open/MF Consistency Group Suspension Panel	181
2 CLI Commands	183
Copy Types and Targets for Which Commands Can Be Executed	184
List of Functions	184
Configuration Files That Must Be Loaded Before Command Execution	185
Command details	188
YKBLDCMD Command	188
YKBLDPTH Command	189
YKCONMSG Command	192
YKDELCMD Command	194
YKDELETE Command	196
YKDELPTH Command	198
YKDROP Command	201
YKENV Command	203
YKERCODE Command	205
YKEWAIT Command	206
YKEXPORT Command	210
YKFCSTAT Command	211
YKFREEZE Command	213
YKH2B Command	214
YKIMPORT Command	216
YKINSCHK Command	217
YKLOAD Command	220
YKMAKE Command	223
YKQHPATH Command	226
YKQRYDEV Command	227
YKQRYPTH Command	229
YKQUERY Command	232
YKRECVER Command	234
YKRESYNC Command	236
YKRUN Command	241
YKSCAN Command	242
YKSLEEP Command	244
YKSTATS Command	245
YKSTORE Command	246
YKSUSPND Command	247
YKWATCH Command	256
YKWTOMSG Command	258
CLI Command Coding Examples	260
YKDEMO01	261
YKDEMO02	266
YKDEMO03	267
YKDEMO04	272
YKDEMO05	277
YKDEMO06	279
YKDEMO07	281
YKDEMO08	283
YKDEMO09	290
YKDEMO10	295
YKDEMO1S	296
YKDEMO11	296
YKDEMO12	297
3 Data Objects	301
Saving and Converting Objects	301
Dataset Formats and Required Disk Capacity for the Configuration File	302
XML Document Type Definitions	303
Configuration File Examples	316
Example Contents of Copy Group Definition File	316
Example Contents of Disk Configuration Definition File	317
Example Contents of Route List Definition File	317
Example Contents of Command Device Definition File	317
Example Contents of Path Set Definition File	318
About REXX Variable Structures	318
Copy Group Structure	318
Host-discovered Array Index Structure	327
Host-discovered Array Structure	328
Route List Structure	330
Message Structure	331
Device Information Structure	331
Path Set Structure	340
FlashCopy Information Structure	342
REXX Variables Updated by YKQUERY and YKEWAIT Commands	343
REXX Variables Updated by YKQUERY Command with the TO Parameter Specified	345
REXX Variables Updated by the YKEWAIT Command with the TO Parameter Specified	348
CSV Files Used by the Copy Group Definition File Generation Function	349
CSF File Dataset Formats and Disk Requirements	349
Specification Format for CSV Files	350
Coding Rules	350
Specification Format for a Pair Information CSV File	350
Specification format for an EXCTG Information CSV File	352
Examples of CSV Files	353
CSV Files Used by the YKIMPORT Command	353
CSV Files Used by the YKEXPORT Command	353
4 BCM Monitor Parameter Files	355
Overview of BCM Monitor Parameter Files	355
Content of the BCM Monitor Parameter Files	355
Dataset Format	355
Format of Parameter Explanations	355
Specifying parameters	355
Parameter specifications across multiple lines	355
Maximum number of characters per line	356
Specifying comments	356
YKMONOPT File	356
Structure of the YKMONOPT file	356
YKMONCG File	358
Structure of the YKMONCG File	359
Copy Group Parameters	360
Processing for Changing to the Startup Status	361
5 Support and other resources	370
Contacting HP	370
Subscription service	370
Documentation feedback	370
Related information	370
HP websites	372
Conventions for storage capacity values	372
Typographic conventions	372
A Example of the Scan Results of PPRC Copy Pairs	374
Example of the scan results of PPRC copy pairs	374
B Symbols Used in Syntax Explanations	376
C Acronyms and Abbreviations	378
Glossary	380

Match case Limit results 1 per page

device-number-2

is smaller than

device-number-1

device-number-2

is treated as the starting

DEVN

of the scan range and

device-number-1

is treated as the ending

DEVN

of the scan range.

DAD(

dad-id

)

~ <DAD string>

The maximum length of the specification must be 44 - (13 + PREFIX-length).

CGNAME(

name-of-TrueCopy-copy-group-with-HyperSwap-attribute

)

~ <string of 8 or fewer

characters>

Specify the name of a CA copy group with the HyperSwap attribute.

HS({CHECK|NOCHECK})

Specify whether to check if HyperSwaps are enabled for the detected PPRC copy pairs.

•

CHECK

Acquires the UCB information (

UCBHSWAP

) of the P-VOLs of detected PPRC copy pairs and

checks whether HyperSwaps are enabled. Only those PPRC copy pairs for which

UCBHSWAP

is set to

are defined as a CA copy group with the HyperSwap attribute.

•

NOCHECK

Does not check whether HyperSwaps are enabled for the detected PPRC copy pairs. Instead,

all detected copy pairs are defined as a CA copy group with the HyperSwap attribute.

NOTE:

•

If a copy group definition file with the same name as the name specified in the

CGNAME

parameter already exists, executing the

YKH2B

command overwrites the existing file with the

newly created file. To retain the existing file, specify in the

CGNAME

parameter a name that

is different from any existing copy group definition file name.

•

When you specify NOCHECK for the HS parameter, for the scan range, include only PPRC

TrueCopy copy pair volumes for which HyperSwap is enabled. If volumes of non-PPRC

TrueCopy copy pairs or volumes of PPRC copy pairs for which HyperSwap is not 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 117 (page 215)

lists the return codes to be returned when the

YKH2B

command terminates.

Table 117 YKH2B Command Return Code List

Meaning

Return Code

The command terminated normally. A copy group definition file was created.

•

The command terminated normally. No copy pairs were detected within the specified

device number range.

•

Although a copy group definition file was generated, undefined volume information

was detected in the disk configuration definition file at the site specified by the

DAD

parameter for a pair that is within the range specified by the

DEVN

parameter.

•

Although a copy group definition file was generated, a change was detected in an

I/O configuration while the

YKH2B

command was being executed by omitting the

HS parameter or by specifying

CHECK

•

Although a copy group definition file was generated, a storage system that does not

support 2DC configurations with HyperSwap and CAJ was detected.

An I/O error occurred in a volume within the scan range. A copy group definition file

was created for the successfully detected volumes.

Command details

215