showgmir

The showgmir command displays properties and performance metrics for a Global Mirror logical subsystem ID. You can issue this command on either the master storage unit or on any of the subordinate storage units. The report that is generated by this command varies significantly depending on which storage unit that you issue the command and the parameters that you specify.


>>-showgmir--+-------------------------+--+-----------+--------->
             '- -dev--storage_image_ID-'  '- -metrics-'   

>--+-LSS_ID-+--------------------------------------------------><
   '-" - "--'

Parameters

-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 logical subsystem (LSS) ID or you do not specify a value for the devid variable in your profile file.; Example: IBM.1750-68FA120
-metrics: (Optional). Specifies that the logical subsystem ID and its performance statistics be displayed.
LSS_ID | -: (Required). Specifies the logical subsystem (LSS) that receives the showgmir command. This parameter 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. The LSS ID is two hexadecimal digits in the range 00 - 1F (1750 only).; 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 a fully qualified LSS ID: IBM.1750-68FA120/10

Note:

The type of report that you receive is determined by the value that you specify for the LSS ID as follows:

When you issue the showgmir command from the master storage unit and you specify an LSS ID that is the same type (both even numbers or both odd numbers) as the master, you receive the following results:
- Without the -metrics parameter: A properties report that includes the master information
- With the -metrics parameter: A properties and performance values report.
When you issue the showgmir command from the master storage unit and you specify an LSS ID that is not the same type (one even number and one odd number) as the master, you receive the following results:
- Without the -metrics parameter: A properties report that displays only the fully qualified LSS_ID value and all the other input fields display a null (-) value.
- With the -metrics parameter: A properties and performance report that displays only the fully qualified LSS_ID value and all the other input fields display a null (-) value.
When you issue the showgmir command from the subordinate storage unit and you specify an LSS ID that is the same type (both even numbers or both odd numbers) as the master, you receive the following results:
- Without the -metrics parameter: A detailed properties report that displays only the master information (fully-qualified LSS ID, master session ID, and master storage unit ID). All the other fields display as a null (-) value.
- With the -metrics parameter: A detailed properties and performance values report that displays only the master information (fully qualified LSS ID, master session ID, and master storage unit ID). All the other fields display as a null (-) value.
When you issue the showgmir command from the subordinate storage unit and you specify an LSS ID that is not the same type (one even number and one odd number) as the master, you receive the following results:
- Without the -metrics parameter: A properties report that displays only the fully qualified LSS_ID value. All the other input fields on the report display a null (-) value.
- With the -metrics parameter: A properties and performance report that displays only the fully qualified LSS_ID value. All the other input fields on the report display a null (-) value.

Example (metrics not specified)

For this command and all other DS CLI show commands, the results are shown in table format to provide clarity. The actual reports do not display as tables.

The following tables represent the headers that are displayed on the output report that is associated with the showgmir command. A separate example is not shown for the 1750 because the information is the same for both. The only difference is the machine type designation, 2107 versus 1750.

Note: The following example presumes that you have issued the showgmir command with an LSS ID that matches the master storage unit.

Invoking the showgmir command

dscli>showgmir 
-dev IBM.2107-75FA120 10

The resulting output

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

ID	Master Count	Master Session ID	Copy State	Fatal Reason	CG Inter- val	XDC Inter- val	CG Drain Time	Current Time
IBM. 2107- 1300861 /14	1	0x25	Running	Not Fatal	0	50	30	10/25 /2006 13:45:44 PDT

CG Time	Succes- sful CG Percen- tage	Flash- Copy Sequ- ence Number	Master ID	Subor- dinate Count	Master/ Subordi- nate Assoc
10/25 /2006 13:45:44 PDT	100	0x453- FCCF8	IBM. 2107- 1300861	1	IBM.2107- 1300861/14: IBM.2107- 1300321/14

Report field definitions

ID

Specifies the LSS ID that consists of a storage image ID followed by two hexadecimal characters 00 - 1F (1750 only) that identify a Global Mirror (asynchronous remote mirror and copy) master LSS ID.

Master Count

Specifies the number of Global Mirror (asynchronous remote mirror and copy) masters. This value could be zero if none exist. When the value is zero, the master information fields of the report display a null (-) value

Master Session ID

Identifies the session ID that you assigned, 01 - FF hexadecimal range.

Copy State

Identifies the Global Mirror (asynchronous remote mirror and copy) copy state. The displayed value is one of the following:

Running: Indicates that the remote mirror and copy copy process is running.
Paused: Indicates that the remote mirror and copy copy process is paused.
Fatal: Indicates that the remote mirror and copy copy process is failed.
Pause In Progress: Indicates that the remote mirror and copy copy process is in the process of pausing.

Fatal Reason

Specifies a reason code for the failure. The displayed value is one of the following:

Time out
Revert FLC Failed Timeout
Revert FLC Failed
Not Fatal
Invalid Session ID
Inaccessible or Failed
Consistency Check Not Completed
Consistency Check Failed
Communication Failure
CG Corrupted
Busy Condition Preventing

CG Interval

Specifies the consistency group interval time between attempts to form a consistency group, up to 65 535 seconds.

XDC Interval

Specifies the maximum extended distance coordination interval. The default time is 50 milliseconds.

CG Drain Time

Specifies the consistency group drain time. The consistency group drain time is the maximum time that the consistent set of data is allowed to drain to the remote site before failing the current consistency group. The maximum allowed time is 65 535 seconds.

