lssnapgrp

Use the lssnapgrp command to view snapshot groups that are in an FlashSystem/IBM® Spectrum Accelerate snapshot session.

A snapshot group is a grouping of snapshots of individual volumes in a consistency group at a specific point in time.

Syntax

Parameters

-help | -h | -?

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

-s

Specifies that default information for each snapshot group is displayed. The default information is the name of the snapshot group and the date and time that the group was created.

-l

Specifies that detailed information for each snapshot group is displayed, including:

Column Label	Details
Name	The name of the snapshot group.
Timestamp	The date and time that the snapshot group was created.
Deletion Priority	The priority in which the snapshot group is deleted from the session. The value is the number 1 - 4. A value of 1 specifies that the snapshot group is deleted last. A value of 4 specifies that the snapshot group is deleted first. Multiple snapshot groups might exist until FlashSystem/IBM Spectrum® Accelerate identifies that there is not enough space in the storage pool to keep all of the snapshots.
Restore Master	Specifies whether the snapshot group listed can be used to restore the master volumes of the session. Values for this are `Yes` and `No`.
Locked	Specifies whether the snapshot group is currently locked. If the snapshot group is locked, write operations to the snapshots within the snapshot group are prevented.
Modified	Specifies whether the snapshot group has been modified. A snapshot group is marked as modified when it is unlocked for the first time.

-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.

session_name | -

Specifies the name of the Snapshot session.

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.

Example: Listing all snapshot groups that are in a session

The following command lists all snapshot groups that are in the session snap6:

csmcli> lssnapgrp snap6

The following output is returned:

Name                   Timestamp
===================================================
snap6.snap_group_00001 2011-04-01 00:04:49.000-0500

Example: Listing detailed information about the snapshot groups that are in a session

The following command lists detailed information about the snapshot groups that are in the session snap6:

csmcli> lssnapgrp -l snap6

The following output is returned:

Name                   Timestamp                     Deletion  Restore  Locked  Modified
                                                     Priority  Master
========================================================================================
snap6.snap_group_00001 2011-07-18 15:22:14.000-0700  1         No       Yes     No
snap6.snap_group_00002 2011-07-18 15:22:41.000-0700  1         Yes      Yes     No