Optional parameters

OPENDVCS

Specifies whether Open System (fixed block) devices or CKD devices are addressed by this command. The values are:

NO: The required parameters (SDEVN and TDEVN) identify CKD devices. The default is NO.
YES: Specifies that SOURCE and TARGET parameters identify Open System (fixed block) devices using a CKD access device.

REMOTE

Specifies whether the request is for a subsystem that is not directly attached to the issuing processor. The values are:

NO

The request is directed to a device on a subsystem locally attached to the issuing processor. The default is NO.

YES

The request is directed to a remote subsystem using Inband subsystem functions. When REMOTE(YES) is specified, the request must be for a full volume.

When specifying an Inband request for a CKD secondary device, DEVN must identify a PPRC primary device in a subsystem accessible by the host processor issuing the request, and the device specified as the FlashCopy® source must also be the PPRC secondary for the DEVN device.

When specifying an Inband request for an open (fixed block) secondary device, DEVN must identify an online CKD System z® device located in the same subsystem cluster as the fixed block device serving as the primary of a PPRC pair where the secondary will be the FlashCopy source device.

Note: REMOTE(YES) is not valid when the EXTENTS or XTNTLST parameters are specified.

SSID

When REMOTE(YES) is specified without OPENDVCS(YES), this is the four-digit hexadecimal address identifying the storage subsystem where the remote FlashCopy is located. This must be the same value as that specified for SSID on the PPRC CESTPAIR command.

DDSW

Specifies whether you want the deleted data space withdraw (DDSW) function to be performed on the device that is specified with the SDEVN parameter. This parameter applies to devices that are enabled with FlashCopy V2.

One of the following values must be used with the DDSW parameter:

YES: Specifies to withdraw all eligible relationships on the device specified with the SDEVN parameter from their associated FlashCopy relationships. For additional information, see Using DDSW(YES). DDSW(YES) is not valid when OPENDVCS(YES) or REMOTE(YES) is specified.
NO: Specifies that withdraw processing be performed without deleted data space withdraw considerations. The default is NO. For additional information, see FlashCopy V2 withdraw options.

XTNTLST, or XXTNTLST

Apply to devices that are enabled with FlashCopy V2. The parameters are mutually exclusive, specifying that FlashCopy withdraw actions apply to the ranges of source and target extents that are specified within the list. The parameters are not valid when OPENDVCS(YES) or REMOTE(YES) is specified.

Each set of extents contains the following information:

The first and last track of a set of contiguous tracks on the source device
The first and last track of a set of contiguous tracks on the target device

XTNTLST

This parameter applies to devices that are enabled with FlashCopy V2. The parameter specifies that FlashCopy withdraw actions apply to the ranges of source and target extents that you specify within the list. XTNTLST is not valid when OPENDVCS(YES) or REMOTE(YES) is specified

Note: You can use XTNTLST only if both the source and target volumes are 65,520 cylinders or smaller (not an EAV).

c1h1: Specifies the cylinder and head number of the beginning source track of the range. These numbers can be specified without the 'X' designation. For example, you would enter cccchhhh where the first four digits represent the beginning cylinder number and the second four digits represent the beginning head number.
c2h2: Specifies the cylinder and head number of the ending source track of the range. These numbers can be specified without the 'X' designation. For example, you would enter cccchhhh where the first four digits represent the ending cylinder number and the second four digits represent the ending head number.
c1h1: Specifies the cylinder and head number of the beginning target track of the range. These numbers can be specified without the 'X' designation. For example, you would enter cccchhhh where the first four digits represent the beginning cylinder number and the second four digits represent the beginning head number.
c2h2: Specifies the cylinder and head number of the ending target track of the range. These numbers can be specified without the 'X' designation. For example, you would enter cccchhhh where the first four digits represent the ending cylinder number and the second four digits represent the ending head number.

The beginning tracks (source and target) in each extent set must be equal to, or lower than, the ending tracks (source and target) in each extent set. The total number of source tracks in each extent set must equal the total number of target tracks in each extent set.

If you do not specify the XTNTLST parameter, the FlashCopy FCWITHDR command defaults to processing all tracks of the specified device(s). For additional information about using this parameter, see Limiting the scope of a withdraw using the XTNTLST.

XXTNTLST

Note: You must use XXTNTLST if either or both the source and target volumes are >65,520 cylinders (EAV).

c1h1: Specifies the cylinder and head number of the beginning source track of the range. These numbers can be specified without the 'X' designation. For example, you would enter ccccccch where the first seven digits represent the beginning cylinder number and the last digit represents the beginning head number.
c2h2: Specifies the cylinder and head number of the ending source track of the range. These numbers can be specified without the 'X' designation. For example, you would enter ccccccch where the first seven digits represent the ending cylinder number and the last digit represents the ending head number.
c1h1: Specifies the cylinder and head number of the beginning target track of the range. These numbers can be specified without the 'X' designation. For example, you would enter ccccccch where the first seven digits represent the beginning cylinder number and the last digit represents the beginning head number.
c2h2: Specifies the cylinder and head number of the ending target track of the range. These numbers can be specified without the 'X' designation. For example, you would enter ccccccch where the first seven digits represent the ending cylinder number and the last digit represents the ending head number.

ACTION

An optional parameter that specifies special action to take during the FlashCopy withdraw processing. Valid values are:

THAW: Specifies that FlashCopy consistency group formation is complete and application I/O can now take place on all volumes in the LSS where the previous FlashCopy Establish request was issued with the ACTION FREEZE parameter.This option can only be specified with the DEVN parameter, not with SDEVN or TDEVN.
COMMIT: This specifies that the last consistency group created by the Global Mirror session is committed to the current state, and reverting to the previous consistency group state is no longer possible. See Moving a Global Mirror session to the recovery site in an unplanned outage for guidelines on the use of this option.
REVERT: Revert is a function to be used with Global Mirror or Metro/Global Mirror for ESS when recovering from an outage. It specifies a rollback to the state saved by a previous automatic FlashCopy establish command. The FlashCopy relationship is not removed (withdrawn), the FlashCopy target is rolled back to the previous consistency group created by the Global Mirror session. See Moving a Global Mirror session to the recovery site in an unplanned outage for guidelines on the use of this option.

TGTUCB(YES|NO)

Indicates whether an MVS device number is being used for target addressability.

YES: Indicates that the SDEVN and TDEVN keywords are being used to identify the source and target devices in the relationship using MVS device numbers. The default is YES.
NO: Indicates that an MVS device number will not be used for the target device (TDEVN keyword will not be used). Instead, the SDEVN and TARGET keyword will be used.
Specifying TGTUCB(NO) will be ignored when specified with REMOTE(YES) or OPENDVCS(YES). This is because these two types of requests already use the TARGET keyword instead of the TDEVN keyword and the system does not have direct addressability to the target volume in the relationship.
SUBCHSET: Specifies the subchannel set in which the command is to be issued. The subchannel set where the I/O will be issued is the subchannel set as defined in the Hardware Configuration Dialog (HCD). The valid values are determined by what is supported by the host system's processor and configured for the device.
If you omit the parameter, the command is issued to the device that is logically in subchannel set 0. If a swap has occurred, this could be the device that was defined in an alternate subchannel set in the I/O configuration (IODF), with HCD.
TSUBCHSET: Specifies which subchannel set is to be used to get information about the target device specified with the TDEVN parameter. This is the subchannel set for the device as defined in the Hardware Configuration Dialog (HCD). The values are determined by what is supported by the host system's processor and configured for the device.
If you omit the parameter, the device that is logically in subchannel set 0 will be used. If a swap has occurred, this could be the device that was defined in an alternate subchannel set in the I/O configuration (IODF), with HCD.