lssess

Parameters

-help | -h | -?

Lists help for the command. If you specify additional parameters and arguments, those parameters and arguments are ignored.

-s

Displays default information for each session, including the session name, status, state, session type, and group.

-l

Displays the following detailed information for each session.

Column Label	Details
Name	The user-defined name of the session.
Status	The status level. The values are: Inactive, Normal, Warning, Severe, or Unknown.
State	The session state. The values are: Defined, Preparing, Prepared, Suspended, Suspended (Partial), Protected, or Target Available.
Copy Type	The session type. For a list of values, see the -cptype parameter.
Recoverable	Specifies whether a session is recoverable. The values are yes or no.
Copying	Specifies whether a copying operation is taking place. The values are yes or no.
Copy Sets	The number of copy sets that are in the session.
Error	Specifies whether a session has errors. The values are yes or no.
Group	Specifies that only sessions belonging to the session group_name are displayed.

-fmt { default | xml | delim | stanza }

Specifies the format of the output. You can specify one of these values:

default

Specifies that the output is displayed in tabular format using spaces as delimiters between columns. This is the default value.

xml

Specifies that the output is displayed in XML format.

delim

Specifies that output is displayed in a tabular format using commas as delimiters between columns.

To use a character other than a comma as the delimiter, specify -fmt delim -delim char , where char represents the character that you want to use as the delimiter. For example, if you want to use a colon (:) as the delimiter, use the following -fmt parameter:

-fmt delim -delim :

If you use a shell metacharacter as the delimiting character, enclose the character in quotation marks or single quotation marks. A blank space is not a valid character.

stanza

Specifies that the output is displayed as one keyword-value pair per line.

-p { on | off }

Specifies whether to display one page of text at a time or all text at once.

on

Displays one page of text at a time. Pressing any key displays the next page. This is the default value when the command is run in interactive mode.

off

Displays all text at once. This is the default value when the command is run in single-shot mode.

-hdr { on | off }

Specifies whether to display the table header. You can specify one of these values:

on

Displays the table header. This is the default value.

off

Hides the table header.

-r number

Specifies the number of rows per page to display when the -p parameter is specified. You can specify a value of 1 - 100. The default value is 22.

-v { on | off }

Specifies whether to enable verbose mode. You can specify one of these values:

on

Enables verbose mode.

off

Disables verbose mode. This is the default value.

-cptype copy_type

Specifies the session type. The storage systems that are available for a session differ by session type. The following parameter values are listed by storage system type. For a full listing issue the lscptypes command.

IBM® TotalStorage Enterprise Storage Server® Model 800, IBM DS8000®

• fc: FlashCopy®
• hs: Basic HyperSwap®
• mmsd: Metro Mirror Single Direction
• mmfofb: Metro Mirror Failover/Failback
• pmm: Metro Mirror Failover/Failback with Practice
• mm_mm: Metro Mirror - Metro Mirror (This session type is available only for IBM DS8000 storage systems with a microcode level that supports single source to multi-target relationships.)
• gmsd: Global Mirror Single Direction
• gmfofb: Global Mirror Failover/Failback
• gm2s: Global Mirror Either Direction
• pgm: Global Mirror Failover/Failback with Practice
• pgm2s: Global Mirror Either Direction with Two Site Practice
• mgm: Metro Global Mirror
• pmgm: Metro Global Mirror with Practice
• sgc: Safeguarded Copy
• mm_gm: Metro Mirror - Global Mirror
• mm_gmp: Metro Mirror - Global Mirror with Practice
• mm_gm_s3_gm: Metro Mirror - Global Mirror w/ Site 3 Global Mirror
• mm_gm_4s: Metro Mirror - Global Mirror w/ Site 4 Replication
• mm_mm_4s: Metro Mirror - Metro Mirror w/ Site 4 Replication

IBM Storwize® V3500

• fc: FlashCopy

IBM System Storage SAN Volume Controller, IBM Storwize V7000, IBM Storwize V7000 Unified, IBM FlashSystem 7200, IBM Storwize V5000, IBM Storwize V3700, IBM FlashSystem V840, IBM FlashSystem V9000, IBM FlashSystem 9100, IBM FlashSystem 9200

• fc: FlashCopy
• snapsvc: Snapshot
• mmsd: Metro Mirror Single Direction
• mmfofb: Metro Mirror Failover/Failback
• pmmsvc: Metro Mirror Failover/Failback with Practice
• gmsdsvc: Global Mirror Single Direction
• gmfofbsvc: Global Mirror Failover/Failback
• pgmsvc: Global Mirror Failover/Failback with Practice
• gmcvsvc: Global Mirror Failover/Failback with Change Volumes

FlashSystem/IBM Spectrum Accelerate

• snap: Snapshot
• mmfofbxiv: Metro Mirror Failover/Failback
• gmfofbxiv: Global Mirror Failover/Failback
• mm_gm_xiv: Metro Mirror - Global Mirror

-groupname group_name

Specifies that only sessions belonging to the session group_name are displayed.

-status inactive | normal | warning | severe | unknown

Specifies that only sessions with the specified status of Inactive, Normal, Warning, Severe, or Unknown are displayed.

session_name... | -

Specifies that only sessions with a specified session name are displayed. Separate multiple session names with a space between each name. All sessions are displayed by default.

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