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

HP XP P9500 HP StorageWorks P9000 for Business Continuity Manager Software Ref - Page 236

PRIMARY, SECONDARY, VERIFY, REXX Variables Updated by YKQUERY Command with the TO Parameter

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

Page 236 highlights

can acquire, see "REXX Variables Updated by YKQUERY Command with the TO Parameter Specified" (page 351). PRIMARY The information is acquired from the P-VOL at the time the copy pair was defined. SECONDARY The information is acquired from the S-VOL at the time the copy pair was defined. VERIFY If this parameter is specified, the command checks the copy group structure, provided that the copy pair is not in the SIMPLEX status, and allows information to be acquired from the P-VOL. For details about the content that is checked, see the description of the copy group configuration check function in the HP StorageWorks P9000 for Business Continuity Manager Software Users Guide. NOTE: • For CG containers specified by EXCTG ID, if you execute the YKDELETE command and then the YKQUERY command to obtain the copy pair status, the YKZ296E message sometimes appears when the dissolving of the copy pair is detected at a different time from the dissolving of EXCTG, but this does not mean that an error has occurred. However, for CG containers 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 error occurs in the pair Gen'ed volume Return Codes Table 127 (page 236) lists the return codes to be returned when the YKQUERY command terminates. Table 127 YKQUERY Command Return Code List Return Code -4095 to -4040 -3 Meaning The command terminated abnormally, possibly because the user SVC routine has not been included properly. The module cannot be loaded. Possible causes are as follows: • The library dataset has not been linked. • The module is protected by the RACF program control function. -1 An interruption occurred during execution. 0 The command completed normally. 8 P-VOLs in incompatible status. This return code appears, for example, when the P-VOL is in the offline status. 12 The VERIFY parameter was specified, and the copy group definition was found to be inconsistent with the actual copy group. 236 CLI Commands

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	13
SCANPAIR Command	13
ERRCODE Command	13
Commands that Can Be Used on the Command Line	13
ISPF Settings	14
Setting the Position of the Command Line	14
Setting the Number of PF Keys that are Displayed	15
Common Displays Among Panels	15
Panel Help Information	15
Setting Information Panel	15
Exception Message Panel	16
Cancellation Warning Panel	18
Error Code Help Panel	18
Update Warning Panel	19
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)	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 for Edit devn Panel	37
Edit Device Number for CU Panel	38
Storage System/DADID Selection List Panel	39
Control Unit Selection List Panel	40
Command Control Address (CCA) Selection List Panel	41
Scan Remote Device Address Extent Panel	42
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	86
Copy Group Pair Detail Panel	87
Pair Selection List (Primary) Panel	89
Import SMS Storage Group Panel	90
Import SMS Storage Group Result Panel	91
Pair 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 YKQRYDEV	104
Executing YKBLDCMD	106
Executing YKDELCMD	107
Command Device Selection Panel	107
Manage Path Set Panel (Logical Path Management)	109
Executing YKLOAD	110
Executing YKDELPTH	111
Path Set Status Panel (Executing YKQRYPTH)	111
Logical Path Status Panel	113
Executing YKQRYPTH with RESTRUCT Specified	115
Manage Copy Groups Panel (Copy Group Operation)	115
Sort the Copy Groups Panel	118
Executing YKLOAD	119
Copy Group Status Summary Panel (Executing YKQUERY)	120
Copy Group Storage System Summary Panel	123
CAA Copy Group Performance Statistics Panel	124
Sort CAA Copy Group Statistics Panel	126
CAJ Copy Group Performance Statistics Panel	127
Sort CAJ Copy Group Statistics Panel	130
Copy Group Pair Status Panel	131
Sort the Copy Group Pairs Status Panel	134
Volume Query Information (BC) Panel	135
Volume Query Information (CA) Panel	140
Volume Query Information (CAA) Panel	145
Volume Query Information (CAJ) Panel	151
Volume Query Information Panel (Executing YKQRYDEV)	158
Executing YKMAKE	159
Executing YKSUSPND	160
Executing YKRESYNC	165
Executing YKDELETE	168
Executing YKWATCH	169
Executing YKEWAIT	170
Executing YKRECVER	171
Path Set Status of Copy Group Pair Panel (YKQRYDEV with PATH Parameter Specified)	171
Logical Path Status of Copy Group Pair Panel	173
Confirmation Panels	175
Confirm Execution Dissolve Panel	175
Confirm Execution Recover Panel	176
Confirm Command Device Build Panel	176
Confirm Cancellation of Changes Panel	177
Confirm Cancellation 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
Confirm Route Delete Panel	183
Confirm Route List Edit Panel	184
Confirm Retry of Configuration File Create Panel	184
Confirm Open/MF Consistency Group Suspension Panel	185
2 CLI Commands	186
Copy Types and Targets for Which Commands Can Be Executed	187
List of Functions	187
Configuration Files That Must Be Loaded Before Command Execution	188
Command details	191
YKBLDCMD Command	191
YKBLDPTH Command	192
YKCONMSG Command	195
YKDELCMD Command	197
YKDELETE Command	199
YKDELPTH Command	201
YKDROP Command	204
YKENV Command	206
YKERCODE Command	208
YKEWAIT Command	209
YKEXPORT Command	213
YKFCSTAT Command	214
YKFREEZE Command	215
YKH2B Command	217
YKIMPORT Command	219
YKINSCHK Command	220
YKLOAD Command	223
YKMAKE Command	226
YKQHPATH Command	229
YKQRYDEV Command	229
YKQRYPTH Command	232
YKQUERY Command	235
YKRECVER Command	237
YKRESYNC Command	239
YKRUN Command	244
YKSCAN Command	245
YKSLEEP Command	247
YKSTATS Command	248
YKSTORE Command	249
YKSUSPND Command	251
YKWATCH Command	259
YKWTOMSG Command	262
CLI Command Coding Examples	263
YKDEMO01	264
YKDEMO02	269
YKDEMO03	271
YKDEMO04	276
YKDEMO05	280
YKDEMO06	283
YKDEMO07	285
YKDEMO08	287
YKDEMO09	293
YKDEMO10	298
YKDEMO1S	299
YKDEMO11	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 Contents of Command Device Definition File	322
Example Contents of Path Set Definition File	323
About REXX Variable Structures	323
Copy Group Structure	323
Host-discovered Array Index Structure	332
Host-discovered Array Structure	333
Route List Structure	335
Message Structure	336
Device Information Structure	336
Path Set Structure	346
FlashCopy Information Structure	348
REXX Variables Updated by YKQUERY and YKEWAIT Commands	349
REXX Variables Updated by YKQUERY Command with the TO Parameter Specified	351
REXX Variables Updated by the YKEWAIT Command with the TO Parameter Specified	353
CSV Files Used by the Copy Group Definition File Generation Function	355
CSF File Dataset Formats and Disk Requirements	355
Specification Format for CSV Files	355
Coding Rules	355
Specification Format for a Pair Information CSV File	356
Specification format for an EXCTG Information CSV File	358
Examples of CSV Files	359
CSV Files Used by the YKIMPORT Command	359
CSV Files Used by the YKEXPORT Command	359
Calling HP Technical Support	360
4 BCM Monitor Parameter Files	361
Overview 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 Group Parameters	366
Processing for Changing to the Startup Status	368
5 Support and other resources	377
Contacting HP	377
Subscription service	377
Documentation feedback	377
Related information	377
HP websites	379
Conventions for storage capacity values	379
Typographic conventions	379
A Example of the Scan Results of PPRC Copy Pairs	381
Example of the scan results of PPRC copy pairs	381
B Symbols Used in Syntax Explanations	383
C Acronyms and Abbreviations	385
Glossary	387

