TCP/IP Management Programming Manual

Elements of SPI Messages
HP NonStop TCP/IP Management Programming Manual—529636-001
3-2
Definition Files
To include the definition files in your management application, use the mechanism that
is appropriate for the programming language in which the application is written. The
mechanisms are:
•
In TAL, use the $SOURCE compiler directive to include the definition files in your
program.
•
In C, use the #INCLUDE compiler directive to include the definition files in your
program.
•
In COBOL, use COPY statements to copy the definition files into your program.
•
In TACL, use the #LOAD commands to load the definition files into your program.
Note that the definitions in a COBOL definition file are grouped into sections to enable
COBOL programmers to declare multiple copies of structures in the definition file,
whereas, when programming in TAL, C, or TACL, the entire definition file is always
included or loaded. For further information on how a management application
accesses definition files, see the SPI Programming Manual.
A management application that communicates with the TCP/IP subsystem must
include these definition files:
•
The SPI definition file, ZSPIDEF.ZSPIxxx. Note that in this and each of the
definition filenames that follow, xxx represents one of five specific abbreviations
for COBOL, TAL, TACL, C, or DDL and corresponds to the programming language
in which the management application is written.
•
The EMS definition file, ZSPIDEF.ZEMSxxx. This definition file is needed only if
the application retrieves event messages or controls the EMS.
•
The data communications definition file, ZSPIDEF.ZCOMxxx.
•
The TCP/IP definition file, ZSPIDEF.ZTCIxxx.
•
If the application communicates with other subsystems, the definition file
ZSPIDEF.Zsubsys (where subsys represents a three-character subsystem
identifier) for each of the other subsystems.
An example of the definition files needed by a TCP/IP application written in TAL that
retrieves event messages is:
ZSPIDEF.ZSPITAL SPI definitions
ZSPIDEF.ZEMSTAL EMS definitions
ZSPIDEF.ZCOMTAL Data communications definitions
ZSPIDEF.ZTCITAL TCP/IP definitions