lsdevice

Use the lsdevice command to list storage systems and properties.

Tip: To list storage systems that can be discovered through an IBM® z/OS® connection, use the lsstorcandidate command.

Syntax

Read syntax diagramSkip visual syntax diagramlsdevice-help-h-?-s-l-fmtdefaultxmldelim-delimcharstanza-ponoff-hdronoff-rnumber-voffon-devtypedsds8000spectrum-virtualizesvcxiv-mcidmc_id  device_id -

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 for each storage system, including the device ID, connection type, device type, and local server connection status.
-l
Displays the following detailed information for each storage system.
Column Label Details
Device ID The name, nickname, or model-serial-manufacturer of the storage system.
Connection Type The connection type. The values are: Direct, HMC, or ZOS Connection.
Device Type

The storage system type. For FlashSystem devices, the model of the FlashSystem will be displayed if known.

Device IP Address The IP address or host name for the nodes or clusters that are used by the storage system. If there are multiple nodes or clusters, the values in this column are delimited by a semicolon. For example, ip_address;ip_address.
Local Server Connection The state of the direct connections to the local management server. If there are multiple servers, the values in this column are delimited by a semicolon. For example, cluster0_status;cluster1_status.
Remote Server Connection The state of the direct connections to the remote management server. If there are multiple servers, the values in this column are delimited by a semicolon. For example, cluster0_status;cluster1_status.
Connection ID

The ID for the Hardware Management Console (HMC) or IBM z/OS host system that is used to connect the storage system.

Location The location of the storage system.
Manufacturer The manufacturer of the storage system.
Device Name The user-defined name 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.
-devtype { ds | ds8000 | svc | spectrum virtualize | xiv }
Specifies the type of storage system. The parameter values are:
  • ds: IBM DS8000®
  • ds8000: IBM DS8000
  • svc: IBM SAN Volume Controller
  • spectrum-virtualize: Any Storage Virtualize device
  • xiv: IBM XIV® Storage System
-mcid mc_id
Specifies storage systems that are connected through a specific management console.
device_id... | -
Specifies one or more storage systems by ID. The storage system ID is in the element ID format (for example, ess:box:2105.fca57). Separate multiple storage system IDs with a space.

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 all storage systems

The following command lists information for all storage systems.

csmcli> lsdevice -devtype ds

The following output is returned:

Device ID             Connection Type Device Type Local Server Connection
=========================================================================
DS8000:BOX:1234.56789 Direct          DS8000      Connected;Connected
DS8000:BOX:1234.56789 ZOS Connection  DS8000      Connected
DS8000:BOX:1234.AB123 HMC             DS8000      Connected;Connected

Example: Listing detailed attributes for all storage systems

The following command lists detailed information for all storage systems.

csmcli> lsdevice -l -devtype ds -fmt stanza

The following output is returned:

Device ID                DS8000:BOX:1234.56789
Connection Type          Direct
Device Type              DS8000
Device IP Address        -
Local Server Connection  Connected;Connected
Remote Server Connection -
Connection ID            -
Location                 None
Manufacturer             IBM
Device Name              -

Device ID                DS8000:BOX:1234.56789
Connection Type          ZOS Connection
Device Type              DS8000
Device IP Address        -
Local Server Connection  Connected
Remote Server Connection -
Connection ID            ZOS:abc68.storage.sacramento.xyz.com:5858
Location                 None
Manufacturer             IBM
Device Name              -

Device ID                DS8000:BOX:1234.AB123
Connection Type          HMC
Device Type              DS8000
Device IP Address        -
Local Server Connection  Connected;Connected
Remote Server Connection -
Connection ID            HMC:Stg8k11.storage.sacramento.xyz.com
Location                 None
Manufacturer             IBM
Device Name              -