HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_PREPARE_TO_RECEIVE and PREPARE_TO_RECEIVE
AP_MAPPED_CONVERSATION
For the MC_PREPARE_TO_RECEIVE verb.
AP_BASIC_CONVERSATION
For the PREPARE_TO_RECEIVE verb.
If the verb is being issued as a non-blocking verb, combine the value above (using a logical OR) with the
value AP_NON_BLOCKING.
tp_id
Identifier for the local TP.
The value of this parameter was returned by the TP_STARTED verb in the invoking TP or by RE-
CEIVE_ALLOCATE in the invoked TP.
conv_id
Conversation identifier.
The value of this parameter was returned by the [MC_]ALLOCATE verb in the invoking TP or by
RECEIVE_ALLOCATE in the invoked TP.
ptr_type
Specifies how to perform the state change.
Possible values are:
AP_FLUSH
Sends the contents of the local LU’s send buffer to the partner LU (and TP) before changing the
conversation’s state to Receive.
UNIX
AP_CONFIRM_TYPE
Use this value only if the conversation’s synchronization level is AP_SYNCPT. It indicates that
confirmation from the partner TP (but not syncpoint processing) is required before changing the
conversation’s state to Receive.
APPC sends the contents of the local LU’s send buffer and a confirmation request to the partner TP.
The conversation state does not change to Receive until the partner TP sends the requested confirmation
(or reports an error).
AP_SYNC_LEVEL
Uses the conversation’s synchronization level (established by the [MC_]ALLOCATE verb) to determine
how to perform the state change.
If the synchronization level of the conversation is AP_NONE, APPC sends the contents of the local
LU’s send buffer to the partner TP before changing the conversation’s state to Receive.
If the synchronization level is AP_CONFIRM_SYNC_LEVEL, APPC sends the contents of the local
LU’s send buffer and a confirmation request to the partner TP. Upon receiving confirmation from the
partner TP, APPC changes the conversation’s state to Receive. If, however, the partner TP reports an
error, the state changes to Receive or Reset; see Section 4.8.8,
State Change.
UNIX
If the synchronization level of the conversation is AP_SYNCPT, APPC sends the contents of the local
LU’s send buffer to the partner TP before changing the conversation state. The Syncpoint Manager is
responsible for the following:
153