Match case Limit results 1 per page

can acquire, see

“REXX Variables Updated by YKQUERY Command with the TO Parameter

Specified” (page 351)

PRIMARY

The information is acquired from the P-VOL at the time the copy pair was defined.

SECONDARY

The information is acquired from the S-VOL at the time the copy pair was defined.

VERIFY

If this parameter is specified, the command checks the copy group structure, provided that the copy

pair is not in the SIMPLEX status, and allows information to be acquired from the P-VOL. For details

about the content that is checked, see the description of the copy group configuration check function

in the

HP StorageWorks P9000 for Business Continuity Manager Software Users Guide

NOTE:

•

For CG containers specified by EXCTG ID, if you execute the

YKDELETE

command and then

the

YKQUERY

command to obtain the copy pair status, the

YKZ296E

message sometimes

appears when the dissolving of the copy pair is detected at a different time from the dissolving

of EXCTG, but this does not mean that an error has occurred. However, for CG containers

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 error occurs in the pair Gen'ed volume

Return Codes

Table 127 (page 236)

lists the return codes to be returned when the

YKQUERY

command terminates.

Table 127 YKQUERY CommandReturn Code List

Meaning

Return Code

The command terminated abnormally, possibly because the user SVC routine has

not been included properly.

-4095

-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.

P-VOLs in incompatible status. This return code appears, for example, when the

P-VOL is in the offline status.

The

VERIFY

parameter was specified, and the copy group definition was found

to be inconsistent with the actual copy group.

236

CLI Commands