rmgmir

The rmgmir command ends Global Mirror processing for the specified session.


>>-rmgmir--+-------------------------+--+---------+------------->
           '- -dev--storage_image_ID-'  '- -quiet-'   

>--+---------+--+---------------+-- -lss--ID-------------------->
   '- -force-'  '- -subordinate-'              

>-- -session--session_ID---------------------------------------->

>--+-----------------------------------------------------------------------+-><
   +-Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID--+-------+-+   
   |                                                             '-. . .-' |   
   '-" - "-----------------------------------------------------------------'

Parameters

Note: Although this command might interrupt the formation of a consistency group, every attempt is made to preserve the previous consistent copy of the data on the FlashCopy target volumes. If, due to failures, this command cannot complete without compromising the consistent copy, the command stops processing and an error code is issued. If this occurs, reissue this command (rmgmir) with the -force parameter to force the command to stop the Global Mirror process.

-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 LSS ID.; Example: IBM.1750-68FA120
-quiet: (Optional). Turns off the confirmation prompt for this command.
-force: (Optional). Forces the Global Mirror process to stop regardless of the state of the Global Mirror associations.
-subordinate: (Optional). Indicates that the -lss parameter specifies a subordinate LSS ID.
-lss ID: (Required). Specifies the logical subsystem (LSS) that is participating in the Global Mirror session. Accepts a fully qualified LSS ID, which includes the storage image ID or a shortened version without the storage image ID, if the -dev parameter is specified.; Example of a fully qualified LSS ID: IBM.1750-68FA120/10
-session session_ID: (Required). Specifies the session ID for which the Global Mirror path association will be removed. A session ID is a Global Mirror session number that you assign in the 01 - FF hexadecimal range.; Example: 01
Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID . . . | -: (Optional). Specifies one or more Global Mirror path associations. A Global Mirror path association consists of two fully qualified LSS IDs. The first is designated as the master resource and the second is the subordinate resource between which there is a remote mirror and copy path. A LSS ID is two hexadecimal characters in the range 00 - 1F (1750 only). You must separate the fully qualified LSS IDs of a Global Mirror association with a colon and no spaces. The master resource must be identical for all relationships.; If you specify the dash (-), this parameter information is automatically supplied. However, you cannot use the dash (-) if you are using the DS CLI interactive mode.; Example of one Global Mirror path association with a single subordinate in the configuration: IBM.1750-68FA120/00: IBM.1750-68FA150/00; Example of multiple Global Mirror path associations with two subordinates in the configuration: IBM.1750-68FA120/00: IBM.1750-68FA150/00 IBM.1750-68FA120/00: IBM.1750-68FA150/01

Example (1750)

Invoking the rmgmir command

dscli>rmgmir -dev IBM.1750-68FA120 -lss 10 
-session 01 IBM.1750-68FA120/00:IBM.1750-68FA150/00

The resulting output

Date/Time: Sun Aug 11 02:23:49 PST 2004 DS CLI Version: 5.0.0.0 
DS: IBM.1750-68FA120

Are you sure you want to stop Session ID 01? [y/n]: Y
Global Mirror for Session ID 01 successfully stopped.