Special Purpose Optional Parameters
- DISCARDPINNED|DESTAGE|REINITIALIZE|SETSECONDARY(devid)|
- SUSPENDPRIMARY|SUSPENDSECONDARY|RESETTODUPLEX|
- REESTABLISHDUPLEX(devid)|RESETTOSIMPLEX
specifies operations pertaining to dual copy.
- DISCARDPINNED
- specifies that all pinned cache fast write data and DASD fast
write data for the specified volume is discarded. Abbreviation: DPIN.Note: DISCARDPINNED can be issued to an offline device by using the UNITNUMBER parameter.
- DESTAGE
- specifies that a destage to DASD of all modified tracks in the
cache and NVS is to be scheduled.
Abbreviation: DESTG
- REINITIALIZE
- causes a cached Storage Control subsystem to unconditionally establish
or reestablish all caching status on the subsystem status devices.
(This is a reconfiguration of the subsystem, setting all caching status
to its default values.) REINITIALIZE requires the use of the UNITNUMBER
parameter, because all devices must be offline before the command
is executed. REINITIALIZE also resets all CCAs and DDCs to the initial
installation values (direct translation).
Abbreviation: RINIT or REINIT
Note:- The REINITIALIZE parameter terminates dual copy logical volumes (duplex pairs).
- Ensure that other operating systems are not accessing the target subsystem before using the REINITIALIZE command.
- The REINITIALIZE parameter causes pinned data to be lost.
- SETSECONDARY(devid)
- specifies that a dual copy (duplex) pair is to be established.
The secondary volume must be offline and is identified by its devid (devid is
the MVS™ device number). DASD
fast write and caching status of the primary volume are maintained
for the duplex pair.
Abbreviation: SSEC
Note:- This parameter is not supported for the ESS.
- With this parameter, the JCL JOB statement should include 'TIME=1440'.
- This parameter may be used in conjunction with COPY (with or without PACE) or NOCOPY.
- During the process of establishing a duplex pair, caching for the primary volume is temporarily deactivated.
- When you use dual copy to migrate from 3390 devices to RAMAC devices, an invalid format 4 DSCB is created on the target device. Use ICKDSF to fix the format 4 DSCB. See your IBM® representative for the latest service level of ICKDSF that provides this function.
Device level caching, for both primary and secondary devices, is set to off to force data destaging. It is set back to on, automatically by software, after the dual copy operation completes.
The software can be overridden by IDCAMS allowing cache to be set on after the establishment of a duplex pair has been initiated (verify with a DEVSERV command that status is pending for primary device before setting device cache to on).
- SUSPENDPRIMARY
- suspends the primary volume of a duplex pair. The subsystem swaps
the primary and secondary volumes of the duplex pair. The suspended
device is the secondary address. DASD fast write status and caching
status are maintained.
Abbreviation: SUSPRI or SPPRI
Note: This parameter is not supported for the ESS. - SUSPENDSECONDARY
- suspends the secondary volume of a duplex pair. DASD fast write
status and caching status are maintained.
Abbreviation: SUSSEC or SPSEC
Note: This parameter is not supported for the ESS. - RESETTODUPLEX
- establishes a duplex pair from a suspended duplex pair. The subsystem
always attempts to match channel connection addresses (CCAs) and director-to-device
connection (DDC) addresses, and swaps the devices after synchronization
if a swap would result in a match. If the pair is swapped, all data
in the cache is invalidated. DASD fast write status and caching status
are maintained.
Abbreviation: RESETDUP or REDUP
Note:- This parameter is not supported for the ESS.
- With this parameter, the JCL JOB statement should include 'TIME=1440'.
- COPY and PACE can be used in conjunction with this parameter.
- REESTABLISHDUPLEX(devid)
- reestablishes a duplex pair from the primary volume in a suspended
duplex pair and the user-specified alternate device. DASD fast write
status and caching status are maintained. Abbreviation: REEST Note:
- This parameter is not supported for the ESS.
- With this parameter, the JCL JOB statement should include 'TIME=1440'.
- COPY and PACE can be used in conjunction with this parameter.
- RESETTOSIMPLEX
- terminates a duplex pair. When the volumes are changed from a
duplex pair to simplex volumes, the old primary volume retains the
DASD fast write and the device caching status of the duplex pair.
For the old secondary volume, DASD fast write becomes inactive and
device caching becomes active (reverts to default status). Abbreviation: RESETSIM
or RESIM Note:
- This parameter is not supported for the ESS.
- RESETTOSIMPLEX can be issued to an offline device by using the UNITNUMBER parameter.
- COPY|NOCOPY
- specifies whether or not the Storage Control is to copy the primary
volume onto the secondary volume when establishing a duplex pair (used
only with the SETSECONDARY parameter).
- COPY
- specifies that the Storage Control is to copy the primary volume
onto the secondary when establishing a duplex pair (SETSECONDARY).
(Copy can be used with the RESETTODUPLEX and the REESTABLISHDUPLEX
parameters.) Note: Specify the COPY parameter, except for pairs of primary and secondary volumes that have just been initialized by ICKDSF using the same initialization parameters.
- NOCOPY
- specifies that the primary and secondary volumes are identical
and the Storage Control does not need to copy the primary volume onto
the secondary to establish the duplex pair (used only with SETSECONDARY;
cannot be used with REESTABLISHDUPLEX or RESETTODUPLEX). Note:
- The subsystem keeps an indication that the duplex pair was established using an internal copy. If an error results because the two volumes are not identical, this indicator is checked. The message given as a result of the out-of-synchronization condition indicates if an internal copy was done or that the out-of-synchronization condition is caused by a probable user error.
- Specify only the NOCOPY parameter when both the primary and secondary volumes have been initialized with ICKDSF, using the same initialization parameters, and contain no application data.
- Just as the parameter name suggests, nothing is copied from the primary to the secondary.
- PACE(n)
- specifies the number of tracks from 1 to 255 that are to be copied
without interruption during the Storage Control copy operation to
establish a duplex pair (SETSECONDARY); to establish a duplex pair
from a suspended duplex pair (RESETTODUPLEX); or to reestablish a
duplex pair from the primary of a suspended pair and a user-specified
alternate (REESTABLISHDUPLEX).
Specifying PACE(0) defines an uninterruptible (dedicated) copy operation. Specifying PACE(1) to PACE (255) defines the number of tracks to copy before releasing the device for any outstanding device activity (when there is no more activity, the copy of the next n tracks resumes). The default is 15 tracks.
Note: Specify PACE(1) or (2) for optimum device availability. Using PACE(0) or a large PACE value may lock out other activity to the volume for a long time.