DSM/SCM Event Management Programming Manual

Elements of SPI Messages for DSM/SCM

DSM/SCM Event Management Programming Manual—529844-003

2-2

Source Definition Files

If you write a management application in C, COBOL, TACL, or TAL to receive

DSM/SCM event messages, each source module must include these definition files,

depending on the language you are using, located on a disk volume chosen by your

site:

Naming Rules for Management Applications

By convention, HP uses names beginning with the letter Z for all definitions and all

component fields of structures in its definition files. To avoid present and future

conflicts with names defined by HP, do not begin any of the names you define in your

management applications with uppercase or lowercase Z.

Common Syntax Elements

This subsection describes major syntax elements of DSM/SCM event messages.

DSM/SCM Event Numbers

All event messages contain a header token (ZEMS-TKN-EVENTNUMBER) that

identifies the event by number. This event number, in combination with the subsystem

ID header token (ZSPI-TKN-SSID), uniquely identifies the event being reported.

DSM/SCM event numbers are represented by symbolic names of the form ZPHI-EVT-

name, where name gives a brief verbal identification of the event to report. For

example, ZPHI-EVT-ACT-COMPLETED is the symbolic name of the event message

that reports the completion status of a DSM/SCM activity.

For a list of DSM/SCM event numbers, see Table 5-1, DSM/SCM Event Messages, on

page 5-2. For detailed descriptions, see Descriptions of DSM/SCM Event Messages on

page 5-24.

Definition File C COBOL TACL TAL

SPI ZSPIC ZSPICOB ZSPITACL ZSPITAL

EMS ZEMSC ZEMSCOB ZEMSTACL ZEMSTAL

DSM/SCM ZPHIC ZPHICOB ZPHITACL ZPHITAL

All language files are of the form ZSPIDEF.Zxxxxxx.

Note. The symbolic names in this manual are in DDL (or COBOL) format using hyphens (-) as

separators. If you are writing a TAL or TACL management application, substitute the circumflex

(^) symbol for the hyphens. If you are writing a C management application, substitute the

underscore (_) symbol for the hyphens.