HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_PREPARE_TO_RECEIVE and PREPARE_TO_RECEIVE
4.8 MC_PREPARE_TO_RECEIVE and
PREPARE_TO_RECEIVE
The MC_PREPARE_TO_RECEIVE or PREPARE_TO_RECEIVE verb changes the state of the conversation for
the local TP from Send or Send_Pending to Receive.
Note
This verb can be used only in a half-duplex conversation; it is not valid in a full-duplex
conversation.
Before changing the conversation state, this verb performs the equivalent of one of the following, depending on the
ptr_type (prepare-to-receive type) parameter as described below:
• The [MC_]FLUSH verb, sending the contents of the local LU’s send buffer to the partner LU (and TP)
• The [MC_]CONFIRM verb, sending the contents of the local LU’s send buffer and a confirmation request to
the partner TP
After this verb has successfully executed, the local TP can receive data.
4.8.1 VCB Structure: MC_PREPARE_TO_RECEIVE
UNIX
The definition of the VCB structure for the MC_PREPARE_TO_RECEIVE verb is as follows:
typedef struct mc_prepare_to_receive
{
AP_UINT16 opcode;
unsigned char opext;
unsigned char format; /* Reserved */
AP_UINT16 primary_rc;
AP_UINT32 secondary_rc;
unsigned char tp_id[8];
AP_UINT32 conv_id;
unsigned char ptr_type;
unsigned char locks;
} MC_PREPARE_TO_RECEIVE;
4.8.2 VCB Structure: PREPARE_TO_RECEIVE
The definition of the VCB structure for the PREPARE_TO_RECEIVE verb is as follows:
typedef struct prepare_to_receive
{
AP_UINT16 opcode;
unsigned char opext;
unsigned char format; /* Reserved */
AP_UINT16 primary_rc;
AP_UINT32 secondary_rc;
unsigned char tp_id[8];
AP_UINT32 conv_id;
unsigned char ptr_type;
unsigned char locks;
151