Ykwtomsg Command - HP XP P9500 Reference Manual

NOTE:
In some configurations such as when CA and BC share volumes or a 1 to n (n is greater than
2) configuration of BC, the status transitions of each copy pair might not be correctly monitored.
When using a copy pair on a remote site (a site that is not channel-connected directly from
the local host), the YKWATCH command cannot monitor the status transition of the copy pair
on the remote site. Use the YKEWAIT command.
When using a CAJ copy pair, the YKWATCH command cannot monitor the status transition of
the CAJ copy pair. Use the YKEWAIT command.
Execute the YKWATCH command when device numbers are assigned for P-VOLs of all copy
pairs in the copy group specified in the GROUP parameter, and the P-VOLs are online.
You cannot specify a console ID for the CN operand when the OS being used is z/OS V1R8
or later.
Specify INTERNAL for the CN operand only when the OS being used is z/OS V1R9 or later.
The YKWATCH command cannot monitor Non Gen'ed volumes.
The YKWATCH command cannot monitor the transition to the CONSLOST status. Use the
YKEWAIT command.
Return Codes
Table 133 (page 258)
Table 133 YKWATCH Command Return Code List
Return Code
0
4
8
12
44
48

YKWTOMSG Command

Format
When outputting a single line message
YKWTOMSG(type,text)
When outputting a multiline message
YKWTOMSG(type,
text-1,
text-2
[,text-3]
[,text-4]
[,text-5]
[,text-6]
[,text-7]
[,text-8]
[,text-9]
[,text-10])
258 CLI Commands
lists the return codes to be returned when the YKWATCH command terminates.
Meaning
The command completed normally.
A timeout or interrupt occurred before the volume status changes to the requested
volume status.
A copy pair or copy pairs in the specified group are placed in the status from which
the required status is not reachable.
Cannot make status transition because there is a copy pair with a P-VOL of which
is offline in the specified group.
Terminating due to invalid processing.
Terminating due to invalid parameters.