EMS Manual

EMS Components and Architecture
EMS Manual—426909-005
2-14
Definition Files
type of the first subject is one that EMSTEXT cannot format. (EMSTEXT can
format most token types, such as file, device, string, and integer.)
This message covers any other case in which EMSTEXT cannot produce text from
the event message. extstat1 and extstat2 are the two halves of the
EMSTEXT extended-status code that defines the error. first subject value
is the formatted representation of the first subject token in the event message. This
part of the error message does not appear if the data type of the first subject is one
that EMSTEXT cannot format.
A printing distributor or compatibility distributor calls EMSTEXT to create text for an
output device and the ViewPoint application to create the text it displays. Any user
application can call EMSTEXT. Applications that call EMSTEXT should have a
minimum of five data pages (stack).
Definition Files
Like all subsystems that support SPI interfaces, EMS has its own DDL (Data Definition
Language) file that defines the tokens, values, and data types used in event messages
and in command and response messages relating to EMS. The DDL file is called
ZEMSDDL, and its language-specific derivative files are called ZEMSTAL, ZEMSTACL,
ZEMSCOB, and ZEMSC.
These files are of particular importance to EMS because they include definitions for
some widely used tokens. For example, all subsystems that report event messages
use the token ZEMS-TKN-EVENTNUMBER, and all programs that need to extract the
event number from any event message also use the ZEMS-TKN-EVENTNUMBER
token. Thus, the EMS definition files pertain to many subsystems besides EMS.
EMS Object Programs
HP provides two object programs for starting EMS components:

EMSACOLL (EMS Alternate Collector) starts an alternate collector by invoking the
TACL RUN command.
Several command parameters are available to customize an alternate collector,
including:

SUPPRESS, which enables burst detection and suppression (BDS)
Note. Applications should retry a call to open or read a template file if a timeout message
is returned. A timeout is not a fatal error.
EMSTEXT error—(extstat1,extstat2) prevented display of event.
SSID = subsystem ID Event number = event-msg ID [Subject =
first subject value]