FCWITHDRAW (FlashCopy withdraw)

Use request type FCWITHDRAW to end a FlashCopy® relationship. This invokes ANTRQST ILK=ESSRVCS REQUEST=FCWITHDRAW.

SDEVN(sdevn)

Specifies the hexadecimal device number of a local CKD device that is the source of the relationship or relationships being withdrawn. SDEVN is mutually exclusive with REMOTE(YES) and OPENDVCS(YES).

TDEVN(tdevn)

Specifies hexadecimal device number of a local CKD device that is the target of the relationship or relationships being withdrawn. TDEVN is mutually exclusive with REMOTE(YES) and OPENDVCS(YES).

DEVN(devn)

Specifies the hexadecimal device number of a local CKD device that will be used as an access for an inband request (with REMOTE(YES) or fixed block request (with OPENDVCS(YES)).

If you use OPENDVCS(YES) without REMOTE(YES), DEVN must specify a CKD access volume located in the same subsystem cluster as the fixed block device identified by SOURCE in this command.

If you use OPENDVCS(YES) with REMOTE(YES), DEVN must specify a CKD access volume located in the same subsystem cluster as the PPRC primary device that is paired with the PPRC secondary specified as the FlashCopy source.

If you use REMOTE(YES) without OPENDVCS(YES), DEVN must specify the PPRC primary device that is paired with the PPRC secondary specified as the FlashCopy source.

SRCSERIAL(srcserial)

Specifies the 10-digit hexadecimal storage control serial number for the FlashCopy source. SRCSERIAL is required when DEVN is specified.

SRCLSS(srclss)

Specifies the 2-digit hexadecimal logical subsystem number for the FlashCopy source. SRCLSS is required when DEVN is specified.

SRCDVC(srcdvc)

Specifies the 2-digit hexadecimal value for the FlashCopy source device, either the connection address or the logical unit number. SRCDVC is required when DEVN is specified.

SRCSSID(srcssid)

When REMOTE(YES) is specified without OPENDVCS(YES), this specifies the 4-digit hexadecimal value for the subsystem where the FlashCopy is to be withdrawn. This must be the same value as that specified for SSID on the PPRC secondary volume on the PPRC establish pair command.

TGTSERIAL(tgtserial)

Specifies the 10-digit hexadecimal storage control serial number for the FlashCopy target. TGTSERIAL is required when either DEVN or TGTUCB(NO) is specified.

TGTLSS(tgtlss)

Specifies the 2-digit hexadecimal logical subsystem number for the FlashCopy target. TGTLSS is required when either DEVN or TGTUCB(NO) is specified.

TGTDVC(tgtdvc)

Specifies the 2-digit hexadecimal value for the FlashCopy target device, either the connection address or the logical unit number. TGTDVC is required when either DEVN or TGTUCB(NO) is specified.

SRCEXTNA()

Indicates that all tracks of the source device are to be withdrawn (this is a full volume request). Either SRCEXTNA or SRCEXTN is required with SDEVN. SRCEXTNA is mutually exclusive with SRCEXTN.

This corresponds to the ANTRQST keyword SRCEXTENTS with a value of ALL.

SRCEXTN(srcextent,srcextent,srcextent,srcextent)

Indicates track address ranges on the source CKD volume that are to be withdrawn. Each extent range consists of a starting track address and an ending track address. The tracks identified in the source extent fields must be valid for the source device.

Either SRCEXTNA or SRCEXTN is required with SDEVN. SRCEXTN is mutually exclusive with SRCEXTNA.

Supply the value for SRCEXTN in SUPERZAP format, with a comma between every 4 digits. For example, to copy source tracks 01110002 through 011100C, you would use SRCEXTN(0111,0002,0111,000C). To supply multiple source extent ranges, specify each range with a separate keyword. For instance, to copy source tracks 01110002 through 0111000C as well as tracks 02220003 through 0222000D, you would use this:

SRCEXTN(0111,0002,0111,000C)
SRCEXTN(0222,0003,0222,000D)

instead of this:

SRCEXTN(0111,0002,0111,000C,0222,0003,0222,000D)

You can supply up to 40 extent ranges on a single FCWITHDRAW request.

This corresponds to the ANTRQST keyword SRCEXTENTS.

TGTEXTNA()

Indicates that all tracks of the target device are to be withdrawn (this is a full volume request). Either TGTEXTNA or TGTEXTN is required with SDEVN. TGTEXTNA is mutually exclusive with TGTEXTN.

This corresponds to the ANTRQST keyword TGTEXTENTS with a value of ALL.

TGTEXTN(nnnn,nnnn,nnnn,nnnn)

Indicates track address ranges on the target CKD volume that is active in this FlashCopy relationship. Each extent range consists of a starting track address and an ending track address. The tracks identified in the target extent fields must be valid for the target device.

Either TGTEXTNA or TGTEXTN is required when TDEVN is specified. TGTEXTN is mutually exclusive with TGTEXTNA

Supply the value for TGTEXTN in SUPERZAP format, with a comma between every 4 digits. For example, to copy to target tracks 01110002 through 011100C, you would use TGTEXTN(0111,0002,0111,000C). To supply multiple source extent ranges, specify each range as a separate keyword. For instance, to copy to tracks 01110002 through 011100C as well as to tracks 02220003 through 0222000D, you would use this:

TGTEXTN(0111,0002,0111,000C)
SRCEXTN(0222,0003,0222,000D)

instead of this:

TGTEXTN(0111,0002,0111,000C,0222,0003,0222,000D)

You can supply up to 40 extent ranges on a single FCWITHDRAW request.

This corresponds to the ANTRQST keyword TGTEXTENTS with a value of ALL.

OPENDVCS(NO | YES)

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

NO

The required parameters (SDEVN and TDEVN) identify CKD devices. This is the default.

YES

The required parameters (DEVN, SRCSERIAL, SRCLSS, SRCSSID, SRCDVC, TGTSERIAL, TGTLSS, TGTDVC) identify fixed block devices using a CKD access device.

REMOTE(NO | YES)

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

NO

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

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 FlashCopy source device must be the PPRC secondary of that DEVN.

When specifying an inband request for an Open System (fixed block) secondary device, DEVN must identify an online CKD device located in the same subsystem cluster as the fixed block device of the PPRC primary that is paired with the PPRC secondary that is designated as the FlashCopy source.

SPACEREL(NO | YES)

Specifies whether the physical space associated with a space efficient volume or a space efficient target is to be released.

NO

The space is not to be released if the volume is space efficient or the target is space efficient. This is the default.

YES

The space associated with the target volume, if it is space efficient, is to be released when the withdraw is complete.

Note:

1. If YES is specified and the target is not a space efficient volume, the SPACEREL keyword is ignored. The results of the command causes the space efficient volume to become uninitialized and therefore unusable by the system until the volume is re-initialized.
2. If the request with SPACEREL(YES) is issued to a simplex volume that is a space efficient volume, any physical space for the volume is released.
3. The allocated space is released asynchronously so may not be reported immediately.

ACTION(COMMIT | REVERT | THAW)

Specifies an action to take. There is no default. If ACTION is specified, any extent specifications are ignored.

COMMIT

The last consistency group created by the Global Mirror session is committed to the target’s current state, and reverting to the previous consistency group state is no longer possible.

REVERT

A rollback is performed 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.

THAW

A FlashCopy consistency group has been formed 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 parameter specified as FREEZE. The DEVN parameter must be specified when ACTION(THAW) is specified. SDEVN and TDEVN cannot be used.

DDSW(NO | YES)

Specifies if the deleted dataspace withdraw function (DDSW) is requested. The DDSW function causes two actions. First, within the specified source extents, all FlashCopy target tracks are immediately withdrawn from their FlashCopy relationship. Second, all FlashCopy source tracks in a NOCOPY relationship are changed to a COPY (background copy) relationship. DDSW(YES) requires the source device, SDEVN, to be specified. If DDSW(YES) is specified, the target device parameters, TDEVN and target extent specifications, are ignored.

NO

The DDSW function is not requested. This is the default.

YES

Background copy is started for all source tracks within the extents specified and any target relationships are immediately withdrawn.

TGTUCB(YES | NO)

Specifies whether an MVS device number is used to address the target.

YES

The SDEVN and TDEVN keywords are used to identify the source and target devices in the relationship. The MVS device numbers are used in the SDEVN and TDEVN keywords to address the source and target devices. This is the default.

NO

The MVS device number is specified in the SDEVN keyword to identify the source. The serial number, LSS, and CCA are specified in the TGTSERIAL, TGTLSS, and TGTDVC keywords to address the target device.

TGTUCB(NO) is not applicable with OPENDVCS(YES) or REMOTE(YES).

WAITTIME(waittime | 0)

Specifies how long in seconds SDM will wait for a request to complete. A value of zero specifies that the request should not be timed.

If the time expires before the request is complete, the program returns a return code of 7039 (RQST_WAITTIME_EXPIRED). For more information about RQST_WAITTIME_EXPIRED, refer to the ANTRQSTL macro.

SUBCHSET(subchset | 0)

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(tsubchset | 0)

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 currently supported by the host system's processor and configured for the device.

If you omit the parameter, the device that is currently 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), via HCD.