Special Purpose Optional Parameters

The following parameters are not to be issued concurrently with the optional parameters described previously, or with each other, unless otherwise noted.

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.