lsdev

Use the lsdev command to list information about storage systems, fabrics, and switches. This information includes the globally unique identifier (GUID) or worldwide name (WWN) for the fabric, the user-defined name, the resource type, the status, and the time that the status was updated.

Syntax


1  tpctool lsdev  -user  user_name -pwd  password   -url  url? -perf  level
2.1 sample
2.1 hourly
2.1 daily? -fabric? -subsys? -l?  -fs  character?  -header ?  -help?  -qs  character?   -silent

Parameters and arguments

-user user_name
Specifies an IBM Spectrum Control™ user ID.
-pwd password
Specifies the password for the IBM Spectrum Control user ID.
-url url
Specifies the Device server. The format of the URL is system:port_number, where system represents either the host name or IP address, and port_number represents the IBM Spectrum Control Device server port.
-perf
Specifies that resources for which performance data is collected will be listed. You must have the applicable authority to view the resources.
-level sample | hourly | daily
Specifies the level for which the information is summarized. You can specify a sample summary, an hourly summary, or a daily summary.
-fabric
Specifies that only fabrics are listed. You must have Administrator authority to use this option.
-subsys
Specifies that only storage systems are listed.
-l
Specifies that the long version of the information is listed. The following information is given.
  • GUID or WWN
  • User-defined name
  • Resource type
  • Status
  • Time that the status was updated

If you omit this parameter, only the GUID or WWN is listed.

-fs character
Specifies the 7-bit character that separates the information in the output. If you omit this parameter, the information is separated by blank spaces.
-header
Suppresses the column headings in the output. If you omit this parameter, the column headings are included.
-help | -h | -?
Lists help information for the command.
-qs character
Specifies the 7-bit character that surrounds character strings and date stamps in the output. If you omit this parameter, character strings and date stamps are enclosed by double quotation marks (").
-silent
Suppresses all output for the command. If you omit this parameter, output is included.
Command Aliases
You can run the following lsdev command aliases that are predefined by IBM®.
lsfabric
lsdev -fabric
lsperf
lsdev -perf
lssubsys
lsdev -subsys

Example: Listing all resources

The following command lists the GUIDs for all storage systems in the IBM Spectrum Control environment:
tpctool> lsdev -user me -pwd mypass -url myhost:myport -subsys
The following output is returned:
GUID
==============================
9.47.97.159:0000020065400048+0
9.47.97.161:0000020060C0002A+0
1750.13AAW2A+0
1750.13AB1WA+0
2107.1302541+0
2107.1301901+0
2105.22232+0
2105.20870+0

Example: Listing the long version of information

The following command lists the long version of information for fabrics.

tpctool> lsdev -user me -pwd mypass -url myhost:myport -fabric -l

The following output is returned:

GUID             Name             Type Status Timestamp
==================================================================
100000051E34F6A8 100000051E34F6A8 -    UNKNOWN 2004.12.31:00:00:00
10000060695130FD 1000006069514262 -    UNKNOWN 2004.12.31:00:00:00
1000006069514262 10000060695130FD -    UNKNOWN 2004.12.31:00:00:00