Queue Manager Manual

Queue Manager UOW Descriptions
Queue Manager Server Interface
2–8 46517 Tandem Computers Incorporated
information produced by DDL when generating COBOL. The primary additions
are prefixes for all field names and many level 88 declarations for fields.
GPQDDL contains DDL code that is used to create definitions for use when
programming in a language other than SCREEN COBOL or COBOL. GPQDDL
code does not exactly match the DDL syntax shown in this manual, but it should
be immediately obvious how to interpret any differences.
UOW Header and Return
Code
Information is transmitted to the Entry Manager and Wait Manager servers through
UOWs issued within requests. Information transmitted by a UOW is moved into the
individual fields of the UOW by your program. Information returned in a UOW
response is entered in the individual fields of the response by the servers.
Each UOW transmitted to the servers begins with a UOW header. The DDL definition
for this header is:
DEF uow-hdr.
02 self-ident PIC AA VALUE “UW”.
02 uow-code TYPE BINARY 16 UNSIGNED.
END.
Individual fields in the UOW header contain the following information:
SELF-IDENT always contains the characters UW to identify the header as a UOW
header.
UOW-CODE is a code value that identifies the specific UOW request being made.
Each response UOW returned from the servers begins with the same header as the
request, followed by two fields dealing with return codes.
Individual fields in the response UOW header contain the following additional
information:
UOW-RETN-CODE is the return code.
If no errors were encountered, this field is set to 0.
If an error occurred, the field contains a positive value. A positive value
indicates the UOW was not processed.
If a warning was indicated, the field contains a negative value. A negative
value indicates the UOW was successfully processed. However, the response
may not contain the information expected.
In the RETN-CODE field for each UOW, entries that begin with E denote
errors returned to your process by the server, and entries that begin with W
denote warnings. All possible entries are listed for each UOW. These errors
are summarized at the end of this section.
RETN-CODE-DETAIL is a code that primarily identifies an error detected by a
subsystem other than the Queue Manager facility, such as the GUARDIAN 90
operating system or the EXPAND network software, and for which the queue