SNAX/APC Application Programming Manual

Interprocess Communications and Units of Work
SNAX/APC Application Programming Manual—138786
2-17
UOW Return Codes
The individual fields in the standard UOW reply header contain the following
information:
REP-UOW-ID
This field contains the value ST, identifying the beginning of a UOW.
REP-VERB-CODE
This field contains a value identifying the type of verb request UOW to which this
reply corresponds. For example, if the verb request UOW is an ALLOCATE verb
(code 1001), the reply UOW header also contains 1001.
REP-RETURN-CODE
This field indicates success or failure of the associated verb request UOW. This
field is used for allocation-error and parameter-error details. This multiple-redefined
field contains specific information about certain return codes. The return codes are
described below. Table 2-4 at the end of this section indicates the following return
codes generated by specific conversational verbs:
REP-RETURN-CODE-DETAIL
ALLOCATION-ERROR-DETAIL
DEALLOCATE-ABEND-DETAIL
PARAMETER-ERROR-DETAIL
PROGRAM-STATE-CHECK-DETAIL
UOW Return Codes
Table 2-3 describes the return codes that can be returned in the REP-RETURN-CODE
field of a UOW reply header.
Table 2-3. UOW Return Codes (page 1 of 4)
Value Label Meaning
0 RC-OK The UOW completed successfully.
1001 RC-ALLOCATION-
ERROR
The allocation of a conversation could not complete
successfully. Note that an allocation error can be
returned on a subsequent verb after an ALLOCATE
verb request. Verbs that flush the send buffer can
receive an allocation error if the remote TP is
unavailable. Use the REP-RETURN-CODE-
DETAIL field to determine the reason for the
allocation error.
1002 RC-DEALLOCATE-
ABEND-PROG
The conversation was terminated by the remote TP
or SNAX/APC because it detected an error that
would not allow successful completion of the
conversation. Use the REP-RETURN-CODE-
DETAIL field to determine the reason for the
deallocation.