rmgmir

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

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) The storage image ID consists of the manufacturer name, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command.; Example: IBM.2107-75FA120
-quiet: (Optional) Turns off the end Global Mirror session 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) The -lss parameter specifies a subordinate LSS ID.
-lss ID: (Required) 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.2107-75FA120/10
-session session_ID: (Required) 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) 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 - FE. 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.; The ellipsis (...) indicates that, optionally, you can specify multiple values. If you use the dash (-), the specified value is read from standard input. 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.2107-75FA120/00: IBM.2107-75FA150/00; Example of multiple Global Mirror path associations with two subordinates in the configuration: IBM.2107-75FA120/00: IBM.2107-75FA150/00 IBM.2107-75FA120/00: IBM.2107-75FA150/01

Example: Stopping Global Mirror processing for session 01

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

Output

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