EMS Manual

Procedure Calls for Standard Events
EMS Manual—426909-005
11-31
Standard Usage Threshold Event

If Job ID is not present or the value is zero, the procedure calls system procedure
PROCESS_GETINFO_ to get the job ID. If the job ID obtained is nonzero, the job
ID is added to the event buffer. Otherwise, the job ID is not added to the event
buffer.
The nonzero job ID obtained from calling PROCESS_GETINFO_ is the NetBatch
job ID associated with the process that calls this EMS event-building procedure.
If the subject reported in this event is managed by a process different from the
process that calls this EMS event-building procedure, the caller should provide the
Job ID, which is the NetBatch job ID associated with the process that manages
the subject.

The subject of this event is the object that no longer needs operator attention. The
Subject value must be fully qualified so that it can be uniquely identified from
any point in a network. An example is
\nodename.$volume.subvolume.filename.
Use EMSADDSUBJECT or EMSADDSUBJECTMAP to specify additional subjects.
Standard Usage Threshold Event
This subsection describes:

The algorithm and procedures for deciding whether to generate the standard
usage threshold event

The procedure to build the standard usage threshold event

A programming example
The Algorithm
The algorithm for usage threshold event generation was taken from ISO/IEC 10165-2,
(Information Technology—Open Systems Interconnection—Structure of Management
Information—Part 2: Definition of Management Information) section 9.3.2 Gauge
Threshold. This subsection is a slightly modified version of that text.
This algorithm is a general mechanism for generating one or more events from
changes in any value of a usage variable. A hysteresis mechanism is provided to avoid
the repeated triggering of event notifications when the usage makes small oscillations
around a threshold value. This capability is provided by specifying threshold values in
pairs, one a high threshold value and the other a low threshold value. The difference
between threshold values is the hysteresis interval.
These four variables are needed to calculate when to send an event: