Displaying DASD information

Use tools to display information about your DASDs, or read the attributes of the devices in sysfs.

About this task

There are several methods to display DASD information:

Use lsdasd -l to display summary information about the device settings and the device geometry of multiple DASDs.
Use dasdview to display details about the contents of a particular DASD.
Read information about a particular DASD from sysfs, as described in this section.

The sysfs representation of a DASD is a directory of the form /sys/bus/ccw/devices/<device_bus_id>, where <device_bus_id> is the bus ID of the DASD. This sysfs directory contains a number of attributes with information about the DASD.

Table 1. Attributes with DASD information
Attribute	Explanation
alias	`1` if the DASD is a parallel access volume (PAV) alias device. `0` if the DASD is a PAV base device or has not been set up as a PAV device. For an example of how to use PAV see How to Improve Performance with PAV, SC33-8414 on developerWorks® at www.ibm.com/developerworks/linux/linux390/documentation_suse.html This attribute is read-only.
discipline	Indicates the base discipline, ECKD or FBA, that is used to access the DASD. If DIAG is enabled, this attribute might read DIAG instead of the base discipline. This attribute is read-only.
eer_enabled	`1` if the DASD is enabled for extended error reporting, `0` if it is not enabled (see Using extended error reporting for ECKD type DASD).
erplog	`1` if error recovery processing (ERP) logging is enabled, `0` if ERP logging is not enabled (see Enabling and disabling logging).
expires	Indicates the time, in seconds, that the DASD device driver waits for a response to an I/O request from a storage server. If this time expires, the device driver considers a request as failed and cancels it (see Setting the timeout for I/O requests).
failfast	`1` if I/O operations are returned as failed immediately when the last path to the DASD is lost. `0` if a wait period for a path to return expires before an I/O operation is returned as failed. (see Enabling and disabling immediate failure of I/O requests).
host_access_count	Shows how many operating system instances have access to the device. See Checking for access by other operating system instances.
hpf	`1` if High Performance FICON is available for the device. See Querying the HPF setting of a channel path.
last_known_reservation_state	The reservation state as held by the DASD device driver. Values can be: none The DASD device driver has no information about the device reservation state. reserved The DASD device driver holds a valid reservation for the DASD. lost The DASD device driver had reserved the device, but this reservation has been lost to another system. See Reading and resetting the reservation state for details.
online	`1` if the DASD is online, `0` if it is offline (see Setting a DASD online or offline).
path_autodisable path_interval path_threshold	Control the automatic removal of defective channel path (see Setting defective channel paths offline automatically)
raw_track_access	`1` if the DASD is in raw-track access mode, `0` if it is in default access mode (see Accessing full ECKD tracks).
readonly	`1` if the DASD is read-only, `0` if it can be written to. This attribute is a device driver setting and does not reflect any restrictions that are imposed by the device itself. This attribute is ignored for PAV alias devices.
reservation_policy	Shows the reservation policy of the DASD. Possible values are `ignore` and `fail`. See Handling lost device reservations for details.
status	Reflects the internal state of a DASD device. Values can be: unknown Device detection has not started yet. new Detection of basic device attributes is in progress. detected Detection of basic device attributes has finished. basic The device is ready for detecting the disk layout. Low-level tools can set a device to this state when changing the disk layout, for example, when formatting the device. unformatted The disk layout detection found no valid disk layout. The device is ready for use with low-level tools like dasdfmt. ready The device is in an intermediate state. online The device is ready for use.
timeout	Indicates the time, in seconds, within which the DASD device driver must respond to an I/O request from a software layer above it. If the specified time expires before the request is completed, the DASD device driver cancels all related low-level I/O requests to storage systems and reports the request as failed (see Setting the timeout for I/O requests).
uid	A device identifier of the form `<vendor>`.`<serial>`.`<subsystem_id>`.`<unit_address>`.`<minidisk_identifier>` where `<vendor>` is the specification from the vendor attribute. `<serial>` is the serial number of the storage system. `<subsystem_id>` is the ID of the logical subsystem to which the DASD belongs on the storage system. `<unit_address>` is the address that is used within the storage system to identify the DASD. `<minidisk_identifier>` is an identifier that the z/VM® system assigns to distinguish between minidisks on the DASD. This part of the uid is only present for Linux on z/VM and if the z/VM version and service level support this identifier. This attribute is read-only.
use_diag	`1` if the DIAG access method is enabled, `0` if the DIAG access method is not enabled (see Enabling the DASD device driver to use the DIAG access method). Do not enable the DIAG access method is for PAV alias devices.
vendor	Identifies the manufacturer of the storage system that contains the DASD. This attribute is read-only.

There are some more attributes that are common to all CCW devices (see Device attributes).

Procedure

Issue a command of this form to read an attribute:

# cat /sys/bus/ccw/devices/<device_bus_id>/<attribute>

where <attribute> is one of the attributes of Table 1.

Example

The following sequence of commands reads the attributes for a DASD with a device bus-ID 0.0.b100:

# cat /sys/bus/ccw/devices/0.0.b100/alias
0
# cat /sys/bus/ccw/devices/0.0.b100/discipline
ECKD
# cat /sys/bus/ccw/devices/0.0.b100/eer_enabled
0
# cat /sys/bus/ccw/devices/0.0.b100/erplog
0
# cat /sys/bus/ccw/devices/0.0.b100/expires
30
# cat /sys/bus/ccw/devices/0.0.b100/failfast
0
# cat /sys/bus/ccw/devices/0.0.b100/host_access_count
1
# cat /sys/bus/ccw/devices/0.0.b100/hpf
1
# cat /sys/bus/ccw/devices/0.0.b100/last_known_reservation_state
reserved
# cat /sys/bus/ccw/devices/0.0.b100/online
1
# cat /sys/bus/ccw/devices/0.0.b100/path_autodisable
1
# cat /sys/bus/ccw/devices/0.0.b100/path_interval
300
# cat /sys/bus/ccw/devices/0.0.b100/path_threshold
256
# cat /sys/bus/ccw/devices/0.0.b100/raw_track_access
0
# cat /sys/bus/ccw/devices/0.0.b100/readonly
1
# cat /sys/bus/ccw/devices/0.0.b100/reservation_policy
ignore
# cat /sys/bus/ccw/devices/0.0.b100/status
online
# cat /sys/bus/ccw/devices/0.0.b100/timeout
120
# cat /sys/bus/ccw/devices/0.0.b100/uid
IBM.75000000092461.e900.8a
# cat /sys/bus/ccw/devices/0.0.b100/use_diag
1
# cat /sys/bus/ccw/devices/0.0.b100/vendor
IBM