rmflash

Parameters

-dev storage_image_ID

(Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. This parameter is required if you do not specify a fully qualified ID for the source and target volumes and you do not specify a value for the devid variable in your profile file.

Example: IBM.1750-68FA120

-quiet

(Optional) Specifies that the confirmation prompt for this command be turned off.

-tgtonly

(Optional) Specifies the target volume of the FlashCopy pair to remove the relationship. In addition, the Copy Indicator for the target volume is reset.

Note: If you use the -tgtonly parameter on CKD volumes, any dataset level relationships created by a S/390 host are removed from the specified target volume.

-cp

(Optional) Specifies that the FlashCopy relationship be changed from No Copy to Copy and that the remaining source volume tracks be copied to the target volume. The relationship is removed when all the data is copied unless the relationship is persistent. When this parameter is specified, the copy takes place for all volume pairs where the source volume ID is identical to the source volume specified in the command.

-resettgtinhibit

(Optional) Specifies that the flag that does not allow host system write operations to the target ID while the FlashCopy relationship exists be reset, in case it was previously set.

Note: Specifying this parameter in itself does not cause the FlashCopy relationship to be withdrawn.

-wait

(Optional) Specifies that the command response be delayed until the background copy process completes.

Notes:

1. Only pairs of source and target volume IDs are allowed when you use the -wait parameter.
2. The -cp parameter must be used with the -wait parameter.
3. Do not use the -wait parameter on relationships that are marked -persist, an error occurs when this is done.

-seqnum flash_sequence_num

(Optional) Specifies the FlashCopy sequence number. When this number is specified, the rmflash operation is performed only on those relationships associated with the specified number.

Example: 0010

Note: This parameter is not supported for a 2105 machine type.

SourceVolumeID:TargetVolumeID . . . | -

(Required) Specifies the source and target volume pairs for which the FlashCopy relationships are removed. This parameter accepts a fully qualified volume ID, which includes storage image IDs, or a shortened version without storage image IDs if the -dev parameter is specified or you specify a value for the devid variable in your profile file. You must separate multiple FlashCopy pair IDs with spaces.

A FlashCopy pair ID consists of two volume IDs, one designated as the source and the other as the target volume for a FlashCopy relationship. You must separate the two volume IDs of a FlashCopy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume.

When the -tgtonly parameter is specified, you must enter volume IDs. Volume pair IDs are not valid with the -tgtonly parameter.

The volume ID is a 32 bit number that can be represented as 4 hexadecimal digits in the form of XYZZ where X is the address group (0 - 1), XY together is the logical subsystem number 00 - 1E (for 1750) , and ZZ is the volume number (00 - FF).

If you specify the dash (-), this parameter information is automatically supplied. However, you cannot use this feature if you are using the DS CLI interactive command mode.

Example of a fully qualified FlashCopy pair ID: IBM.1750-68FA120/0001:IBM.1750-68FA120/0004

Example of a shortened version: 0001:0004

Example of multiple pairs: 0001:0004 0003:00FF 0008:000C