Availability Guide for Application Design

Instrumenting an Application for Availability
Availability Guide for Application Design—525637-004
8-35
DSM Management Services
Using DSM Template Services
The DSM Template Services are used to generate text from tokens in event messages
or from tokens in SPI message buffers. DSM Template Services provide:
•
A language for combining text with token values to produce text strings
•
A compiler to produce templates from the template language source
•
An installer to install the templates in a file where they can be accessed by DSM
Template Services procedures
When to Use the DSM Template Services
You should use DSM Template Services to develop the human-readable text for all
tokens used in your messages.
How DSM Template Services Work
DSM Template Services supply procedures that applications can use to generate text
from tokens. The procedures are of two types: one type generates event-message text
and the other generates text from an SPI message buffer.
EMSTEXT accesses templates supplied by HP subsystems to generate text for display
on terminals or printers. Custom subsystems and applications can also provide
templates that generate text for tokens in the event messages they generate.
Anyone writing a management application or a custom subsystem can use the buffer-
formatting procedures to provide a readable dump of the contents of an SPI buffer.
Such dumps are useful for finding errors in programs that send or receive SPI
messages.
Refer to the DSM Template Services Manual for detailed information on generating
text from tokens.
Summary of Event Management Issues
In summary, DSM management services do much of the event management for you,
provided your application generates the events and routes them to EMS. Application
designers and operations staff, however, must determine the following:
EMSTEXT An EMS text formatting procedure that uses template files
supplied by DSM Template Services to generate event
message text for display by an EMS printing distributor or
to format text for events retrieved by a custom
management application.
SPI_BUFFER_FORMA
Tnnnn
Procedures that use template files to generate text
displays of the content of SPI message buffers; nnnn is
START, NEXT, or FINISH.