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

Table 126 YKQRYPTH Command Return Code List (continued)
MeaningReturn Code
Command execution terminated because of an invalid parameter. Acquisition of
the status of all logical paths was not successful.
48
Command execution terminated because a dynamic change in an I/O configuration
definition was detected.
56
The command terminated abnormally. The user does not have permission to execute
this command.
128
YKQUERY 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, and Continuous Access Journal for Mainframe.
Format
YKQUERY
1
STEM(stem-name-1)
1
MSG(stem-name-2)
[
1
DEVN(device-number)]
[
1
TO({PRIMARY|SECONDARY})]|VERIFY}]
Function
This command is a TSO/E command called from REXX scripts.
This command displays the copy pair volume status for the specified copy group.
Parameters
STEM(stem-name-1) ~ <REXX prefix of 64 or fewer characters>
Specify the prefix of the name of the copy group structure that stores information about the copy
group whose copy pair status you want to display. Specify the same character string as the one
specified in the STEM parameter of the YKLOAD command that loaded the corresponding copy
group. 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.
DEVN(p-vol-device-number,s-vol-device-number) ~ <4-digit hexadecimal number, 4-digit
hexadecimal number>
Specify the device number of the copy pair (P-VOL and S-VOL) to operate.
Note that, for CG containers specified by EXCTG ID, the command checks the EXCTG registration
information for all CG containers.
After specifying the copy pair to operate, to view REXX variables (such as SimplexCt) shown in
information for copy pairs that are not operation targets, execute the YKQUERY command or
YKEWAIT command for all copy pairs.
TO({PRIMARY|SECONDARY})
Specify this parameter to acquire the copy pair information from either the P-VOL or the S-VOL at
the time the copy pair was defined. Note that the information you can acquire differs depending
232 CLI Commands