TS/MP 2.5 Management Programming Manual

10 Event Management
This section describes the TS/MP interface to the Event Management Service (EMS) and describes
the functions of the various event and error message tokens.
Message Numbers
All messages returned by the PATHMON environment are logged by the PATHMON process.
However, some message numbers range represent events and errors reported to the PATHMON
process by other processes. The message number identifies the process that reported the event,
as:
With the Tokens…Are Generated by…
Message Numbers in This
Range…
ZPWY-EVT-PM-
nl
PATHMON process
nl
1000 to 1999
ZPWY- ERR-PM-Although some messages generated by the
PATHMON process pertain to Pathway/iTS
objects, all messages in this range are
described in Sections 11 and 12 of this
manual.
ZPWY-EVT-TCP-
nl
Link managers
nl
3000 to 3999
ZPWY- ERR-TCP-All messages reported by TCPs are
described in the Pathway/iTS Management
Programming Manual.
nl
Some of these messages might also be
reported by LINKMON processes or ACS
subsystem processes; such messages are
described in “ACS Subsystem Messages”
(page 267).
ZPWY-ERR-SPI-SPI (Subsystem Programmatic Interface)
nl
4000 to 4999
These messages are described in “SPI Error
Messages” (page 305). 4e
Error messages with a value of 0 indicate the command completed successfully (ZPWY-VAL-OK).
Overview of Pathway Subsystem Event Management
The Event Management Service (EMS) is the part of the Distributed Systems Management software
that reports and logs important events that occur in a subsystem or network. EMS also distributes
and retrieves information regarding those events so that either operations personnel or software
can respond to them. For a thorough description of EMS, see the EMS Manual.
For TS/MP, the PATHMON process logs event messages for itself and for ACS subsystem processes.
For Pathway/iTS, the PATHMON process logs event messages for itself and for the TCPs.
You configure event logging using either the PATHCOM LOG1 and LOG2 commands or the
programmatic CONTROL PM command. Your management application can specify the file to which
PATHMON process logs events; whether PATHMON process opens a specified log file; whether
PATHMON process logs status change messages as well as error messages; and whether messages
are formatted as text or as event messages.
A Pathway subsystem event message might express, among other conditions:
• A change in the state of an object. For example, a server has started.
• The failure or absence of a component. For example, a backup process has failed.
• A file system error. For example, an error has occurred on a call to a file system procedure.
• The encountering of an invalid item. For example, a program-unit name is invalid.
Message Numbers 163