lsarray

Use the lsarray command to display information about arrays and back-end storage systems. For SAN Volume Controller, XIV® systems, and Dell EMC VMAX and VNX storage systems, the command displays information about block pools.You use the setarray command or autosetarray command to provide information about back-end storage systems. You can also enter information about back-end storage systems on the Pool Properties page in the IBM Spectrum Control™ GUI.

Syntax


1  tpctool lsarray  -user  user_name -pwd  password   -url  url  -dev system?  -l?  -fs  character?  -header ?  -help?  -qs  character?   -silent?  -grouping

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.
-dev system
Specifies the globally unique identifier (GUID) of the storage system. You can use the lsdev command to return information, including the GUID, for all storage systems that are discovered by IBM Spectrum Control.
-l
Specifies that the detailed version of information about arrays is provided. If you issue the lsarray command and do not specify the -l parameter, only the array ID is displayed.
Column label Details
Array The ID of the array.
Label The name of the storage pool (managed disk group).
Total Size (GB) The total amount of storage space.
Free Size (GB) The total amount of available storage space.
Status The operational status of the storage pool that hosts the array.
Types of Disk The types of disk that host the arrays.
  • Solid State for solid-state disks
  • Non-Solid State for hard disks
  • Mixed for solid-state disks and hard disks
Encrypted Shows whether arrays are hosted on encrypted disks.
Read I/O Capability Shows the read I/O capability in seconds of storage arrays. The calculation of read I/O capability is based on the following characteristics.
  • The type of storage system
  • The type of RAID
  • The type of disk
  • The number of disks
Back-end Type The type of back-end storage system that manages disk group storage.
Back-end RAID Type The type of Redundant Array of Independent Disk (RAID) that the back-end storage system uses.
Back-end Disk Type The type of disk that the back-end storage system uses.
Back-end Disk Count The total number of disks.
Tip: To find out how to set values for back-end storage subsystems, see the description of the setarray command.
-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.
-grouping
Enables the grouping of numeric values. For example, in English the value 12000 would display as 12,000. The grouping character is determined by the system locale.

Example: Listing array information

The following command lists IDs for the arrays on the specified system:

tpctool> lsarray -user me -pwd mypass -url myhost:9550 -dev 2107.75DG000+0

The following output is returned:

Array                        
===========================================
IBMTSDS:IBM.2107-75DG000-P17+2107.75DG000+0
IBMTSDS:IBM.2107-75DG000-P16+2107.75DG000+0
IBMTSDS:IBM.2107-75DG000-P15+2107.75DG000+0
IBMTSDS:IBM.2107-75DG000-P14+2107.75DG000+0
IBMTSDS:IBM.2107-75DG000-P1+2107.75DG000+0 
IBMTSDS:IBM.2107-75DG000-P0+2107.75DG000+0 

Example: Listing detailed information about an array

The following command provides detailed information about the array on the specified system:

tpctool> lsarray -dev 0000020064405BA0+0 -l

The following output is returned:

Array                                 Label      Total Size (GB) Free Size (GB)  
==============================================================================
0000020064405BA0:0+0000020064405BA0+0 mdisk_grp  407.38          310.25       

Status  Types of Disk     Encrypted Read I/O Capability Back-end Type 
=============================================================================
NORMAL  Non-Solid State   No        0                   D                  

Back-end RAID Type Back-end Disk Type Back-end Disk Count
===========================================================
5                  F10                160