Queue Manager Manual

READQ (UOW Code 504)
Queue Manager Server Interface
46517 Tandem Computers Incorporated 2–19
REPOSITION is used for sequential reading of a specific queue or the entire Queue
file. Setting this flag to Y after the initial read informs the Entry Manager that the
values in the four fields QUEUE-NAME, PRIORITY, TIME-OF-ENQ, and CPU-
PIN are being supplied based on the result of a previous READQ request.
To read sequentially from the beginning of a specified queue or from the
beginning of the Queue file:
1. Set SKIP-EXACT and REPOSITION to N.
2. Set the four ANY- flags as desired.
3. Set corresponding fields of ANY- flags as appropriate.
For subsequent sequential reads:
1. Set SKIP-EXACT and REPOSITION to Y.
2. Let ANY- flags remain at their same settings.
3. Copy all fields from the previous READQ response into the UOW for the next
request.
An end-of-file warning indicates the end of the group has been reached.
RESERVED-6 and RESERVED-7 are reserved for Tandem use; these fields must be
set to N.
QUEUE-NAME
This in the request is the name of the queue to which the read is restricted. QUEUE-
NAME in the response is the name of the queue from which the entry was taken.
PRIORITY
This in the request is the priority value to which the read is restricted. PRIORITY in
the response is the value specified by the application that made the queue entry.
TIME-OF-ENQ
This in the request is the Entry Manager timestamp to which the read is restricted.
TIME-OF-ENQ in the response is the timestamp generated by the Entry Manager that
made the queue entry.
CPU-PIN
This in the request is the Entry Manager CPU PIN to which the read is restricted.
CPU-PIN in the response is the CPU PIN of the Entry Manager that made the queue
entry.
MAX-DATA-SIZE
This is the maximum number of bytes to be returned.