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