HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Control Verbs

RECEIVE_ALLOCATE

UNIX

The TP can specify that it will accept incoming Attaches for any TP name, by setting this parameter to 64

EBCDIC spaces. For more information about how SNAplus2 routes incoming Attaches to TPs, see Section

3.3.8, Routing for Incoming Attaches.

lu_alias

For the standard form of RECEIVE_ALLOCATE, this parameter is reserved; set it to a null string. If the TP

is automatically started by SNAplus2, the entry for this TP in the invokable TP data ﬁle must not specify an

LU alias.

For the extended form of RECEIVE_ALLOCATE, specify the alias of the local LU from which the TP will

accept incoming Attaches. This is an ASCII character string. If the TP is automatically started by SNAplus2,

this LU alias must match the LU alias speciﬁed for the TP in the invokable TP data ﬁle.

To indicate that the TP will accept incoming Attaches from any local LU, set this parameter to eight ASCII

spaces. If the TP is automatically started by SNAplus2, the entry for this TP in the invokable TP data

ﬁle

must not specify an LU alias.

For more information about how SNAplus2 routes incoming Attaches to TPs, see Section 3.3.8, Routing for

Incoming Attaches.

dload_id

The identiﬁer for the Attach provided by a TP server application. If the TP does not cooperate with a TP

server, set this ﬁeld to all zeros.

3.3.4 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

UNIX

tp_name

If the application speciﬁed a TP name consisting of all spaces, SNAplus2 returns the TP name that was

supplied by the invoking TP on the [MC_]ALLOCATE verb.

tp_id

Identiﬁer for the local TP.

conv_id

Conversation identiﬁer.

This value identiﬁes the conversation APPC has established between the two partner TPs.

sync_level

Synchronization level of the conversation.