DSM Template Services Manual

Introduction
DSM Template Services Manual—427187-004
1-3
When Do You Need Template Services?
If you are writing a management application, you can use the EMSTEXT procedure
to display EMS event messages as operator messages. EMSTEXT uses a format
template to determine how to format the information in an EMS event message.
You can then display, print, or store the text that EMSTEXT generates. ViewPoint,
printing distributors, and compatibility procedures call EMSTEXT. If the
management application uses an EMS facility, such as a printing distributor, to
create operator messages, EMSTEXT does not need to be called directly from the
management application.
•
Listing the tokens in messages
To display as text the token names and values in an event, command, or response
message; for example, for debugging purposes, you can use the
SPI_BUFFER_FORMAT procedures.
•
Controlling the display of tokens in messages
If you are using the Inspect symbolic debugger, the Tandem Maintenance and
Diagnostic Subsystem (TMDS), or another application that uses the
SPI_BUFFER_FORMAT procedures to display event, command, or response
messages, you can use certain Data Definition Language (DDL) clauses to
influence how the information is displayed. These clauses include the DISPLAY,
HEADING, and AS clauses, which can be placed in the DDL definition file of a
subsystem or management application. See Appendix A, Template-Related DDL
Clauses.
•
Changing the value of certain tokens
To have the value of a token in an EMS event message be different at a particular
site, you can install an override template. When the EMS event message is
retrieved by the EMSTEXT, EMSGET, EMSGETTKN, or SPI_BUFFER_FORMAT
procedures, the override template replaces the token’s value with another value
you specify.
You can customize HP operator messages and modify the way tokens in HP event
messages are listed by SPI_BUFFER_FORMAT procedures. For more information,
see Installing Modified HP Templates
on page 6-4.
Note. HP strongly recommends that all applications have a DDL SSID clause in the
application’s DDL definition file for each token. See Appendix A, Template-Related DDL
Clauses.