SNAX/APC Management Programming Manual

Management Programming for SNAX/APC
Introduction to SNAX/APC
111813 Tandem Computers Incorporated 1–5
Management
Programming for
SNAX/APC
The DSM management programming interfaces to the SNAX/APC subsystem enable
applications to execute configuration commands programmatically and to obtain
configuration and statistical information about SNAX/APC objects. They may also
initiate and stop the tracing of certain SNAX/APC objects.
SNAX/APC Management
Functions
A SNAX/APC management application can perform the following functions:
Start and stop the operation of an object
Add new objects to the SNAX/APC process
Alter the attribute settings of an object
Delete an object definition from the SNAX/APC process
Obtain version information about SNAX/APC
Obtain information about an object’s current attribute settings
Display a list of the file system’s open calls that apply to the SNAX/APC process
Obtain the names of all the defined objects with a specified object type
Display the current values of an object’s statistics counters
Reset an object’s statistics counters
Obtain an object’s current status
Control and define an object’s trace environment
The SNAX/APC programmatic interface allows users to write DSM application
programs that configure and obtain information about SNAX/APC objects. The SPI
programmatic interface also provides CNOS functionality. For example, the START
PTNR-MODE command is equivalent to the CNOS INITIALIZE_SESSION_LIMIT
verb; the STOP PTNR-MODE and ABORT PTNR-MODE commands are equivalent to
the CNOS RESET_SESSION_LIMIT verb; and the ALTER PTNR-MODE command is
equivalent to the CNOS CHANGE_SESSION_LIMIT verb.
For discussions on how to use the Distributed Systems Management (DSM)
programmatic interface to SNAX/APC, see the SPI Programming Manual and the SPI
Common Extensions Manual. For a comparison of SNAX/APC commands and
attributes to LU 6.2 verbs and parameters, see Appendix C of the SCF Reference Manual
for SNAX/APC.
Objects Controlled by
SNAX/APC
The objects addressed by SNAX/APC are the SNAX/APC process (PROC), local LU
(LU), partner LU (PTNR-LU), partner LU mode (PTNR-MODE), LU-LU session
(SESS), local transaction program name (TPN), instance of a TPN (TPI), LU 6.2
conversation (CONVERSATION), and NULL.
These objects are controlled by the current SNAX/APC process, which has a user-
defined name of $ snax/apc-process .
For more information about these objects and how to address them, see Section 3,
“Elements of SPI Messages and SNAX/APC.”