lssession

The lssession command displays a list of Global Mirror sessions for a logical subsystem (LSS) and information regarding the volumes of each session in the list.


>>-lssession--+-------------------------+--+-----+-------------->
              '- -dev--storage_image_ID-'  +- -s-+   
                                           '- -l-'   

>--+-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 ID for the logical subsystem.; Example: IBM.1750-68FA120
-s: (Optional). Displays the session IDs. You cannot use the -l and the -s parameters together.
-l: (Optional). Displays the default output. You cannot use the -l and the -s parameters together.
LSS_ID | -: (Required). Specifies the logical subsystem (LSS) ID for the Global Mirror session. The format of the LSS ID is a hexadecimal value in the range 00 - 1F (1750 only).; 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.; 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

Example

For this command and all other DS CLI list 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 lssession command using the -l parameter. A separate example is not shown for the 1750 because the information is the same for both machine types. The only difference is the machine type designation, 2107 versus 1750.

When you use the -s parameter with the lssession command only 3 ID items are displayed in the resulting report: LSSID, SessionID, and VolumeID. A separate example is shown for this scenario.

Invoking the lssession command using the -l parameter

dscli>lssession –dev IBM.2107-75FA120 -l 01

The resulting output

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

LSSID	Session	Status	Volume	Volume Status
IBM.2107- 75FA120 /10	01	Normal	IBM.2107- 75FA120 /1001	Active
IBM.2107- 75FA120 /10	01	Normal	IBM.2107- 75FA120 /1002	Active
IBM.2107- 75FA120 /10	01	Normal	IBM.2107- 75FA120 /1003	Active
IBM.2107- 75FA120 /10	02	Normal	IBM.2107- 75FA120 /1011	Active
IBM.2107- 75FA120 /10	02	Normal	IBM.2107- 75FA120 /1012	Remove Pending
IBM.2107- 75FA120 /10	02	Normal	IBM.2107- 75FA120 /1013	Join Pending

Primary Status	Secon- dary Status	First- Pass Complete	Allow- Cascad- ing
Pri- mary Full Duplex	Secon- dary Simplex	True	Dis- abled
Pri- mary Full Duplex	Secon- dary Simplex	True	Dis- abled
Pri- mary Full Duplex	Secon- dary Simplex	True	Dis- abled
Pri- mary Full Duplex	Secon- dary Simplex	True	Dis- abled
Pri- mary Simplex	Secon- dary Simplex	True	Dis- abled
Pri- mary Simplex	Secon- dary Simplex	False	Dis- abled

Invoking the lssession command using the -s parameter

dscli>lssession -s –dev IBM.2107-75FA120 10

The resulting output

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

LSSID	Session	Volume
10	01	1001
10	01	1002
10	01	1003
10	02	1011
10	02	1012
10	02	1013

Report field definitions

LSSID

Specifies the unique identifier that is assigned to this logical subsystem object. The LSS ID is a hexadecimal value in the range 00 - 1F (1750 only).

Session

Specifies the Session ID number that you assigned in the 01 - FF hexadecimal range.

Status

Specifies the state of the session. One of the following values is displayed:

CG in progress: Indicates that the consistency group for the session is in progress.
Increment Pending: Indicates that the Increment process is in progress.
Normal: Indicates that the session is in a normal state.

Volume

Specifies the volume ID. If no volume is active for the session a null (-) value is displayed.

Volume Status

Specifies the status of the volume in the session. One of the following values is displayed:

Join Pending: Indicates that the volume is not active for the current session. However, it will be added to the session in the next cycle.
Remove Pending: Indicates that the volume is active for the current session. However, it will be removed in the next cycle.
Active: Indicates that the volume is an active member of the session.

Primary Status

Specifies the primary remote copy and mirror status of the volume. One of the following values is displayed:

Primary Simplex: Indicates that the volume is not part of a remote mirror and copy relationship.
Primary Copy Pending: Indicates that the volume is primary in a remote mirror and copy relationship and the relationship is in a Copy Pending state, which means that the source and target volume are out-of-sync. In this situation, data still needs to be copied from the source to the target volume.
Primary Full Duplex: Indicates that the volume is primary in a remote mirror and copy relationship and the relationship is in a Full Duplex state, which means that the copy operation has completed and the volume pair is synchronized, and that any updates to the primary volume will be transferred synchronously to the secondary volume.
Primary Suspended: Indicates that the volume is primary in a remote mirror and copy relationship and the relationship is suspended, which means that the primary is no longer transferring data to the secondary, and any changed data that is at the primary will be tracked in an out-of-sync bitmap.
- (null): Indicates that there are no active volumes for the session.

Secondary Status

Specifies the secondary remote copy and mirror status of the volume. One of the following values is displayed:

Secondary Simplex: Indicates that the volume is not part of a remote mirror and copy relationship.
Secondary Copy Pending: Indicates that the volume is secondary in a remote mirror and copy relationship and the relationship is in a Copy Pending state, which means that the source and target volume are out-of-sync. In this situation, data still needs to be copied from the source to the target volume.
Secondary Full Duplex: Indicates that the volume is secondary in a remote mirror and copy relationship and the relationship is in a Full Duplex state, which means that the copy operation has completed and the volume pair is synchronized, and that any updates to the secondary volume will be transferred synchronously from the primary volume.
Secondary Suspended: Indicates that the volume is secondary in a remote mirror and copy relationship and the relationship is suspended, which means that the primary is no longer transferring data to the secondary, and any changed data that is at the primary will be tracked in an Out of Sync bitmap.
- (null): Indicates that there are no active volumes for the session.

FirstPass Complete

Specifies whether the first cycle of the volume in the global mirror relationship has ended. The value displayed is either True or False.

AllowCascading

Specifies whether the volume can be a secondary in a remote mirror and copy relationship. The value displayed is either Enabled or Disabled.