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

Function
This command is a TSO/E command called from REXX scripts.
This command dissolves a copy pair for the specified copy group and changes the volume status
to the SIMPLEX status.
When dissolving copy pairs in an EXCTG container, if all copy pairs are dissolved from a journal
group, that journal group will be deleted from the EXCTG. In addition, if all journal groups are
deleted from the EXCTG, the EXCTG data will be deleted.
If the copy pair to be dissolved is in the SIMPLEX status or any status that cannot be dissolved
because of the attributes in the copy group structure, the command creates an error message in
the message structure and returns a nonzero return code.
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 to be dissolved. 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 called.
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. If the CAJ ATTIME
suspend time has been set for the target copy group, execute the YKSUSPND command with the
CANCEL parameter specified to cancel the CAJ ATTIME suspend time before you execute the
YKDELETE command with the DEVN parameter specified.
SELECT({ALL|COND})
Specify the method used to select the copy pairs that are to be affected by this command. The
default is ALL.
ALL
All the copy pairs in the copy group are affected by the command. Note that if the DEVN parameter
is specified, the copy pair specified in the parameter becomes the execution target of the command.
COND
Only pairs with certain volume statuses are affected by the command. For details on the copy pairs
that are affected by the command, see the table regarding copy pair statuses that are affected by
commands in the P9000 for Business Continuity Manager.
Command details 197