TOPS-10 Monitor Calls Manual Volume 2 AA-K039D ... - Trailing-Edge

DEQ. [CALLI 152]
The error return is taken if you write the call in an incorrect
format, or if you do not have any pending requests or locks. On an
error return, the monitor returns an error code in the ac. You should
perform this function before EXITing; otherwise, when-you perform a
CLOSE, the function will fail but the nature of the failure will be
difficult to determine. The monitor automatically performs the .DEQDA
function when you issue a LOGOUT monitor call.
22.23.3 FUNCTION 2 (.DEQID)
This function requires the request-id in the right half of the ac.
Specify this function by placing the following information into the
ac:
[XWD
.DEQID,request-id]
The request-id is the request-identifier that you specify in the ENQ.
argument block. Refer to the ENQ. UUO for more information.
The monitor removes all requests of yours with the specified
request-id from resource queues, and it dissolves all locks of yours
with the specified request-id. You should specify this function when
you are dequeueing requests that were made in the same ENQ. argument
block. The error return is taken if you have set up the call
incorrectly, if you have no pending requests, or if you are not the
owner of a resource.
SKIP RETURN
The specified requests are dequeued and the specified locks are
dissolved.
ERROR RETURN
If an error is found in one of the requests in a multiple request DEQ.
monitor call, the error return is taken and the monitor returns an
error code in the ac. However, the ENQ/DEQ facility continues
processing until all of the dequeue requests have been performed.
Therefore, the monitor will have dequeued all valid requests whether
or not an error resulted from another request in the same monitor
call. If errors are found in several requests of the same monitor
call, the error code returned in the ac reflects the last error fo~nd.
If you specify that you want to dequeue a request or dissolve a lock
associated with a pooled resource, the monitor will return an error
code if you attempt to dequeue more resources ·than you own wi thin the
pool. However, you can dequeue a subset of those resources that you
own within a pool, still retaining ownership of those you did not
dequeue. Therefore, you cannot dequeue more resources than you own,
but you do not have to dequeue all that you own in one request.
The error codes for the DEQ. call are identical to those of the ENQ.
call. They are listed in the description of the ENQ. call.
22-51