Procedure 14

Identify Volume

client identifier

capability

 

REQUEST

Requests that the volume loaded on the device currently allocated to the client's client identifier be examined for a valid standard volume label and a Mount Volume operation be automatically performed if one is found.

Client identifier identifies the device for the client and capability is the corresponding access key provided by the server for the device.
The current stream state for the stream must be dev_alloc otherwise the request will fail.

procedure status

RESPONSE

procedure status indicates the result of the request.

0

accepted

2

unknown client identifier for this client

7

stream is in the wrong state

8

capability is invalid

procedure status

If procedure status = accepted the current value of the stream status for this stream changes to dev_identifying.

When the identify operation has been completed successfully (which could take some time) then stream state for the stream changes to dev_mount and the label type and volume name found can be obtained using the Inquire Stream Status procedure.

Should the identify operation fail (for example no valid tape labels can be found) then stream state reverts to dev_alloc and procedure status is set appropiately.

Implementation

This procedure requests that the server examine the tape volume loaded into the drive allocated to the supplied identifier for a valid standard volume label. Acceptable volume labels are those which conform to the IBM or ANSI standards for tape labels. If a volume label is found the server records the name in the control table for the drive and the drive state changes to the mounted state as would be the result after a successful Mount Volume procedure. This procedure is invalid for the special devices FILE and SINK which should use the Mount Volume procedure.
The server logs the result of the procedure into the System Log recording the drive name and the volume name found.