lsgmir

The lsgmir command displays a list of Global Mirror for the storage image of the specified logical subsystem (LSS).

Parameters

-s: (Optional) Specifies that you want the system to display only the session ID for the LSS. You cannot use the -s and the -l parameters together.
-l: (Optional) Specifies that you want the system to display all the information that is associated with the session. You cannot use the -l and the -s parameters together.
-dev storage_image_ID: (Optional) Specifies the storage image ID, which consists of a value for manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified extent pool 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.
-session session_ID: (Optional) Specifies a session ID number. The number must be greater than 0 (01 - FF hexadecimal range). If you do not specify this parameter, all sessions will be displayed.
LSS_ID | -: (Required) Specifies the logical subsystem (LSS) ID for the Global Mirror session. A fully qualified LSS ID is accepted, which consists of the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. The shortened version is a four-decimal digit number with no leading zeros, prefixed with the letter P.; If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.

Example: Displaying a Global Mirror list of a specified LSS

dscli> lsgmir -dev IBM.2107-75FA120

Output

SessionID	MasterID	ID	State	%Success	CGtime
1	IBM.2107-75FA120	10	Running	90	08/31/2018 21:52:02 CST

Output definitions

SessionID

The session ID number.

MasterID

The master ID.

ID

The logical subsystem ID.

State

One of the following Global Mirror states:

Running: A Global Mirror session is resumed.
Paused: The Global Mirror session will be paused, that is, stopped from forming consistency groups, after the current consistency group has been formed. However, the secondary volumes in the Global Mirror session should not be considered to form a consistent data set. Another separate process is required to form a consistent data set on the secondary volumes. You can pause a session and later resume the session.
Pause in Progress: The Global Mirror session is currently in the process of pausing.
Paused with Secondary Consistency: The Global Mirror session will be paused, that is, stopped from forming of consistency groups, after the current consistency group has been formed. However, all of the secondary volumes in the Global Mirror session already form a consistent data set. You can pause a session and later resume the session.
Paused because Resume Failed: An attempt to resume a Global Mirror session that is in the Paused state failed. The Global Mirror session is still in the Paused state.
Fatal: Global Mirror copy process is failed.
Unowned: The session is not owned by the cluster that you specified using the LSS ID.
Recovering: The Master is in the process of recovering the session.

%Success

The percentage of successful attempts to form a consistency group.

CGtime

The time stamp of the last successful consistency group.