The PPRCCMD SETUP VOLUME command specifies PPRC primary and secondary volumes. In order for this command to complete successfully, a PPRC link must be active between the primary logical subsystem and the secondary logical subsystem.
When establishing a pair of devices, the primary and secondary volumes must have the same number of tracks on each cylinder and the same number of bytes on each track. The secondary device must have the same number or a greater number of cylinders as compared to the primary device.
This command has the following format:
PPRCCMD SETUP VOLUME DEVNUM(devid) VOLCNT(a number of consecutive volumes to be processed) PSERIAL(serial) PCCA(cca) PSSID(ssid) [PLSS(lss)] SSERIAL(serial) SCCA(cca) SSSID(ssid) [SLSS(lss)] [SUBCHSET(0|1)] [MODE(COPY|NOCOPY|INCRES|RESYNC)] [CRIT(YES,NO)] [ONLINSEC(YES,NO)]
Specifies the device number of the primary volume for the volume pair to be established. The device number is the four-digit hexadecimal address of the device to which the I/O operation is directed.
Specifies the number of consecutive primary volumes to be paired with the same number of secondary volumes within one logical subsystem.
Specifies the primary storage control serial number, which can include up to 12 digits, depending on the type of storage control.
Specifies the primary a two-digit channel connection address.
Specifies the primary site storage subsystem ID and it is a four-digit hexadecimal number.
(Optional) Specifies the primary site logical subsystem number and it is a two-digit hexadecimal number.
Specifies the secondary storage control serial number, which can include up to 12 digits, depending on the type of storage control.
Specifies the secondary a two-digit channel connection address.
Specifies the secondary site storage subsystem ID and it is a four-digit hexadecimal number.
(Optional) Specifies the secondary site logical subsystem number and it is a two-digit hexadecimal number.
(Optional) Specifies the subchannel set where the command is issued. The subchannel set where the I/O is issued is the subchannel set as defined in the Hardware Configuration Dialog (HCD). The values are:
(Default) Subchannel set 0.
Subchannel set 1.
(Optional) Specifies one of the following PPRC modes:
Specifies that PPRC copy all tracks on the primary volume to the secondary volume.
(Default) Specifies only those tracks on the primary volume that are updated after this command is issued are copied to the secondary volume. Specify this mode only if the volumes are exact copies of each other.
The NOCOPY option assumes that the specified volumes are fully synchronized at the time the copy is started. Ensure that no I/O operations occur to either volume before starting the copy operation.
Important! To protect the data integrity of the two volumes, use this option.
Limits the tracks to be copied by doing an incremental resynchronization using the change recording bitmaps.
Specifies that PPRC reestablish a suspended copy. Use this option only after verifying that either the primary and secondary volumes are both in a suspended state, or the secondary is in a simplex state and the primary is suspended. PPRC only copies from the primary volume to the secondary volume the cylinders that were updated during the period of suspension.
(Optional) Specifies whether PPRC allows subsequent write requests to the primary volume. The values are:
(Default) Specifies if an I/O completion error occurs that PPRC allows subsequent write requests to the PPRC primary volume. The primary storage control performs change recording.
Specifies if an I/O error occurs that PPRC either allows or does not allow subsequent writes, depending on how the storage subsystem is configured. The PPRC pair then remains in a suspended state until you correct the problem.
(Optional) Specifies whether the secondary volume is online to a host system. The values are:
(Default) Specifies if the secondary volume appears to be online to any host system, the SETUP VOLUME command fails with an error.
Specifies that the SETUP VOLUME command can be processed even if the secondary volume appears to be online to a host system.
The output stem variable record contains the following delimited fields:
|
Copyright © 2014 CA Technologies.
All rights reserved.
|
|