HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_SEND_CONVERSATION and SEND_CONVERSATION
Successful Execution
If the verb executes successfully, APPC returns the following parameters:
primary_rc
AP_OK
conv_group_id
The conversation group identifier 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_LL
This return code applies only to the SEND_CONVERSATION verb. The logical record length field of
a logical record contained a value that was not valid—
0x0000, 0x0001, 0x8000,or0x8001.For
more information, see Section 2.11.1, Logical Records.
AP_BAD_RETURN_CONTROL
The value specified for rtn_ctl was not valid.
AP_BAD_SECURITY
The value specified for security was not valid.
AP_BAD_TP_ID
The value of tp_id did not match a TP identifier assigned by APPC.
AP_PIP_LEN_INCORRECT
The value of pip_dlen was greater than 32,767.
AP_UNKNOWN_PARTNER_MODE
The value specified for plu_alias or mode_name was not valid.
UNIX
AP_INVALID_FORMAT
The reserved field format was set to a nonzero value.
AP_SYNC_NOT_ALLOWED
The application issued this verb within a callback routine, using the synchronous APPC entry point.
Any verb issued from a callback routine must use the asynchronous entry point.
State Check
No state check errors occur for this verb.
213