Ykwatch Command - HP XP P9500 Reference Manual

Table 132 YKSUSPND Command Return Code List (continued)
Return Code
128

YKWATCH Command

Applies to Business Copy for Mainframe, Continuous Access Synchronous for Mainframe, Continuous
Access Synchronous for Mainframe with the HyperSwap attribute, and Continuous Access
Asynchronous for Mainframe.
Format
YKWATCH
PREFIX(prefix)
1
GROUP(copy-group-id)
1
GOTO({DUPLEX|SUSPEND|SIMPLEX})
1
TIMEOUT(timeout-value)
1
DAD(dad-id)
1
[ {USER({user-id|*})|OPERATOR(route-code)|CN({console-id|console-nameINTERNAL})}]
1
Function
This is a TSO/E command that is called from within an REXX script.
This command monitors the copy pair status transition for a specified copy group and sends a
notification message when all the copy pairs have been placed in a specified status.
Parameters
PREFIX(prefix) ~ <PREFIX string of 25 or fewer characters>
Specify the prefix of the configuration file name.
GROUP(copy-group-id) ~ <GROUP string>
Specify the string obtained by removing the prefix.GRP. portion from the copy group definition
file name.
Maximum length that can actually be specified is as follows
44 - (5 + PREFIX-length)
GOTO({DUPLEX|SUSPEND|SIMPLEX})
Specify the status of the copy group to be monitored. When all the copy pairs in the group change
to the specified status, the YKWATCH command terminates successfully.
DUPLEX
The command waits until all the copy pairs in the group reach the DUPLEX status. When any copy
pair takes a status other than PENDING or DUPLEX, however, the YKWATCH command terminates
abnormally with the return code 8.
256 CLI Commands
Meaning
When the copy pair corresponding to the device number specified with the
DEVN parameter is not found.
When the VOLUNIT parameter or DEVN parameter, and the PURGE parameter
are specified for a CAJ at the same time.
For a CAA, when an attempt to cancel the ATTIME suspend time for the remote
storage system was made.
The command terminated abnormally. The user does not have permission to execute
this command.