HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_PREPARE_TO_RECEIVE and PREPARE_TO_RECEIVE
• Intercepting the [MC_]PREPARE_TO_RECEIVE verb when a ptr_type of AP_SYNC_LEVEL is
specified
• Performing the required syncpoint processing
• Passing the original [MC_]PREPARE_TO_RECEIVE verb through to SNAplus2 when syncpoint
processing has completed
When SNAplus2 receives the [MC_]PREPARE_TO_RECEIVE verb with a ptr_type of
AP_SYNC_LEVEL on a conversation with sync_level of AP_SYNCPT, it assumes that the Syncpoint
Manager has already performed all the necessary syncpoint processing, and processes the verb as for a
sync_level of AP_NONE.
locks
Specifies when APPC is to return control to the local TP.
Use this parameter only if ptr_type is set to AP_SYNC_LEVEL and the synchronization level of the
conversation, established by the [MC_]ALLOCATE verb is AP_CONFIRM_SYNC_LEVEL. (Otherwise, the
parameter is ignored.)
Possible values are:
AP_LONG
APPC returns control to the local TP when the confirmation and subsequent data from the partner TP
arrive at the local LU. (This method results in more efficient use of the network but requires longer to
return control to the local TP.)
AP_SHORT
APPC returns control to the local TP when the confirmation from the partner TP arrives at the local
LU.
4.8.6 Returned Parameters
After the verb executes, APPC returns parameters to indicate whether the execution was successful and, if not, to
indicate the reason the execution was not successful.
Successful Execution
If the verb executes successfully, APPC returns the following parameter:
primary_rc
AP_OK
Unsuccessful Execution
If the verb does not execute successfully, APPC returns a primary return code parameter to indicate the type of
error and a secondary return code parameter to provide specific details about the reason for unsuccessful execution.
Parameter Check
If the verb does not execute because of a parameter error, APPC returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
Possible values are:
AP_BAD_CONV_ID
154