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

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

YKDELCMD Command, Table 104 YKCONMSG Command Return Code List

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

Page 194 highlights

NOTE: • In some configurations such as when BC and CA share volumes or a 1 to n (n is greater than 1) configuration of BC, the status transitions of each copy pair might not be correctly monitored. • When using a copy pair on a remote site (a site that is not channel-connected directly from the local host), there are the following restrictions: ◦ Even if a copy pair status changes, the IEA494I message is not displayed on the MVS console. Thus, the YKCONMSG command cannot monitor status transitions of a copy pair on a remote site. ◦ The IOSHM0414I message or user-specified messages are not displayed on the MVS console even when a HyperSwap is completed. 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 194) lists the return codes to be returned when the YKCONMSG command terminates. Table 104 YKCONMSG Command Return Code List Return Code -3 Meaning The module cannot be loaded. Possible causes are as follows: • The library dataset has not been linked. • APF grant has not been registered. • The module is protected by the RACF program control function. -1 An interruption occurred during execution. 0 Open processing terminated normally. 1 Message specified by the MSGID parameter was returned (IEA494I message if the MSGID parameter was omitted). 2 Although the system waited for the number of seconds specified for the TIMEOUT parameter, no message was found. 4 Message lost since previous invocation. 6 Close successful. 8 Invalid parameter. 9 System error. YKDELCMD Command Applies to CMD. Format YKDELCMD { 1SN(storage system-serial-number)| 1SN(storage system-serial-number) 1CU(cu-number) 1CCA(cca-number) 1APID(apid)| 1DEVN(device-number) 1APID(apid)} 1MSG(stem-name-1) 194 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	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

NOTE:

•

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

(

is greater than

1) 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), there are the following restrictions:

◦

Even if a copy pair status changes, the

IEA494I

message is not displayed on the MVS

console. Thus, the

YKCONMSG

command cannot monitor status transitions of a copy pair

on a remote site.

◦

The

IOSHM0414I

message or user-specified messages are not displayed on the MVS

console even when a HyperSwap is completed. 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 194)

lists the return codes to be returned when the

YKCONMSG

command terminates.

Table 104 YKCONMSG Command Return Code List

Meaning

Return Code

The module cannot be loaded. Possible causes are as follows:

-3

•

The library dataset has not been linked.

•

APF grant has not been registered.

•

The module is protected by the RACF program control function.

An interruption occurred during execution.

-1

Open processing terminated normally.

Message specified by the

MSGID

parameter was returned (

IEA494I

message if

the

MSGID

parameter was omitted).

Although the system waited for the number of seconds specified for the

TIMEOUT

parameter, no message was found.

Message lost since previous invocation.

Close successful.

Invalid parameter.

System error.

YKDELCMD Command

Applies to CMD.

Format

YKDELCMD

{

SN(

storage system-serial-number

SN(

storage system-serial-number

)

CU(

cu-number

)

CCA(

cca-number

)

APID(

apid

DEVN(

device-number

)

APID(

apid

)}

MSG(

stem-name-1

)

194

CLI Commands