Queue Manager Manual

WAITQ (UOW Code 505)
Queue Manager Server Interface
46517 Tandem Computers Incorporated 2–23
The Wait Manager has no way of knowing whether a process has canceled its wait
request. To ensure that an available waiting process is notified of a new arrival on a
queue, the Wait Manager replies to all processes waiting on the newly added queue
entry.
When a response to a WAITQ request audited by TMF contains error 4990
E-IO-TIMEOUT, the TMF transaction should be aborted.
Applications that expect to cancel the WAITQ request based on a timeout should use
the WAIT-TIMEOUT feature of this UOW. This allows the Wait Manager to reclaim
space in internal tables as soon as the waiting process no longer wants to be notified.
Another process can then access the Wait Manager.
The following rules apply to WAITQ:
Only one WAITQ UOW can appear in a request. If you specify more than one
UOW for the Wait Manager, the PW-REPLY-CODE is set to RQST-ERR (3) and the
IPC-RETN-CODE field is set to RQST-TOO-LONG (5).
The WAITQ UOW must be the only UOW in the request. The Wait Manager does
not process any portion of the message buffer after the WAITQ UOW.