Queue Manager Manual

DEQ (UOW Code 501)
Queue Manager Server Interface
46517 Tandem Computers Incorporated 2–11
DEQ FIELDS The following fields are defined in this UOW.
HDR
This is the UOW header. The UOW-CODE value is 501.
FLAGS
FLAGS lets you qualify the search for a queue entry. Fields within FLAGS are as
follows:
SPECIFIC-DEQ specifies whether the PRIORITY, TIME-OF-ENQ, and CPU-PIN
fields are to be included in the search for the queue entry.
Y Include the PRIORITY, TIME-OF-ENQ, and CPU-PIN fields. The search
returns the entry requested provided the entry exists.
N Do not include the PRIORITY, TIME-OF-ENQ, and CPU-PIN fields.
The search returns the entry with the highest priority.
If more than one entry has the same PRIORITY, the search returns the entry with
the oldest TIME-OF-ENQ.
If more than one entry has the same PRIORITY and TIME-OF-ENQ, the search
returns the entry with the lowest CPU-PIN.
This field is typically set to N and is not used. The field is intended to be used
only when a process removes a queue entry that it added; presumably the
application no longer needs the entry. When the field is set to N, only the
PRIORITY field is checked for validity.
RESERVED-1 through RESERVED-7 are reserved for Tandem use; these fields
must be set to N.
QUEUE-NAME
This is the name of the queue from which the entry is to be dequeued. Input to this
field is echoed in the response.
PRIORITY
This field in the request is ignored if SPECIFIC-DEQ = N; the field is checked for
validity, however.
In the request, PRIORITY is the priority value to be used in the search.
In the response, PRIORITY is the priority value that was specified by the supplier
when it made the entry on the queue.
TIME-OF-ENQ
This in the request is ignored if SPECIFIC-DEQ is set to N.
In the request, TIME-OF-ENQ is the timestamp value to be used in the search.