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

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

FROMVSN, TOVSN, ARRAYS, volser, stem-name-2

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

Page 246 highlights

The range from the FROM parameter to the TO parameter is scanned in hexadecimal ascending order. FROMVSN(volser) ~ Specify the volume serial number of the first volume to be scanned. This parameter and the FROM and TO parameters are mutually exclusive. TOVSN(volser) ~ Specify the volume serial number of the last volume to be scanned. This parameter and the FROM and TO parameters are mutually exclusive. The range from the FROMVSN parameter to the TOVSN parameter is scanned in EBCDIC order. MSG(stem-name-2) ~ 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. ARRAYS(stem-name-3) ~ Specify an optional prefix for the name of the Host-Discovered Array Index structure. You must also include a trailing period character. The YKSCAN command returns the number of storage systems 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 functions or information such as the Software Keys or microcode number is changed, storage system information should be obtained again by using the YKSCAN command. In this case, at least one volume is scanned once, and storage system information can be obtained. • The alias volume (PAV-Alias) bound to a parallel access volume (PAV) is not scanned. Return Codes Table 132 (page 246) lists the return codes to be returned when the YKSCAN command terminates. Table 132 YKSCAN 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. The REXX variable corresponding to the scanned volume is created. 246 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

The range from the

FROM

parameter to the

parameter is scanned in hexadecimal ascending

order.

FROMVSN(

volser

)

~ <from 1 to 6 alphanumeric characters>

Specify the volume serial number of the first volume to be scanned.

This parameter and the

FROM

and

parameters are mutually exclusive.

TOVSN(

volser

)

~ <from 1 to 6 alphanumeric characters>

Specify the volume serial number of the last volume to be scanned.

This parameter and the

FROM

and

parameters are mutually exclusive.

The range from the

FROMVSN

parameter to the

TOVSN

parameter is scanned in EBCDIC order.

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.

ARRAYS(

stem-name-3

)

~ <REXX prefix of 64 or fewer characters>

Specify an optional prefix for the name of the Host-Discovered Array Index structure. You must

also include a trailing period character.

The

YKSCAN

command returns the number of storage systems detected to

stem-name-specified-in-ARRAYS-parameter

, and returns the information about the

th detected

storage system to the corresponding REXX variable (the REXX variable with the name formed by

appending

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 functions or information such as the Software Keys or microcode number is

changed, storage system information should be obtained again by using the

YKSCAN

command.

In this case, at least one volume is scanned once, and storage system information can be

obtained.

•

The alias volume (PAV-Alias) bound to a parallel access volume (PAV) is not scanned.

Return Codes

Table 132 (page 246)

lists the return codes to be returned when the

YKSCAN

command terminates.

Table 132 YKSCAN Command Return 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. The REXX variable corresponding to the scanned

volume is created.

246

CLI Commands