Queue Manager Manual

ENQ (UOW Code 502)
Queue Manager Server Interface
46517 Tandem Computers Incorporated 2–15
N Do not notify the Wait Manager.
The option not to notify the Wait Manager exists only to allow reduced overhead
for applications that do not need the Wait Manager. These applications must have
some other mechanism for deciding when to issue a DEQ request.
This field should always be set to Y unless the Wait Manager is not being used.
RESERVED-1 through RESERVED-7 are reserved for future use; these fields must
be set to N.
QUEUE-NAME
This is the name of the queue on which the entry is to be inserted. The name is
selected by the user.
PRIORITY
This affects the order in which entries are inserted on the queue for each value of
QUEUE-NAME. The field can contain an unsigned value ranging from 0 (lowest
priority) through 199 (highest priority). Higher numbers are processed (with a DEQ or
READQ request) before lower numbers.
DATA-BYTE-COUNT
This is the number of data bytes that are present in the request. The format of the data
in the queue entry supplied by ENQ should be defined by the application. This data
would immediately follow the DATA-BYTE-COUNT field and must be DATA-BYTE-
COUNT bytes. The maximum size for the data portion of the request is constrained by
the record size defined for the Queue file at configuration time. Refer to Section 4. A
sample format for the data portion would be:
02 data-field PIC X(100).
RETN-CODE
This is the return code. The server returns a code in this field to indicate one of the
following entries.
0 OK
4010 E-BAD-TRANSACTION 4085 E-DATA-TOO-LONG
4051 E-MUST-BE-YN 4924 E-ERR-QUEUE-FILE
4052 E-RESERVED-MUST-BE-N 4990 E-IO-TIMEOUT
4078 E-INVALID-PRIORITY 6006 E-WAITMANAGER-UNAVAIL
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.
TIME-OF-ENQ
This is the timestamp generated by the Entry Manager that makes the entry.