HP P9000 Business Continuity Manager Reference Guide (T5253-96058, September 2011)

YKQRYDEV Command
Applies to Business Copy for Mainframe, Continuous Access Synchronous for Mainframe, Continuous
Access Synchronous for Mainframe with the HyperSwap attribute, Continuous Access Asynchronous
for Mainframe, Continuous Access Journal for Mainframe, and CMD.
Format
YKQRYDEV
1
STEM(stem-name-1)
{
1
SN(storage system-serial-number)
1
CU(cu-number)
1
CCA(cca-number)|
1
DEVN(device-number)}
1
MSG(stem-name-2)
[
1
PATH[
1
SSN(serial-number)
1
[SMODEL({USP|USPV|VSP})]]]
Function
This command is a TSO/E command called from REXX scripts.
Storage system information about the specified volume is obtained from the storage system, and
stored in the device information structure specified by the STEM parameter. For a copy pair, you
can specify this for either the P-VOL or the S-VOL.
If the specified volume is not found, or storage system information cannot be obtained due to an
I/O error, an error message is created in the message structure, and a nonzero return code is
returned.
Parameters
STEM(stem-name-1) ~ <REXX prefix of 64 or fewer characters>
Specify an optional prefix for the name of the device information structure in which the storage
system information is stored. You must also include a trailing period character.
SN(storage system-serial-number) ~ <from 5 to 12 alphanumeric characters>
Specify the serial number of the storage system to which the volume obtaining storage system
information belongs.
When this parameter is specified, the route list needs to be loaded before the command is executed.
CU(cu-number) ~ <2-digit hexadecimal number>
Specify the CU number of the volume for obtaining storage system information.
When this parameter is specified, the route list needs to be loaded before the command is executed.
CCA(cca-number) ~ <2-digit hexadecimal number>
Specify the CCA number of the volume for obtaining storage system information.
When this parameter is specified, the route list needs to be loaded before the command is executed.
DEVN(device-number) ~ <4-digit hexadecimal number>
Specify the device number of the volume for obtaining storage system information.
This parameter can only be specified for locally connected devices. It cannot be specified for Non
Gen'ed volumes.
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.
Command details 227