HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_SEND_ERROR and SEND_ERROR
This parameter is used only by the basic-conversation SEND_ERROR verb.
Possible values are:
AP_PROG
The error is to be reported to an application program that does not use Syncpoint. This value causes
APPC to send one of the following return codes to the partner TP:
•
AP_PROG_ERROR_TRUNC (if the SEND_ERROR verb is issued in Send state after sending part of
a logical record)
•
AP_PROG_ERROR_NO_TRUNC
(if the MC_SEND_ERROR verb is issued in Send state, or if the
SEND_ERROR verb is issued in Send state but an incomplete logical record has not been sent)
•
AP_PROG_ERROR_PURGING
(if the verb is issued in any state other than Send)
AP_SVC
The error is to be reported to a service program. This value is used only by the SEND_ERROR verb.
This value causes APPC to send one of the following return codes to the partner TP:
•
AP_SVC_ERROR_TRUNC (if the SEND_ERROR verb is issued in Send state after sending part of a
logical record)
•
AP_SVC_ERROR_NO_TRUNC (if the SEND_ERROR verb is issued in Send state but an incomplete
logical record has not been sent)
•
AP_SVC_ERROR_PURGING (if the SEND_ERROR verb is issued in any state other than Send)
UNIX
AP_BACKOUT_NO_RESYNC
This value is allowed only if the conversation’s synchronization level is AP_SYNCPT. The local TP
(or another TP participating in the same logical unit of work) has issued a BACKOUT request; the
local TP has completed backing out its resources. The Syncpoint Manager is responsible for issuing
[MC_]SEND_ERROR with this value set when it receives the BACKOUT request. This value causes
APPC to send the primary and secondary return codes
AP_BACKED_OUT and AP_BO_NO_RESYNC to the
partner TP.
AP_BACKOUT_RESYNC
This value is allowed only if the conversation’s synchronization level is AP_SYNCPT. The local TP (or
another TP participating in the same logical unit of work) has issued a backout request; resynchronization
is still in progress. The Syncpoint Manager is responsible for issuing [MC_]SEND_ERROR with this
value set when it receives the BACKOUT request. This value causes APPC to send the primary and
secondary return codes
AP_BACKED_OUT and
AP_BO_RESYNC to the partner TP.
err_dir
Indicates whether the error being reported is in the data received from the partner TP, or in the data the local
TP was about to send.
In a full-duplex conversation, this parameter must be set to AP_SEND_DIR_ERROR. In a half-duplex
conversation, this parameter is used only when the [MC_]SEND_ERROR verb is being issued in Send_Pending
state.
Possible values are:
AP_RCV_DIR_ERROR
227