HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Control Verbs

RECEIVE_ALLOCATE

3.3 RECEIVE_ALLOCATE

The RECEIVE_ALLOCATE verb is issued by the invoked TP. It conﬁrms that the invoked TP is ready to begin a

conversation with the invoking TP, which issued the [MC_]ALLOCATE verb.

In response to this verb, APPC establishes a conversation between the two TPs, generates a TP identiﬁer for the

invoked TP, and generates a conversation identiﬁer. These identiﬁers are required parameters for subsequent APPC

verbs.

UNIX

The SNAplus2 APPC implementation provides both the standard form of the RECEIVE_ALLOCATE verb, as

provided by other APPC implementations, and an extended form that enables the application to receive incoming

Attaches from a particular local LU. The two forms are described together in this section, with references to

“standard form” and “extended form” where appropriate.

WINDOWS

The extended form of RECEIVE_ALLOCATE is not provided on Windows.

3.3.1 VCB Structure: RECEIVE_ALLOCATE

UNIX

The deﬁnition of the VCB structure for the RECEIVE_ALLOCATE verb is as follows:

typedef struct receive_allocate

{

AP_UINT16 opcode;

unsigned char opext; /* Reserved */

unsigned char format;

AP_UINT16 primary_rc;

AP_UINT32 secondary_rc;

unsigned char tp_name[64];

unsigned char tp_id[8];

AP_UINT32 conv_id;

unsigned char sync_level;

unsigned char conv_type;

unsigned char user_id[10];

unsigned char lu_alias[8];

unsigned char plu_alias[8];

unsigned char mode_name[8];

unsigned char reserv3[2];

AP_UINT32 conv_group_id;

unsigned char fqplu_name[17];

unsigned char pip_incoming;

unsigned char duplex_type;

unsigned char reserv4[3];

unsigned char password[10];

unsigned char reserv5[2];

unsigned char dload_id[8];

} RECEIVE_ALLOCATE;