TS/MP Management Programming Manual (G06.24+, H06.03+)

SPI Programming Considerations

NonStop TS/MP Management Programming Manual—540082-001

3-2

Definition Files

The commands, responses, and event messages sent to and received from the

Pathway subsystem are made up of items called tokens. Each token contains a

particular piece of information, such as a command parameter or an item of information

about 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.

Tokens and related data items for commands, responses, and event messages must

be declared in your management applications; HP provides these declarations for you

in definition files. A set of definition files is provided as part of each HP subsystem that

supports DSM; a few other NonStop software components (such as SPI and EMS)

also provide definition files. Each software component includes definition files for the

TAL, COBOL, TACL, C, and DDL languages.

To be able to use the data declarations defined by a particular NonStop software

component, your application must incorporate the appropriate programming-language

definition file associated with that software component. 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. TAL programs can use as a source either the

entire definition file or just the sections they require. The TACL command interpreter

always loads the entire definition file. For further information about how definition files

are used by an application, see the SPI Programming Manual.

Naming Conventions

Definition files are named according to these conventions:

subsys

is a three-character code identifying the subsystem or other software component to

which these definitions belong. The code for the Pathway subsystem is PWY.

The last characters of each file name denote the language in which the definitions in

this file are coded.

ZSPIDEF.ZsubsysC

ZSPIDEF.ZsubsysCOB

ZSPIDEF.ZsubsysDDL

ZSPIDEF.ZsubsysPAS

ZSPIDEF.ZsubsysTACL

ZSPIDEF.ZsubsysTAL