Queue Manager Manual

UOWs and UOW Formats
Queue Manager Server Interface
2–4 46517 Tandem Computers Incorporated
Individual fields in the IPC header can contain the following information:
REQUEST-CODE
In a Request to the Server. Your application sets this field to indicate request processing
conditions. In the request, this field always contains a value less than zero, as follows:
STOP-ON-WARNING (-1) stops the processing if a UOW warning indication is
encountered. Warnings imply successful completion of the UOW in which they
occur.
STOP-ON-ERR (-2) stops the processing if a UOW error occurs. Errors imply that
the UOW was not processed successfully.
DO-ALL-UOWS (-3) requests processing of all UOWs in the request. Processing
halts only if a request error, as defined by the RQST-ERR value, or a system error
occurs.
PW-REPLY-CODE
In a Reply from the Server. The REQUEST-CODE field is redefined as the PW-REPLY-
CODE field. This field contains a value that indicates request processing results. In
the reply, this field always contains a value of zero or greater, as follows:
ALL-UOWS-OK (0) indicates that all UOWs in the request were processed
successfully.
UOWS-WITH-WARNING (1) indicates that warning indications were
encountered in one or more UOWs. If STOP-ON-WARNING was not specified in
the REQUEST-CODE field, all UOWs in the request have a corresponding
response UOW in the reply. If STOP-ON-WARNING was specified, only those
UOWs preceding and including the first with a warning indication have
corresponding response UOWs.
UOWS-WITH-ERR (2) indicates that errors were detected in one or more UOWs.
If neither STOP-ON-ERR nor STOP-ON-WARNING was specified in the
REQUEST-CODE field, all UOWs in the request have a corresponding response
UOW. If STOP-ON-ERR or STOP-ON-WARNING was specified, only those
UOWs preceding and including the first with an error have corresponding
response UOWs. If STOP-ON-ERR is specified in the request, the UOWs
preceding the first with an error might return warning indications.
RQST-ERR (3) indicates one of the following two error conditions:
An error in the data in the IPC header occurred and the error is not specific to any
particular UOW.
An error in the range from 4900 to 5000 occurred in a UOW, earlier UOWs in the
IPC message were processed successfully, and additional information about the
error is stored in the IPC-RETN-CODE field.