showgmiroos

The showgmiroos command displays the number of unsynchronized (out of sync) tracks for the specified Global Mirror session.


>>-showgmiroos--+-------------------------+-- -scope--+-si--+--->
                '- -dev--storage_image_ID-'           '-lss-'   

>-- -lss--LSS_ID----session_ID--+-----+------------------------><
                                '-"-"-'

Parameters

Note: You might want to use this command to assist you in the following circumstances:

To see how data is transferring. The showgmiroos command lets you see how far behind the remote site is from the local site in the transfer of data. The displayed value represents how many tracks must be transferred to catch up (be synchronized).
You are not able to form consistency groups because you have exceeded the maximum drain time. The number of tracks that are not synchronized might be an indicator that you must adjust some values to allow for complete processing.

-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, which includes a storage image ID.; Example: IBM.1750-68FA120
-scope si | lss: (Required) Specifies the scope of the data to be returned: storage image (si) or logical subsystem (lss).
-lss LSS_ID: (Required). Specifies the master logical subsystem (LSS) that receives the showgmiroos command. Accepts a fully qualified master LSS ID, which includes either the storage image ID or a shortened version without the storage image ID if the -dev parameter is specified. The LSS ID is two hexadecimal digits in the range 00 - 1F (1750 only).; Example of a fully qualified LSS ID: IBM.1750-68FA120/10
session_ID -: (Required). Specifies the session to display. A session ID is a Global Mirror session number that you assign in the 01 - FF hexadecimal range.; 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

A separate example is not shown for the 1750 as the information is the same for both. The only difference is the machine type designation, 2107 versus 1750.

Invoking the showgmiroos command

dscli>showgmiroos –dev IBM.2107-75FA120  -scope si  -lss 10 01

The resulting output

Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 DS: IBM.2107-75FA120

Scope			IBM.2107-75FA120
Session			01
OutOfSyncTracks		3

Report field definitions

The following supplies information that you can use to help you understand the output that is generated from this command.

Scope: Indicates the scope of the returned information (storage image or logical subsystem).
Session: Indicates the Global Mirror session number.
OutOfSyncTracks: Indicates the number of unsynchronized tracks.