lsstorcandidate

Edit online

Use the lsstorcandidate command to list the storage systems that can be discovered through an IBM® z/OS® connection. This command does not list storage systems that are already added to the copy services management server configuration.

To list storage systems that are already in the configuration, use the lsdevice command.

You can run the lsstorcandidate command only from a copy services management server that is installed on a system that is running the z/OS operating system.

Syntax

Parameters

-help | -h | -?

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

-s | -l

Specifies that the following information is displayed for each storage system:

Column Label	Details
Device ID	The storage system ID.
Manufacturer	The manufacturer of the storage system.

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

-conntype zos

Specifies the type of connection that the storage systems use. Currently, you can specify only zos for a z/OS connection.

Example: Listing candidate storage systems

The following command lists candidate storage systems:

csmcli> lsstorcandidate -conntype zos

The following output is returned:

Device ID              Manufacturer
===================================
ESS:BOX:2105.12345     IBM