HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_ALLOCATE and ALLOCATE
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
.
duplex_type
Duplex type of the new conversation. See Section 1.1.10, Half-Duplex and Full-Duplex Conversations for
more details of the differences between full-duplex and half-duplex conversations.
Possible values are:
AP_HALF_DUPLEX
Half-duplex conversation.
AP_FULL_DUPLEX
Full-duplex conversation.
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 parameter is an 8-byte ASCII character string, padded on the right with ASCII blanks (0x20) if the
alias is shorter than eight characters. It can consist of any of the following characters:
• Uppercase letters
• Numerals 0–9
• Blanks
• Special characters $, #, %, and @
The first character of this string cannot be a blank.
To identify the LU by its LU name instead of its LU alias, set this parameter to eight binary zeros, and specify
the LU name in the fqplu_name parameter.
mode_name
Name of a set of networking characteristics defined during configuration.
This parameter is an 8-byte EBCDIC character string. It can consist of characters from the type-A EBCDIC
character set. These characters are as follows:
• Uppercase letters
• Numerals 0–9
112