SNAX/APC Configuration and Management Manual

Introduction

SNAX/APC Configuration and Management Manual—138787

1-10

Transaction Programs

SNAX/APC exists to allow user-written transaction programs (TPs) to communicate

with other TPs in the SNA network. A transaction is either a part or the entirety of a

business function. A typical example of a transaction is the transfer of money from one

bank account to another. Such a program can be written in any language and on a wide

variety of computer systems. A business function can consist of one or more

invocations of such transaction programs.

TPs can be started by a user or by the SNAX/APC Dispatcher (as described earlier). A

TP started under user control can either initiate a conversation (in which case it initially

sends data) or it can wait until a remote TP requests access to it (in which case it initially

receives data). (A TP started by the Dispatcher initially receives data.)

TPs written for the C-series environment can be run in the D-series or G-series

environment without changes as long as the TPs run at low PINs and you do not want to

take advantage of D-series or G-series features.

See the SNAX/APC Application Programming Manual for further details on writing TPs.

Trace Analysis Program

When solving problems in SNAX/APC communication, it is useful to be able to

examine the information transmitted between TPs and SNAX/APC, and information

transmitted between SNAX/APC and SNAX/XF, SNAX/APN, or SNAX/CDF.

The SNAX/APC Trace Analysis Program (APCTAP) is an interactive utility that allows

you to examine information passed among the SNAX/APC components. APCTAP

allows you to select a range of entries, record types, and so on.

The SNAX/APC Trace Analysis Program (APCTAP) does not support D-series or G-

series software high PINs. It must run at low PINs.

See Section 5, Trace Analysis Program

, of this manual for diagnostic procedures.

High Pin Support by SNAX/APC

The SNAX/APC process supports D-series or G-series high PINs. It can open other

processes that run at high PINs and accept requesters that are running at either high or

low PINs. SNAX/APC itself can run at either a low or high PINs. The value of the

HIGHPIN flag, in the SNAX/APC object file, APCOBJ, controls whether SNAX/APC

runs at a high or a low PIN. The default value of the HIGHPIN flag is HIGHPIN ON,

which causes SNAX/APC to run at a high PIN. You can use BINDER to change the

value of the HIGHPIN flag. The following example illustrates the procedure for

changing the value of the HIGHPIN flag:

1. Start BINDER by entering BIND at a TACL prompt.

TACL> BIND

BINDER - OBJECT FILE BINDER - T9621D22 - (19MAR94) SYSTEM

\ABCD