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

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

YKQRYPTH Command

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

Page 232 highlights

YKQRYPTH Command Applies to PTH. Format YKQRYPTH 1STEM(stem-name-1) 1MSG(stem-name-2) [ 1PSN(storage system-serial-number)[ 1PCU(cu-number)] [ 1SSN(storage system-serial-number)[ 1SCU(cu-number)] [ 1{FORWARD|REVERSE}] [ 1RESTRUCT] [ 1TYPE({CU|DKC})] Function This command is a TSO/E command called from REXX scripts. This command acquires the status of all physical paths allocated to all or some of the logical paths identified in the path set that is stored in the path set structure with the prefix specified by the STEM parameter. Parameters STEM(stem-name-1) ~ Specify the prefix of the name of the path set structure that stores information about the logical path whose status you want to obtain. Specify the same character string as the one specified in the STEM parameter of the YKLOAD command that loaded the corresponding logical path. You must also include a trailing period character. 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. PSN(storage system-serial-number) ~ If this parameter is specified, for each logical path within the path set stored in the path set structure specified for the STEM parameter, inter-CU logical paths will be acquired in all cases where the paths treat CUs within storage systems (that have the serial number specified by this parameter) as MCUs, and inter-DKC logical paths will be acquired in all cases where the paths treat the storage system (that has the serial number specified by this parameter) as the primary storage system. If neither this parameter nor any other parameters are specified, the command obtains the status of all logical paths. PCU(cu-number) ~ If this parameter is specified, out of the logical paths within the path set stored in the path set structure specified for the STEM parameter, inter-CU logical paths will be acquired in all cases where the CU number of the MCU matches the value specified for this parameter. Inter-DKC logical paths are not affected by this parameter. If neither this parameter nor any other parameters are specified, the command acquires all inter-CU logical paths. 232 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

YKQRYPTH Command

Applies to PTH.

Format

YKQRYPTH

STEM(

stem-name-1

)

MSG(

stem-name-2

)

[

PSN(

storage system-serial-number

)[

PCU(

cu-number

)]

[

SSN(

storage system-serial-number

)[

SCU(

cu-number

)]

[

{FORWARD|REVERSE}]

[

RESTRUCT]

[

TYPE({CU|DKC})]

Function

This command is a TSO/E command called from REXX scripts.

This command acquires the status of all physical paths allocated to all or some of the logical paths

identified in the path set that is stored in the path set structure with the prefix specified by the

STEM

parameter.

Parameters

STEM(

stem-name-1

)

~ <REXX prefix of 64 or fewer characters>

Specify the prefix of the name of the path set structure that stores information about the logical

path whose status you want to obtain. Specify the same character string as the one specified in

the

STEM

parameter of the

YKLOAD

command that loaded the corresponding logical path. You

must also include a trailing period character.

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.

PSN(

storage system-serial-number

)

~ <from 5 to 12 alphanumeric characters>

If this parameter is specified, for each logical path within the path set stored in the path set structure

specified for the

STEM

parameter, inter-CU logical paths will be acquired in all cases where the

paths treat CUs within storage systems (that have the serial number specified by this parameter)

as MCUs, and inter-DKC logical paths will be acquired in all cases where the paths treat the storage

system (that has the serial number specified by this parameter) as the primary storage system.

If neither this parameter nor any other parameters are specified, the command obtains the status

of all logical paths.

PCU(

cu-number

)

~ <2-digit hexadecimal number>

If this parameter is specified, out of the logical paths within the path set stored in the path set

structure specified for the

STEM

parameter, inter-CU logical paths will be acquired in all cases

where the CU number of the MCU matches the value specified for this parameter. Inter-DKC logical

paths are not affected by this parameter.

If neither this parameter nor any other parameters are specified, the command acquires all inter-CU

logical paths.

232

CLI Commands