X25AM Management Programming Manual

X25AM Management Programming Manual—528037-001
3-1
3
Elements for SPI Messages for the
X25AM Subsystem
The Subsystem Programmatic Interface (SPI) is used for building commands to,
decoding responses from, and obtaining event messages issued by the X25AM
subsystem. The procedures used by an application to perform these tasks are
described in the SPI Programming Manual. Using SPI messages to communicate with
the X25AM subsystem through SCP is described in the SPI Common Extensions
Manual. The commands, responses, and event messages that are sent to and
received from the X25AM subsystem are made up of special codes called tokens.
Each token contains a particular piece of information, such as the command number of
a command or one element of an event message. Tokens can be single values or
structures consisting of several values, and some tokens, called header tokens, are
present in every command, response, or event message.
This manual does not attempt to give a complete explanation of tokens; it provides
subsystem-specific information about the tokens used to communicate with the X25AM
subsystem. General information about tokens can be found in the SPI Programming
Manual, and information about tokens that is common to all data communications
subsystems can be found in the SPI Common Extensions Manual.
This manual uses DDL to describe all tokens. For a quick explanation of DDL, refer to
the appendix "Summary of DDL for SPI" in the SPI Programming Manual.
This section contain these topics:
Definition Files
Every token or other type of definition needed by an application that uses SPI is
defined in definition files provided by HP. Each source of definitions, such as a
subsystem or an operating-system component, has associated with it a set of four
definition files: one in TAL; one in COBOL85; one in TACL; and one in DDL, from which
the other three definition files are derived.
To be able to use the definitions from a particular source, an application copies in or
loads the definition file associated with that source that is in the appropriate
programming language.
The definitions in a COBOL85 definition file are grouped into sections to enable
COBOL85 programmers to declare multiple copies of structures in the definition file.
Topic Page
Definition Files
3-1
Naming Rules and Guidelines for Applications 3-2
Common Syntax Elements for the X25AM Subsystem 3-2