lsbackupvols

Use the lsbackupvols command to display the volumes included in a given backup for the specified session and role.

Syntax

Read syntax diagramSkip visual syntax diagramlsbackupvols-help-h-?-s-l-fmtdefaultxmldelim-delimcharstanza-ponoff-hdronoff-voffon-backupidbackup_ID-rolerole_name-session_name-

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, including the source and target LSS and the type of port configuration.
-l
Displays detailed information for each port, including:
Column label Details
Backup ID Identification for the backup
Volume ID Volume identification
Volume Name User defined name for the volume
Backup Time Timestamp for when the backup was taken
isError Is there an error associated with this volume on the backup
Tracks Left To Copy Tracks left to copy to the backup capacity
Used Capacity Capacity used for each backup
Last Result The last result of the backup
Expansion Blocked Whether volume expansion is blocked
-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.
-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.
-backupid backup_ID
Specifies the id number for the backup.
-role role_name
Specifies that only backups that are associated with the specified role name are displayed.
-session_name |-
Specifies the name of the session used to display backups.

Example: Listing volumes for a given backup

The following command lists the volumes associated with a given backup for a session named MyBackupSess and role H1.

csmcli> lsbackupvols -role h1 -backupID 47676786 MyBackupSess

The following output is returned:

Volume                       Volume   Backup     Backup                         is      Tracks Left   Used       Last       Expansion
ID                           Name     ID         Time                           Error   To Copy       Capacity   Result     Blocked
====================================================================================================================================
DS8000:2107.ZA851:VOL:1000   CSM000   47676786   2018-06-13 14:37:50.495-0500   no      -             1.8 KiB    IWNRxxxI   yes
DS8000:2107.ZA851:VOL:1001   CSM001   47676786   2018-06-12 14:37:50.495-0500   no      -             2.9 KiB    IWNRxxxI     
DS8000:2107.ZA851:VOL:1002   CSM002   47676786   2018-06-11 14:37:50.495-0500   no      -             3.2 KiB    IWNRxxxI       
DS8000:2107.ZA851:VOL:1003   CSM003   47676786   2018-06-10 14:37:50.495-0500   yes     -             1.1 KiB    IWNRxxxE      
DS8000:2107.ZA851:VOL:1004   CSM004   47676786   2018-06-09 14:37:50.495-0500   on      -             1.7 KiB    IWNRxxxI