SNAX/APC Application Programming Manual

SNAX/APC Application Programming Manual—138786

About This Manual

Who Should Read This Manual

This manual is for programmers writing distributed transaction programs (TPs)

requiring LU 6.2 support. The SNAX Advanced Program Communication

(SNAX/APC), the Tandem implementation of LU 6.2 services, provides support for the

C, TAL, COBOL85, Pascal, and TACL programming languages.

This manual provides subsystem-specific programming information about the use of

SNAX/APC interface; the use of verbs to send, receive, and control the flow of data

between two or more LUs offering LU 6.2 functionality.

This manual serves as both a reference manual and a user’s guide for the development of

TPs that communicate with the SNAX/APC subsystem. It starts with the actual

transaction program—from general concepts, to the use of specific verbs.

How This Manual Is Organized

This application programming manual has the following sections:

Section 1, Using the Application Program Interface

, provides some general

programming considerations, describes the steps a TP must go through to establish a

conversation, and introduces the concept of the finite state machine.

Section 2, Interprocess Communications and Units of Work

, describes the use of

interprocess messages and units of work (UOWs), and contains a detailed description of

the use of request and reply codes.

Section 3, Verb Definitions

, contains a detailed description of each control and

conversational verb that can be used with SNAX/APC.

Section 4, Application Prototype Simulator

, describes the use of the simulator to create

and test prototype TP conversation verb sequences without having to write the actual TP.

Appendix A, COBOL Definitions for SNAX/APC

, lists the COBOL definitions that are

created from the DDL source file shipped with SNAX/APC.

Appendix B, Request and Return Code

, describes the codes defined in the DDL source

file shipped with SNAX/APC.

Appendix C, Conversation-State Matrix

, represents the state transitions that can occur

for a TP when verbs are issued in a particular state.