Procedure 7

Inquire Device Status

client identifier

capability

 

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.

success = 0

device type length

device type

 

tape length

tape remaining

tape i/o errors

tape i/o error percentage

information length

 

information

 

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.

length

device sense data

length

device mode sense data

length

device inquiry data

information

procedure status

RESPONSE - failure

procedure status which is non-zero indicates the cause of the failure.

2

unknown client identifier for this client

8

capability is invalid

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.