lssnapshots

Use the lssnapshots command to view snapshots that are in a snapshot group in a FlashSystem/IBM® Spectrum Accelerate snapshot session.

Syntax

Read syntax diagramSkip visual syntax diagramlssnapshots-help-h-?-s-l-fmtdefaultxmldelim-delimcharstanza-ponoff-hdronoff-rnumber-voffon-groupsnapshot_group_namesession_name -

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 in the snapshot group is displayed. The default information is the name of the snapshot.
-l
Specifies that detailed information for each snapshot in the snapshot group is displayed, including:
Column Label Details
Name The name of the snapshot.
H1 Volume ID The ID of the H1 volume that is associated with the snapshot.
Size The size of the H1 volume at the time that the snapshot was created.
Size Unit The unit of measure for the size of the H1 volume at the time that the snapshot was created.
-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.
-group snapshot_group_name
Specifies the name of the snapshot group that contains the snapshots.
session_name | -
Specifies the name of the Snapshot session that contains the snapshot group.
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 snapshots that are in a snapshot group in a session

The following command lists all snapshots that are in the snapshot group snap6.snap_group_00001 for session snap6:

csmcli> lssnapshots -group snap6.snap_group_00001 snap6

The following output is returned:

Name                   
===================================================
snap6.snap_group_00001_vol1
snap6.snap_group_00001_vol2

Example: Listing detailed information about the snapshots that are in a snapshot group for a session

The following command lists detailed information about the snapshots that are in snapshot group for the session snap6:

csmcli> lssnapshots -group snap6.snap_group_00001 -l snap6

The following output is returned:

Name                        H1 Volume ID             Size     Size Unit
=======================================================================
snap6.snap_group_00001_vol1 XIV:VOL:7803307:115017   16.0     GiB
snap6.snap_group_00001_vol2 XIV:VOL:7803307:115018   16.0     GiB