Procedure 12

Inquire Stream Status

client identifier

capability

 

REQUEST

Returns information 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

last procedure status

current stream state

information length

information

 

device name length

device name

 

real device name length

real device name

 

volume name length

volume name

 

file name length

file name

 

access mode

label type

record length

block length

spare

spare

spare

spare

spare

block count

byte count

data rate

RESPONSE - success

This procedure does not change the value of procedure status and is permitted for any stream state.

Information may contain a text message to explain further the reason for any error state indicated by procedure status. Information length must be zero if no message is available.

The field device name is that specified in the allocate device procedure and the field real device name is that returned by the procedure.

The field volume name is that specified in the mount volume procedure.

The fields file name, access mode, record length and block length are those specified in the open file procedure.

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 information about the status and use of the data file implied by the supplied identifier. Information supplied by the Allocate Device, Mount or Identify Volume and Open File procedures for this identifier is returned.The spare fields are currently not used and should be returned as -1. The block count and byte count are related to data written to this device since the last Open File procedure. The data rate is the number of bytes/sec wriiten averaged over the last 10 seconds.