showsess

Use the showsess command to display properties for a selected session, including name, description, group managed, and copy type.

Syntax

Read syntax diagramSkip visual syntax diagramshowsess-help-h-?session_name -

Parameters

-help | -h | -?
Lists help for the command. If you specify additional parameters and arguments, those parameters and arguments are ignored.
session_name | -
Specifies the session for which the properties are to be displayed.

Alternatively, use the dash (-) to specify that input for this parameter comes from an input stream (stdin). The dash is supported only in single-shot mode.

Description

For each session, the following information is listed:

Column Label Details
Name Session name.
Group The user-defined name of the session group that the session belongs to.
Type Session type. These following values are applicable:
  • FlashCopy
  • Basic HyperSwap
  • Metro Mirror Single Direction
  • Metro Mirror Practice
  • Metro Mirror Failover/Failback
  • Metro Mirror - Metro Mirror
  • Global Mirror Single Direction
  • Global Mirror Practice
  • Global Mirror Failover/Failback
  • Global Mirror Either Direction w/ Two Site Practice
  • Global Mirror Failover/Failback w/ Change Volumes
  • Metro Global Mirror
  • Metro Global Mirror w/ Practice
  • Metro Mirror - Global Mirror
  • Metro Mirror - Global Mirror w/ Practice
  • Metro Mirror - Global Mirror w/ Site 3 Global Mirror
  • Metro Mirror - Global Mirror w/ Site 4 Replication
  • Metro Mirror - Metro Mirror w/ Site 4 Replication
  • Snapshot
  • Safeguarded Copy
  • etc
State Session state. These following values are applicable:
  • Defined
  • Flashing
  • Preparing
  • Prepared
  • Recovering
  • Suspended
  • SuspendedH2H3
  • SuspendedH1H3
  • Suspended (Partial)
  • Suspending
  • Target Available
  • Terminating
Status Session status. These following values are applicable:
  • Unknown
  • Normal
  • Warning
  • Severe
  • Inactive
Locations A list of the locations that are associated with the session.
Copy sets The number of copy sets that the session is managing.
Copying An indicator of whether a copying operation is occurring. Values are Yes or No.
Recoverable An indicator of whether the session is recoverable. Values are Yes or No.
Active host Name of the active host.
Error Count Number of errors for all roles.
Description Session description that you define.

Example: Listing session properties for a Metro Global Mirror with Practice session

The following command lists properties for the session named session1.

csmcli> showsess session1

The following output is returned:

Name            session1
Group           group1
Type            Metro Global Mirror w/ Practice
State           Defined
Status          Inactive
Locations       Site1, Site2, Site3
Copy Sets       10
Copying         No
Recoverable     No
Active Host     H1
Error Count     0
Description     -
Transitioning   No
Detailed Status -

IWNR1500I  Session information about session session1 was successfully obtained.

Example: Listing session properties for an FlashSystem/IBM Spectrum Accelerate Snapshot session

The following command lists properties for the session named session1.

csmcli> showsess session1

The following output is returned:

Name                 session1
Group                -
Type                 Snapshot
State                Target Available
Status               Active
Locations            Site1
Copy Sets            10
Copying              No
Recoverable          Yes
Active Host          H1
Error Count          0
Description          -
Transitioning        No
H1 Pool              XIV:POOL:12345:67890
H1 Consistency Group session1
Detailed Status      -

IWNR1500I Session information about session session2 was successfully obtained.

Example: Listing session properties for an FlashSystem/IBM Spectrum Accelerate Metro Mirror session

The following command lists properties for the session named session1.

csmcli> showsess session1

The following output is returned:

Name                 session1
Group                -
Type                 Metro Mirror Failover/Failback
State                Prepared
Status               Active
Locations            Site1, Site2
Copy Sets            10
Copying              Yes
Recoverable          Yes
Active Host          H1
Error Count          0
Description          -
Transitioning        No
H1 Pool              XIV:POOL:12345:67890
H2 Pool              XIV:POOL:12345:67890
H1 Consistency Group session1
H2 Consistency Group session1
Detailed Status      -

IWNR1500I Session information about session session1 was successfully obtained.

Example: Listing session properties for an FlashSystem/IBM Spectrum Accelerate Global Mirror session

The following command lists properties for the session named session1.

csmcli> showsess session1

The following output is returned:

Name                 session1
Group                -
Type                 Global Mirror Failover/Failback
State                Prepared
Status               Active
Locations            Site1, Site2
Copy Sets            10
Copying              Yes
Recoverable          Yes
Active Host          H1
Error Count          0
Description          -
Transitioning        No
H1 Pool              XIV:POOL:12345:67890
H2 Pool              XIV:POOL:12345:67890
H1 Consistency Group session1
H2 Consistency Group session1
Detailed Status      -
IWNR2750E Recovery Point Objective for session session1 has passed the threshold 
of 30 seconds.
IWNR1500I Session information about session session1 was successfully obtained.

Example: Listing session properties for an IBM® DS8000® Safeguarded Copy session

The following command lists properties for the session named session1.

csmcli> showsess session1

The following output is returned:

Name                 session1
Group                -
Type                 Safeguarded Copy
State                Protected
Status               Active
Locations            Site1
Copy Sets            10
Copying              Yes
Recoverable          Yes
Active Host          H1
Error Count          0
Description          -
Transitioning        No
Associated Session   8 kMM
Associated Role Pair H1-H2
Matching Role        H2
Role To Restore      H1
Detailed Status      -
IWNR2750E Recovery Point Objective for session session1 has passed the threshold 
of 30 seconds.
IWNR1500I Session information about session session1 was successfully obtained.