NetBatch Management Programming Manual

SPI Programming Considerations for the NetBatch
Subsystem
NetBatch Management Programming Manual—522462-003
3-2
Definition Files
Definition Files
The commands, responses, and event messages sent to and received from the
NetBatch subsystem consist of items called tokens. Each token contains a particular
piece of information, such as a command parameter or a detail of an event. Tokens
can be single values or structures consisting of several values. Some tokens, called
header tokens, are present in every command and response and in every event
message.
Your management applications must declare tokens and related data items for
commands, responses, and event messages. HP provides these declarations in
definition files. A set of definition files in these languages comes with each NonStop
subsystem that supports SPI: C, COBOL, DDL, TACL, and TAL. The C, COBOL,
TACL, and TAL files derive from the DDL file.
To use the data declarations defined by a particular subsystem, your application must
include the appropriate programming-language definition file associated with that
subsystem. The declarations in a COBOL definition file are grouped into sections to
enable COBOL programs to declare multiple copies of structures in the definition file. C
and TAL programs can load either the entire definition file or just the sections they
require. The TACL program always loads the entire definition file. For more information
on how applications use definition files, see the SPI Programming Manual.
Definition files are named according to this convention:
The last characters of each file name indicate the language in which the definitions in
the file are coded.
subsys
is a three-character code identifying the subsystem or other software component to
which the definition belongs. For example, BAT identifies NetBatch definitions.
Definition files are located on the disk volume chosen by your site. (The default disk
volume used by the INSTALL system-generation program is $SYSTEM.)
An application that sends SPI commands to and receives responses from the NetBatch
subsystem requires these definition files in the appropriate programming language:
•
The SPI (ZSPI) definition file
•
The NetBatch (ZBAT) definition file
An application that retrieves event messages issued by the NetBatch subsystem
requires the previously listed definition files plus the EMS (ZEMS) definition file.
ZSPIDEF.ZsubsysC
ZSPIDEF.ZsubsysCOB
ZSPIDEF.ZsubsysDDL
ZSPIDEF.ZsubsysTACL
ZSPIDEF.ZsubsysTAL