Procedure 7 |
Inquire Device Status |
REQUEST Returns information on the state of the device in use for this client's client identifier. |
Client identifier identifies the device for the client and capability is the corresponding access key provided by the server for the device.
RESPONSE - success The field device type is the generic name assigned to the device and may be used to interpret the data which follows. The fields tape length and tape remaining are in units which are dependent on device type. The field tape i/o error percentage is expressed in units of 0.1%. The value -1 indicates that the information cannot be supplied for this device. Information is further device specific status which may have information length =0 if none is available or can be obtained. |
For SCSI devices the information field contains data returned by the SCSI Request Sense, Mode Sense and Inquiry commands.
information |
RESPONSE - failure procedure status which is non-zero indicates the cause of the failure. |
procedure status |
Implementation
This procedure returns status information about the real device implied by the supplied
client identifier. Since much of the information returned is device specific the generic
device name (e.g. EXB-8500 for Exabyte 8500, Exabyte 8505 and similar devices) is returned.
The important information which should be returned is the length of the tape, the length of
the tape remaining to be written, the number of (recovered) i/o errors and the number of i/o
errors expressed as a percentage of the total number of data blocks written. If any of these
items cannot be obtained then the value -1 may be returned. The percentage i/o error rate is
returned in units of 0.1% and is averaged over the preceeding 10 seconds.
For SCSI devices the device specific data returned by the device in response to SCSI Request Sense,
Mode Sense and Inquiry commands is also returned if possible.