Table 1 16 YKFREEZE Command Return Code List (continued)
Return Code
48
128
YKH2B Command
Applies to Continuous Access Synchronous for Mainframe with the HyperSwap attribute.
Format
YKH2B
PREFIX(prefix)
1
DEVN(device-number-1,device-number-2)
1
DAD(dad-id)
1
CGNAME(name-of-TruCopy-copy-group-with-HyperSwap-attribute)
1
[
HS({CHECK|NOCHECK})]
1
Function
This is a TSO/E command.
This command scans the P-VOLs of PPRC copy pairs within the specified range. It then creates a
copy group definition file by defining copy pairs that consist of the detected P-VOLs and S-VOLs
(CA copy pairs that have the HyperSwap attribute of Business Continuity Manager).
Before executing this command, you must use Business Continuity Manager to create a disk
configuration definition file for the storage system to scan. If the disk configuration definition file
does not contain any P-VOLs in the detected PPRC copy pairs or S-VOLs corresponding to the
P-VOLs, copy pairs are still defined. If this occurs, a warning message is issued.
A copy group definition file is created as follows:
For a CA copy group with the HyperSwap attribute: A single copy group definition file is
created for all detected copy pairs.
Parameters
PREFIX(prefix) ~ <prefix of 25 or fewer characters>
Specify the prefix of a disk configuration definition file that has already been created by Business
Continuity Manager and of the copy group definition file to be created. When using a copy group
definition file created using the YKH2B command on the ISPF panel, the maximum length of the
prefix that can be specified is 16 characters.
DEVN(device-number- 1 , device-number-2) ~ <4-digit hexadecimal number>
Specify the first and last device numbers for the range for searching for copy pairs. For
device-number- 1 , specify the starting DEVN for the search range. For device-number-2, specify the
ending DEVN for the search range. For example, if 7000 and 7300 are specified for
device-number- 1 and device-number-2 respectively, copy pairs are searched in the volumes whose
DEVN is from 7000 to 7300, including the two end values.
If device-number-2 is smaller than device-number- 1 , device-number-2 is treated as the starting DEVN
of the scan range and device-number- 1 is treated as the ending DEVN of the scan range.
DAD(dad-id) ~ <DAD string>
The maximum length of the specification must be 44 - (13 + PREFIX-length).
Meaning
Terminating due to invalid parameters.
The command terminated abnormally. The user does not have permission to execute
this command.
Command details
217