Ykquery Command; Ykquery Command - HP XP P9500 Reference Manual

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
STEM(stem-name-1)
1
MSG(stem-name-2)
1
[ DEVN(device-number)]
1
[ TO({PRIMARY|SECONDARY})]|VERIFY}]
1
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
on the copy direction of the copy pair and the specified parameters. For the information that you
can acquire, see
Specified" (page
PRIMARY
The information is acquired from the P-VOL at the time the copy pair was defined.
SECONDARY
The information is acquired from the S-VOL at the time the copy pair was defined.
232 CLI Commands
"REXX Variables Updated by YKQUERY Command with the TO Parameter
346).