Current Time

Indicates the time stamp for when this report was generated. The date is displayed in the MM/DD/YYYY format. The time is displayed in the HH:MM:SS format on a 24-hour clock.

Note: If the clock is automatically adjusted at applicable times between standard and daylight saving time, daylight saving time is set to 1. If the clock is not automatically adjusted for daylight saving time, set to 0. For example, the report would display 12/04/2006 08:00:00 MST 0 if the clock is not automatically adjusted for daylight saving time.

CG Time

Specifies the recorded time stamp when the last successful consistency group was formed.

Successful CG Percentage

Specifies the percentage of successful attempts to form a consistency group, from 0% to 100%.

FlashCopy Sequence Number

Specifies the FlashCopy sequence number that is associated with the current consistency group.

Note: This value does not apply to a 2105; a null (-) value is displayed in this column when a machine type 2105 is queried.

Master ID

Specifies the Global Mirror master storage image ID.

Subordinate Count

Specifies the count of subordinate associations (with an allowed value of 1 to 16). The master-subordinate association fields repeat according to this count.

Master/Subordinate Assoc

Specifies the Global Mirror path associations. A Global Mirror path association consists of two fully qualified LSS IDs. One ID is designated as the master resource and the other ID is designated as the subordinate resource; a remote mirror and copy path has been established between the two resources.

Example (metrics specified)

The following tables represent the headers that are displayed on the output report that is associated with the showgmir command using the -metrics parameter. A separate example is not shown for the 1750 becausethe information is the same for both. The only difference is the machine type designation, 2107 versus 1750.

Note: The following example presumes that you have issued the showgmir command with an LSS ID that matches the master storage unit.

Invoking the showgmir command

dscli>showgmir -dev IBM.2107-75FA120  -metrics 10

The resulting output

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

ID	Total Failed CG Count	Total Succes- sful CG Count	Succes- sful CG Percen- tage	Failed CG after Last Success	Last Succes- sful CG Form Time	Coord. Time (milli- seconds)	Inter- val Time (sec- onds)
IBM. 2107- 75FA120 /10	2	3	40	2	01/13 /1970 13:08:37 PST	50	5

Max Drain Time (seconds)	First Failure Control Unit	First Failure LSS	First Failure Status	First Failure Reason	First Failure Master State	Last Failure Control Unit	Last Failure LSS
240	IBM. 2107- 75FA120	0x05	Error	Long Busy	Error Recovery	IBM. 2107- 75FA120	0x05

Last Failure Status	Last Failure Reason	Last Failure Master State	Previous Failure Control Unit	Previous Failure LSS	Previous Failure Status	Previous Failure Reason	Previous Failure Master State
Error	Long Busy	Error Recovery	IBM. 2107- 75FA120	0x05	Error	Long Busy	Error Recovery

Report field definitions

ID: Identifies the LSS ID. This ID consists of a storage image ID that is followed by two hexadecimal characters 00 - 1F (1750 only) that identify a Global Mirror (Asynchronous PPRC) master LSS ID.
Total Failed CG Count: Specifies the total number of consistency groups that did not complete in the user-specified drain time.
Total Successful CG Count: Identifies the total number of consistency groups that completed before the user-specified drain time.
Successful CG Percentage: Identifies the percentage of attempts that were successful in forming a consistency group.
Failed CG after Last Success: Specifies the total number of failed consistency groups after the last successful completion.
Last Successful CG Form Time: Identifies the last successful consistency group completion time.
Coord. Time (milliseconds): Specifies the value in milliseconds that indicates the maximum amount of time that Global Mirror queues the primary host I/O to start forming a consistency group. The default is 50 milliseconds.
Interval Time (seconds): Specifies the value in seconds that indicates how long to wait between formation of consistency groups.
Max Drain Time (seconds): Specifies the value in seconds that indicates the maximum amount of time that Global Mirror allows for the consistent set of data to drain to the remote site.
First Failure Control Unit: Identifies the Control Unit MTS that has caused the first failure of the consistency group formation.
First Failure LSS: Identifies the LSS number that has caused the first failure of the consistency group formation.
First Failure Status: Indicates the first failure status of the consistency group formation. The "First Failure Reason" and "First Failure Master State" fields display data only when this field contains "Error".
First Failure Reason: Specifies the error reason of the first failure of the consistency group formation attempt.
First Failure Master State: Identifies the master state for the first Global Mirror failure.
Last Failure Control Unit: Identifies the Control Unit MTS that has caused the last failure of the consistency group formation.
Last Failure LSS: Identifies the LSS number that has caused the last failure of the consistency group formation.
Last Failure Status: Indicates the last failure status of the consistency group formation. The "Last Failure Reason" and "Last Failure Master State" fields display data only when this field contains "Error".
Last Failure Reason: Specifies the error reason of the last failure of the consistency group formation attempt.
Last Failure Master State: Identifies the master state for the last Global Mirror failure.
Previous Failure Control Unit: Identifies the Control Unit MTS that has caused the previous failure of the consistency group formation.
Previous Failure LSS: Identifies the LSS number that has caused the previous failure of the consistency group formation.
Previous Failure Status: Indicates the previous failure status of the consistency group formation. The "Previous Failure Reason" and "Previous Failure Master State" fields display data only when this field contains "Error".
Previous Failure Reason: Specifies the error reason of the previous failure of the consistency group formation attempt.
Previous Failure Master State: Specifies the master state for the previous Global Mirror failure.