lsdasd - List DASD devices

6.10 LPAR mode z/VM guest KVM guest

Use the lsdasd command to gather information about DASD devices from sysfs and display it in a summary format.

lsdasd syntax

Read syntax diagramSkip visual syntax diagram lsdasd -a -b -s -v -l -c -u -H <device_bus_id>

Where:

-a or --offline
includes devices that are currently offline.
-b or --base
omits PAV alias devices. Lists only base devices.
-s or --short
strips the bus ID in the command output down to the four-digit device number.
-v or --verbose
Obsolete. This option has no effect on the output.
-l or --long
extends the output to include attributes, the UID, and path information.
-c or --compat
creates output of this command as with versions earlier than 1.7.0.
-u or --uid
includes and sorts output by UID.
-H or --host_access_list
shows information about all operating system instances that use this device.
<device_bus_id>
limits the output to information about the specified devices only.
--version
displays the version of the command.
-h or --help
displays out a short help text, then exits. To view the man page, enter man lsdasd.

Examples

  • The following command lists all DASD (including offline DASDS):
    # lsdasd -a
    Bus-ID      Status     Name     Device     Type    BlkSz     Size       Blocks
    ==============================================================================
    0.0.0190    offline
    0.0.0191    offline
    0.0.019d    offline
    0.0.019e    offline
    0.0.0592    offline
    0.0.4711    offline
    0.0.4712    offline
    0.0.4f2c    offline
    0.0.4d80    active    dasda     94:0       ECKD    4096     4695MB       1202040
    0.0.4f19    active    dasdb     94:4       ECKD    4096    23034MB       5896800
    0.0.4d81    active    dasdc     94:8       ECKD    4096     4695MB       1202040
    0.0.4d82    active    dasdd     94:12      ECKD    4096     4695MB       1202040
    0.0.4d83    active    dasde     94:16      ECKD    4096     4695MB       1202040
  • The following command shows information only for the DASD with device number 0x4d80 and strips the bus ID in the command output down to the device number:
    # lsdasd -s 0.0.4d80
    Bus-ID      Status    Name       Device    Type     BlkSz    Size       Blocks
    ==============================================================================
    4d80        active    dasda      94:0      ECKD     4096     4695MB     1202040
  • The following command shows only online DASDs in the format of lsdasd versions earlier than 1.7.0:
    # lsdasd -c
    0.0.4d80(ECKD) at ( 94: 0) is dasda : active at blocksize 4096, 1202040 blocks, 4695 MB
    0.0.4f19(ECKD) at ( 94: 4) is dasdb : active at blocksize 4096, 5896800 blocks, 23034 MB
    0.0.4d81(ECKD) at ( 94: 8) is dasdc : active at blocksize 4096, 1202040 blocks, 4695 MB
    0.0.4d82(ECKD) at ( 94: 12) is dasdd : active at blocksize 4096, 1202040 blocks, 4695 MB
    0.0.4d83(ECKD) at ( 94: 16) is dasde : active at blocksize 4096, 1202040 blocks, 4695 MB
  • The following command shows the device geometry, UID, path information, and some of the settings for the DASD with device bus-ID 0.0.4d82:
    # lsdasd -l 0.0.4d82
    0.0.4d82/dasdd/94:12
      status:                             active
      type:                               ECKD
      blksz:                              4096
      size:                               4695MB
      blocks:                             1202040
      extent_size:                        1113  
      logical_capacity:                   262668                    
      space_allocated:                    262668
      use_diag:                           0
      readonly:                           0
      eer_enabled:                        0
      erplog:                             0
      hpf:                                1
      uid:                                IBM.75000000010671.4d82.16
      fc_security:                        Encryption
      paths_installed:                    30 31 32 33 3c 3d
      paths_in_use:                       31 32 33
      paths_non_preferred:
      paths_invalid_cabling:              3c
      paths_cuir_quiesced:                30 
      paths_invalid_hpf_characteristics:  3d
      paths_error_threshold_exceeded:     
    In the example, three of the installed paths are unused for different reasons:
    • The path with CHPID 3c is not used because of a cabling error to the storage system. This channel path does not connect to the same physical disk space as the other channel path for this device.
    • The path with CHPID 30 is not used because of a control-unit initiated reconfiguration (CUIR).
    • The path with CHPID 3d is not used because its High Performance FICON® characteristics do not match with the paths currently in use.
  • The following command shows whether other operating system instances access device 0.0.bf45:
    # lsdasd -H bf45
    Host information for 0.0.bf45
    Path-Group-ID          LPAR  CPU   FL  Status  Sysplex      Max_Cyls        Time
    ================================================================================
    88000d29e72964ce8570b8 0d    29e7  50  ON      TRX1LNX1    268434453           0
    88000e29e72964ce8570c3 0e    29e7  50  ON                  268434453           0
    88000f29e72964ce8570d1 0f    29e7  50  ON                  268434453           0
    88011d29e72964ce8570d4 1d    29e7  50  ON                  268434453           0
    88011e29e72964ce8570d9 1e    29e7  50  ON                  268434453           0
    88011f29e72964ce8570e3 1f    29e7  50  ON                  268434453           0
    88022d29e72964ce8570e6 2d    29e7  50  ON                  268434453           0
    88022e29e72964ce8570ea 2e    29e7  50  ON                  268434453           0
    88022f29e72964ce8570f1 2f    29e7  50  ON                  268434453           0
    88033d29e72964ce8570f7 3d    29e7  50  ON                  268434453           0
    88033e29e72964ce8570fe 3e    29e7  50  ON                  268434453           0
    88033f29e72964ce85710e 3f    29e7  50  ON                  268434453           0
    80004229e72964ce7dce74 42    29e7  00  OFF                     65520           0
    80004a29e72964ce7db60d 4a    29e7  00  OFF                     65520           0
    80003c29e72964ce8481a6 3c    29e7  00  OFF                     65520           0
    80004629e72964ce7f1c13 46    29e7  70  ON-RSV                  65520  1424174863
    Status values are:
    ON
    The device is online.
    OFF
    The device is offline.
    ON-RSV
    The device is online and reserved.
    OFF-RSV
    The device is offline and reserved by an operating system instance in another LPAR.
    The meaning of the columns is as follows:
    Path-group-ID
    A 22-digit hexadecimal number assigned by the operating system when setting the DASD online. This ID uniquely identifies the operating system to the storage server.
    LPAR
    A 2-digit LPAR ID.
    CPU
    A 4-digit CPU ID, as it is defined in the HMC or can be read from /proc/cpuinfo.
    FL
    A 2-digit hexadecimal flag. 0x20 means reserved, 0x50 means online.
    Sysplex
    The 8-character EBCDIC name of the SYSPLEX.
    MAX_CYLS
    The maximum number of cylinders per volume that are supported by the host.
    TIME
    Time the device has been reserved in seconds since July 1, 1970.
  • In this example, first all DASDs are listed, then the details for a thinly provisioned DASD, marked as ESE, is listed:
    # lsdasd                                                              
    Bus-ID    Status    Name      Device  Type         BlkSz  Size      Blocks      
    ================================================================================
    0.0.95e0  alias                       ECKD                                      
    0.0.95e1  alias                       ECKD                                      
    0.0.3300  active    dasda     94:0    ECKD         4096   21129MB   5409180     
    0.0.95d0  active    dasdb     94:4    ECKD (ESE)   4096   42259MB   10818360    
    0.0.95d1  n/f       dasdc     94:8    ECKD (ESE)                                
    # lsdasd -l 95d0                                        
    0.0.95d0/dasdb/94:4                                               
      status:                               active                    
      type:                                 ECKD (ESE)                
      blksz:                                4096                      
      size:                                 42259MB                   
      blocks:                               10818360                  
      extent_size:                          1113                      
      logical_capacity:                     60102                     
      space_allocated:                      27825                     
      use_diag:                             0                         
      readonly:                             0                         
      eer_enabled:                          0                         
      erplog:                               0                         
      hpf:                                  1                         
      uid:                                  IBM.750000000ABT31.9500.d0
      fc_security:                          Encryption
      paths_installed:                      38 39 3a 3b               
      paths_in_use:                         38 39 3a 3b               
      paths_non_preferred:                                            
      paths_invalid_cabling:                                          
      paths_cuir_quiesced:                                            
      paths_invalid_hpf_characteristics:                              
      paths_error_threshold_exceeded: