gtpa2m0hApplication Programming

TPF Advanced Program-to-Program Communications

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. This application interface is provided for application transaction programs written in assembler language or in C language.

Note:
Mapped conversation support is provided only through the C language interface.

The TPPCC macro, described in TPF General Macros, provides the assembler language interface for basic conversations. The tppc_ C function calls provide the C language interface for basic conversations, and the cmxxxx C function calls provide the C language interface for mapped conversations. All TPF/APPC C function calls are described in the TPF C/C++ Language Support User's Guide. The CNOSC macro, described in TPF General Macros, provides the communication interface between the control operator and the TPF application programs.

A conversation between transaction programs is identified and controlled by a conversation control block (CCB), which is defined by data macro ICCB. A session is controlled by a session control block (SCB), which is defined by data macro ISCB. Local TPF transaction programs that are activated by remote transaction programs or by the tppc_activate_on_receipt or tppc_activate_on_confirmation function must be defined to TPF in the transaction program name table (TPNT).

This publication discusses TPF application programming in a traditional environment of host and terminals. For more information about application programming in a distributed processing environment using LU 6.2 protocols (TPF/APPC), see the TPF ACF/SNA Data Communications Reference.