Queue Manager Manual

READQ (UOW Code 504)
Queue Manager Server Interface
2–20 46517 Tandem Computers Incorporated
PAD-CHAR
This is the character to be used for padding the reply buffer when the actual data
length is less than MAX-DATA-SIZE.
RETN-CODE
This is the return code. The server returns a code in this field to indicate one of the
following entries.
0 OK
4001 W-EOF 4087 E-INVALID-MAX-DATASIZE
4051 E-MUST-BE-YN 4089 W-DATA-TRUNCATED
4052 E-RESERVED-MUST-BE-N 4924 E-ERR-QUEUE-FILE
4078 E-INVALID-PRIORITY 4990 E-IO-TIMEOUT
RETN-CODE-DETAIL
This is an error number returned by a subsystem other than the queue management
facility or is a further qualification of an error detected by the server.
DATA-LEN
This is the actual length of the data field before padding the reply buffer to MAX-
DATA-SIZE bytes in length. The format of the data in the queue entry returned by
READQ should be defined by the application. This data would immediately follow
the DATA-LEN field and be MAX-DATA-SIZE bytes. The maximum size for the data
portion of the response is constrained by the record size defined for the Queue file at
configuration time. See Section 4, “Installation and Management.” A sample format
for the data portion would be:
02 data-field PIC X(100).
READQ Operation READQ reads an entry from the named queue. The request returns either an entry
from the queue or an error. The error could be an indication there was nothing on the
queue.
The response always contains MAX-DATA-SIZE bytes of data immediately following
the DATA-LEN field. If the actual length of the data for the queue entry is less than
MAX-DATA-SIZE, or if an error occurs during processing, PAD-CHAR is used to fill
in the field.
The entry returned is the oldest entry from among those with the highest priority.