SNAX/APC Application Programming Manual

Application Prototype Simulator
SNAX/APC Application Programming Manual—138786
4-6
APS and the SNAX/APC Configuration Database
APS and the SNAX/APC Configuration Database
The SNAX/APC server process should be configured in the usual way before using
APS. Refer to the SNAX/APC Planning and Configuration Manual.
When configuring SNAX/APC, note that APS is not defined as a TP: APS can simulate
any TP you want. The TP that APS is simulating is identified to SNAX/APC when APS
sends a TP-READY verb to SNAX/APC for execution. You enter the name of the TP as
part of the input required for the TP-READY verb. You can supply any TP name you
want as long as the SNAX/APC server process has that TP name in its configuration.
APS, like any TP, must operate in cooperation with a partner TP. APS can operate with
any partner TP. There are no special requirements for partner TPs for APS.
APC and the IPC Version Code
The IPC version code is the mechanism SNAX/APC uses to distinguish between
versions of the UOWs (verbs) available to the TP. The version code is carried in the IPC
header and so applies to all UOWs in the IPC.
IPC Version Codes S1, S2, S3, and S5
Generally, SNAX/APC verbs may be issued in an IPC with a version code of S1, S2, S3,
or S5. Tandem recommends that S5 be used in the development of new applications.
For this reason, APS issues all verb requests in an IPC with a version code of S5 and the
DISPLAY-STATUS verb, unsupported at S2, is not part of APS. Verbs behaving
differently at different version levels will be present only in their most current form.
APS in a Loopback Configuration
You can set up APS in a loopback configuration and run APS at both ends of the
conversation. This configuration enables you to see both TPs in a conversation. When
using APS in a loopback configuration, you must use a separate SNAX/APC server for
each end of the conversation. Note also that this configuration requires two terminals,
one for each end of the conversation. An example of a loopback configuration may be
found in Section 4 of the SNAX/APC Planning and Configuration Manual.
Starting APS
To start APS, enter the following command from within PATHCOM:
=RUN APS
APS first displays the SNAX/APC logo screen.
To begin executing verbs, press F1, which causes the form for the TP-READY verb to
be displayed. (The TP-READY verb is the first verb issued by every TP.)
Press F12 to send the request to the SNAX/APC server for execution; other function
keys may be used before F12.