lscpset

Use the lscpset command to list the IDs and number of volumes for the copy sets that are in a session.
Tip: Use the showcpset command to list the volumes in a copy set and use the lsvol command to display the status of volumes in a copy set.

Syntax

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

Parameters

-help | -h | -?
Lists help for the command. If you specify additional parameters and arguments, those parameters and arguments are ignored.
-s | -l
Displays the following information.
Column Label Details
H1 Volume ID The ID of the volume at host site 1. This ID is used to identify a copy set in a session. The volume ID is displayed regardless of whether you provide the volume ID or name for the -h1 parameter.
Session The name of the session that contains the copy set.
Volumes The number of volumes that are associated with the copy set.
-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.
-h1 {h1_volume_id | h1_volume_name}
Specifies the volume at host site 1.
For IBM® DS8000® and IBM TotalStorage Enterprise Storage Server® Model 800 storage systems, use the volume ID for this parameter.
For other storage systems, you can use the volume ID or name for this parameter.
session_name | -
Specifies the name of the session that contains the copy sets.

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.

Example: Listing the IDs of all copy sets that are in a session

The following command lists the volume IDs and the number of volumes that are associated with the copy sets in a session called session1:

csmcli> lscpset session1
The following output is returned.
H1 Volume ID               Session       Volumes
================================================
DS8000:2107.NK791:VOL:1500 session1      5
DS8000:2107.NK791:VOL:1501 session1      5
DS8000:2107.NK791:VOL:1502 session1      5
DS8000:2107.NK791:VOL:1503 session1      5
DS8000:2107.NK791:VOL:1504 session1      5
ESS:2105.FCA57:VOL:1500    session1      5
ESS:2105.FCA57:VOL:1501    session1      5
ESS:2105.FCA57:VOL:1502    session1      5
ESS:2105.FCA57:VOL:1503    session1      5
ESS:2105.FCA57:VOL:1504    session1      5

Example: Listing a specific copy set that is in a session

The following command lists the number of volumes for a specific copy set in the session fc1. In this example, the volume name CSMRegr_vol08 is provided for the copy set in the command. The corresponding volume ID is shown in the output.

lscpset -h1 STORWIZE-V7000:VOL:TPCRTBIRD2:CSMRegr_vol08 fc1
The following output is returned:
H1 Volume ID                    Session       Volumes
=====================================================
STORWIZE-V7000:VOL:TPCRTBIRD2:7 fc1           2