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

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

route-code, console-id, console-name, <numeric characters> 0 to 127

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

Page 261 highlights

OPERATOR(route-code) ~ ((0 to 127)) Transmits the messages issued by the YKWATCH command to the operator with the address code specified in the parameter. CN({console-id|console-name INTERNAL}) ~ ((0 to 99)) (for a console ID) or (for a console name) Specifies in which of the operator console queues the messages issued by the YKWATCH command are placed. console-id Places the messages in the operator console queue with the console ID specified in the parameter. console-name Places the messages in the operator console queue with the console ID specified in the parameter. INTERNAL Sends the messages to the active console in which INTIDS=Y is defined. NOTE: • In some configurations such as when CA and BC share volumes or a 1 to n (n is greater than 2) configuration of BC, the status transitions of each copy pair might not be correctly monitored. • When using a copy pair on a remote site (a site that is not channel-connected directly from the local host), the YKWATCH command cannot monitor the status transition of the copy pair on the remote site. Use the YKEWAIT command. • 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 the CN operand when the OS being used is z/OS V1R8 or later. • Specify INTERNAL for the CN operand only when the OS being used is z/OS V1R9 or later. • The YKWATCH command cannot monitor Non Gen'ed volumes. • The YKWATCH command cannot monitor the transition to the CONSLOST status. Use the YKEWAIT command. Return Codes Table 139 (page 261) lists the return codes to be returned when the YKWATCH command terminates. Table 139 YKWATCH Command Return Code List Return Code 0 4 8 12 Meaning The command completed normally. A timeout or interrupt occurred before the volume status changes to the requested volume status. A copy pair or copy pairs in the specified group are placed in the status from which the required status is not reachable. Cannot make status transition because there is a copy pair with a P-VOL of which is offline in the specified group. Command details 261

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

OPERATOR(

route-code

)

~ <numeric characters> ((0 to 127))

Transmits the messages issued by the

YKWATCH

command to the operator with the address code

specified in the parameter.

CN({

console-id

console-name

INTERNAL

})

~ <numeric characters> ((0 to 99)) (for a

console ID) or <console name string from 2 to 8 characters> (for a console name)

Specifies in which of the operator console queues the messages issued by the

YKWATCH

command

are placed.

console-id

Places the messages in the operator console queue with the console ID specified in the parameter.

console-name

Places the messages in the operator console queue with the console ID specified in the parameter.

INTERNAL

Sends the messages to the active console in which INTIDS=Y is defined.

NOTE:

•

In some configurations such as when CA and BC share volumes or a 1 to

(

is greater than

2) configuration of BC, the status transitions of each copy pair might not be correctly monitored.

•

When using a copy pair on a remote site (a site that is not channel-connected directly from

the local host), the

YKWATCH

command cannot monitor the status transition of the copy pair

on the remote site. Use the

YKEWAIT

command.

•

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 the CN operand when the OS being used is z/OS V1R8

or later.

•

Specify

INTERNAL

for the

operand only when the OS being used is z/OS V1R9 or later.

•

The

YKWATCH

command cannot monitor Non Gen'ed volumes.

•

The

YKWATCH

command cannot monitor the transition to the CONSLOST status. Use the

YKEWAIT

command.

Return Codes

Table 139 (page 261)

lists the return codes to be returned when the

YKWATCH

command terminates.

Table 139 YKWATCH Command Return Code List

Meaning

Return Code

The command completed normally.

A timeout or interrupt occurred before the volume status changes to the requested

volume status.

A copy pair or copy pairs in the specified group are placed in the status from which

the required status is not reachable.

Cannot make status transition because there is a copy pair with a P-VOL of which

is offline in the specified group.

Command details

261