gtpc2ma1C/C++ Language Support User's Guide

TPF/APPC Basic Conversation Functions

The function provided by the TPF Advanced Program-to-Program Communications (TPF/APPC) interface is an implementation of the IBM Advanced Program-to-Program Communications (APPC) architecture. TPF/APPC is an interface that allows TPF transaction programs to communicate with remote SNA nodes that have implemented the APPC interface using LU 6.2 protocols. See the TPF ACF/SNA Data Communications Reference for more information about TPF/APPC support. Before using this support, you must be familiar with the SNA LU 6.2 protocol architecture as defined in the following publications:

The TPF/APPC functions provide the interface for all TPF system-supported verbs defined in the LU 6.2 architecture. This chapter contains a description of the TPF/APPC basic conversation functions in their general form and an alphabetic listing of each function.

Note:
The functions tppc_get_type and tppc_wait are defined by the LU 6.2 architecture as type-independent verbs; that is, they provide functions that span both basic conversations and mapped conversations. They are listed in this chapter because they are processed with the same interface as the basic conversation functions.

The following information is shown for each function:

Format
The function prototype and a description of any parameters.

Description
What service the function provides.

Return Codes
A table containing a list of return codes for the specific function.
Note:
This section replaces the Normal Return and Error Return sections that are used in TPF API Functions.

Programming Considerations
Remarks that help the programmer to understand the correct use of the function and any side effects that can occur when the function is executed. If the use of a particular function affects the use of another function, that is also described.

Example
A code segment showing a sample function call.

Related Functions
Where to find additional information pertinent to this function.
Note:
Remember to include tpfeq.h in the source program, even though it is not shown in any of the function prototypes. The tpfeq.h header must be the first header file included in any TPF C source module.

For descriptions of the TPF/APPC mapped conversation functions, see TPF/APPC Mapped Conversation Functions.