HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_ALLOCATE and ALLOCATE
This parameter determines whether the TPs can request confirmation of receipt of data and confirm receipt
of data. Possible values are:
AP_NONE
Confirmation processing will not be used in this conversation.
AP_CONFIRM_SYNC_LEVEL
The TPs can use confirmation processing in this conversation. This value can be used only in a half-
duplex conversation; confirmation processing is not supported in a full-duplex conversation.
UNIX
AP_SYNCPT
The TPs can use LU 6.2 Syncpoint functions in this conversation. Set this value only if you have a
Syncpoint Manager (SPM) and Conversation Protected Resource Manager (C-PRM) in addition to the
standard SNAplus2 product. For more information see Section 1.12,
Syncpoint Support.
rtn_ctl
Specifies when the local LU acting on a session request from the local TP is to return control to the local TP.
For information about sessions, see Section 2.10, LU-to-LU Sessions. Whatever the value of this parameter,
the LU returns control to the TP immediately if it encounters certain errors such as a zero session limit (which
mean that a session will never be allocated).
Possible values are:
AP_IMMEDIATE
• If the auto_act parameter of the DEFINE_MODE verb or the define_mode command is set to
0 (zero), SNAplus2 does not attempt to activate a session or sessions. If a contention-winner
session is immediately available (active and not being used by another conversation), the LU
allocates this conversation to it and returns control to the TP immediately. If a contention-winner
session is not immediately available, control is returned to the TP immediately with a primary_rc
of
AP_UNSUCCESSFUL.
• If the auto_act parameter of the DEFINE_MODE verb or the define_mode command is set to
any other value, SNAplus2 will attempt to activate a session or sessions.
For more information, refer to the description of the DEFINE_MODE verb in the HP-UX SNAplus2 NOF
Programmer’s Guide or define_mode command in the HP-UX SNAplus2 Administration Command
Reference.
AP_WHEN_SESSION_ALLOCATED
If a session is immediately available (active and not being used by another conversation), the LU
allocates this conversation to it. If a session is not immediately available but one can be activated, the
LU activates it and allocates the conversation to it; if it cannot activate a session, it waits for one to
become free.
AP_WHEN_SESSION_FREE
If a session is immediately available (active and not being used by another conversation), the LU allocates
this conversation to it. If a session is not immediately available but one can be activated, the LU activates
it and allocates the conversation to it. If no active session is free and another session cannot be activated,
control is returned to the TP with the primary return code
AP_ALLOCATION_ERROR and secondary return
code
AP_ALLOCATION_FAILURE_RETRY. This is similar to AP_WHEN_SESSION_ALLOCATED except
that the LU will not wait for a session to become free.
AP_WHEN_CONWINNER_ALLOC
111