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