NetBatch Management Programming Manual

Glossary
NetBatch Management Programming Manual—522462-003
Glossary-5
EMS standard definitions
EMS standard definitions. The set of declarations provided by EMS for use in event
management regardless of the subsystem. Any application that retrieves tokens from
event messages needs the EMS standard definitions. Names of EMS standard
definitions start with ZEMS. See also definition; definition files; SPI standard
definitions.
end-list token. A syntax token that ends a list. SPI defines a single end-list token, whose
token code is ZSPI-TKN-ENDLIST. See also list token; syntax token.
enumerated type. A 16-bit signed data type that has one of a specified list of values with
designated meanings. The enumerated type is one of the standard token data types
defined by SPI. The list of acceptable values for the data type and what those values
mean varies depending on the token number. The list is defined by the subsystem.
error. A condition that causes a command or other operation to fail. See also warning.
error list. A grouping of tokens used in a response record to provide error and warning
information. An error list consists of a list token that denotes an error list (different from
the token that starts a data list or a generic list), followed by an error token, other
tokens explaining the error (optional), and an end-list token. Error lists can be nested in
other error lists. The return token cannot be included in an error list. See return token.
error number. A value that can be assigned to a return token, or to the last field of an error
token, to identify an error that occurred. SPI defines a small set of error numbers, but
most error numbers are defined by subsystems.
error token. A response token that indicates the reason an error occurred in performing a
command. NonStop subsystems enclose each error token in an error list, which can
also contain additional information about the error. A response record must contain a
return token, and also can contain error lists to explain the error further. The token
code for the error token is ZSPI-TKN-ERROR. Its value is a structure consisting of the
subsystem ID and an error number identifying the error. See error list, error number,
and return token.
event. A significant change in a condition in the system or network. Events can be
operational errors, notifications of limits exceeded, requests for action, and so on.
event log. A file or set of files maintained by EMS to store event messages generated by
subsystems.
event management. The reporting and logging of important events that occur in a system
or network, the distribution and retrieval of information concerning those events, and
the actions taken by operations personnel or software in response to the events. See
also control and inquiry.
Event Management Service (EMS). See EMS.