HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_RECEIVE_AND_POST and RECEIVE_AND_POST
conv_id
Conversation identifier.
The value of this parameter was returned by the [MC_]ALLOCATE verb in the invoking TP or by
RECEIVE_ALLOCATE in the invoked TP.
rtn_status
Indicates whether status information and data can be returned on the same verb.
Possible values are:
AP_YES
Status information, if available, is returned with the last part of a data record.
AP_NO
Status information is not returned with data. After receiving the end of a data record, the local TP must
issue another [MC_]RECEIVE verb to obtain the status information.
fill
Indicates the manner in which the local TP receives data.
This parameter is used only by the basic-conversation RECEIVE_AND_POST verb.
Possible values are:
AP_BUFFER
The local TP receives data until the number of bytes specified by the max_len parameter is reached or
until end of data. Data is received without regard for the logical-record format.
AP_LL
Data is received in logical-record format. The data received can be any of the following:
• A complete logical record
• A max_len-byte portion of a logical record
• The end of a logical record
max_len
Maximum number of bytes of data the local TP can receive.
The range for this value is
0–65,535.
This value must not exceed the length of the buffer to contain the received data.
dptr
Address of the buffer to contain the data received by the local LU.
UNIX
callback
Address of the callback routine which APPC is to call when the asynchronous receiving operation is finished.
For more information, see Section 4.10.9, Usage Notes.
WINDOWS
sema
A Windows event handle, obtained by calling one of the two Win32 functions CreateEvent or
OpenEvent. APPC signals this event handle to inform the TP when the asynchronous receiving operation
is finished.
163