Procedure 10

Deallocate Device

client identifier

capability

 

REQUEST

Deallocates the device currently allocated to the 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.
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

request sucessfully executed

2

unknown client identifier for this client

7

stream is in the wrong state

8

capability is invalid

procedure status

If procedure status = success the current value of the stream status for this stream changes to undefined.The server invalidates the client identifier and no further actions are permitted on the device.

Implementation

This procedure reverses the action of a previous Allocate Device procedure (procedure 23). The device must be in the allocated state (that is there must not be a tape currently loaded).
The server returns the device to its free list for use by a subsequent Allocate Device request. The server logs the result of the procedure into the System Log recording the client identifier and real device name.