HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_SEND_CONVERSATION and SEND_CONVERSATION
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.
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 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.
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
As for AP_WHEN_SESSION_ALLOCATED, except that the LU always allocates the conversation to a
contention-winner session; it will not use a contention-loser session.
AP_WHEN_CONLOSER_ALLOC
As for AP_WHEN_SESSION_ALLOCATED, except that the LU always allocates the conversation to a
contention-loser session; it will not use a contention-winner session.
AP_WHEN_CONV_GROUP_ALLOC
Use this value if you want the new conversation to use the same session as a previous conversation;
set the conv_group_id parameter to the conversation group ID of the previous conversation, which was
returned on the [MC_]ALLOCATE or RECEIVE_ALLOCATE verb.
If the session identified by the conv_group_id parameter 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 the session is being used by another conversation, the LU waits for it to become
free. If the session is no longer active, control is returned to the TP with the primary return code
AP_ALLOCATION_ERROR
and secondary return code AP_ALLOCATION_FAILURE_NO_RETRY
conv_group_id
Conversation group ID of the requested session for the conversation. This parameter is used only if rtn_ctl is
set to AP_WHEN_CONV_GROUP_ALLOC; set it to binary zeros for any other value of rtn_ctl.
plu_alias
Alias by which the partner LU is known to the local TP. This name must match the name of a partner LU
established during configuration.
209