HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_ALLOCATE and ALLOCATE
Address of buffer containing PIP data.
Use this parameter only if pip_dlen is greater than 0 (zero).
PIP data can consist of initialization parameters or environment setup information required by a partner
TP or remote operating system. The PIP data must follow the General Data Stream format. For further
information, refer to the IBM publication Systems Network Architecture Format and Protocol Reference
Manual: Architecture Logic for LU Type 6.2.
WINDOWS
The PIP data buffer can reside in a static data area or in a globally allocated area. The data buffer must fit
entirely within this area.
fqplu_name
Fully qualified LU name of the partner LU. This parameter is used only if plu_alias is set to zeros.
This name is a 17-byte EBCDIC string, padded on the right with EBCDIC spaces, containing one of the
following:
• A network ID of 1–8 A-string characters, an EBCDIC dot (period) character, and an LU name of 1–8
A-string characters
• An LU name of 1–8 A-string characters (without the network ID or the EBCDIC dot)
4.2.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 parameters:
primary_rc
AP_OK
conv_id
Conversation identifier. This value identifies the conversation established between the two TPs.
conv_group_id
Conversation group ID of the session used by the conversation.
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_TYPE
115