The rmpprc command removes a Remote Mirror and Copy volume pair relationship. Or, this command can be used to remove a single volume ID (which might be useful when a disaster occurs and you want to specify only the available volume and not both the primary and secondary). To use with a single volume, you must specify either the -at src parameter option or the -at tgt parameter option. If neither of these options are specified in the command, single volumes are not valid. The -unconditional parameter must be specified when you designate a single volume; otherwise an error occurs and the command process fails.
>>-rmpprc--+-------------------------+--------------------------> '- -dev--storage_image_ID-' >--+-------------------------------+--+-------------------+-----> '- -remotedev--storage_image_ID-' '- -at--src--|--tgt-' >--+-----------------+--+---------+--+----------------+---------> '- -unconditional-' '- -quiet-' '- -srcss--ss_ID-' >--+----------------+-------------------------------------------> '- -tgtss--ss_ID-' >--+-SourceVolumeID:TargetVolumeID--+-------+-+---------------->< | '-. . .-' | '-" - "------------------------------------'
Parameters
Notes:
- When you specify subsystem IDs, the source and target volumes are restricted to 1 LSS for the source and 1 LSS for the target.
- If there is a communication problem between the primary server
and the secondary server (2-site configuration) when the rmpprc command
is issued, the following actions occur:
- Error message CMUN03012E is issued. This error message indicates that there was a communication problem between the primary and secondary server and that the transaction has failed. However, a partial removal of the pair relationship has occurred.
- The pair relationship is ended on either the primary volumes or the secondary volumes and the volumes that had the relationship removed enter a simplex state.
If this circumstance has occurred, reissue the rmpprc command for each volume that did not have its pair relationship removed. This transaction involves using the -at src or -at tgt parameter and the -unconditional parameter.
The following represents the format of the rmpprc command when you must remove a partial pair relationship:- If the source volume has not been removed from the pair relationship,
enter the rmpprc command at the dscli command prompt with the following
parameters and variables:
dscli>rmpprc -dev storage_image_ID -at src -unconditional SourceVolumeID
- If the target volume has not been removed from the pair relationship,
enter the rmpprc command at the dscli command prompt with the following
parameters and variables:
dscli>rmpprc -dev storage_image_ID -at tgt -unconditional TargetVolumeID
The value of the storage image ID must be the secondary server.
The management console must be able to communicate with the secondary server for this command to process successfully.
- If a disaster occurs involving a 3-site configuration, the rmpprc command with the -at tgt and -unconditional parameters are used in the recovery process.
- -dev storage_image_ID
- (Optional). Specifies the source storage image ID, which includes manufacturer, machine type, and serial number. This parameter is required if you do not specify a fully qualified source volume ID or you do not specify a value for the devid variable in your profile file.
- -remotedev storage_image_ID
- (Optional most times, however required as noted). Specifies the target storage image ID, which includes manufacturer, machine type, and serial number.
- -at src | tgt
- (Optional).
- src
- Select the -at src parameter option to initiate a break action from the source volume. After the task successfully runs, the source and target volumes are in the simplex state.
- tgt
- Select the -at tgt parameter option to initiate a break action from the target volume. After the command successfully runs, the target volume is in the simplex state, but there is no guarantee that the source volume state will change. For a break action issued to the target, the source can remain in the suspend state.
- -unconditional
- (Optional). Use this parameter to indicate that a source or target volume has been selected individually, and not as a pair. The -unconditional parameter is valid only if the -at parameter is selected. When you specify this parameter, you can specify only the source volume ID if the -at src parameter is selected, or specify only the target volume ID if the -at tgt parameter is selected. Do not use volume pair IDs.
- -quiet
- (Optional). Specifies that the confirmation prompt for this command be turned off.
- -srcss ss_ID
- (Optional). Specifies the subsystem ID of the primary logical subsystem in the format '0x0001 - 0xFFFF'.
- -tgtss ss_ID
- (Optional). Specifies the subsystem ID of the secondary logical subsystem in the format '0x0001 - 0xFFFF'.
- SourceVolumeID:TargetVolumeID . . . | -
- (Required). Specifies the Remote Mirror and Copy volume relationship for
the source and target volume pairs with the IDs specified that is to be removed. Note: Provide a single volume ID instead of a volume pair if you use the -unconditional parameter. Specifying pairs will result in a format error.
Example (1750)
Invoking
the rmpprc command
dscli>rmpprc -dev IBM.1750-68FA120 -remotedev IBM.1750-68FA150 0100:0100
The resulting output
Date/Time: Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 DS: IBM.1750-68FA120 Are you sure you want to delete the Remote Mirror and Copy volume pair relationship 0100:0100? [y/n]: Y Remote Mirror and Copy pair IBM.1750-68FA120/0100:0100 successfully removed.