Writing Monitors for the Event Monitoring Service (December 1999)

Contents

1. Understanding the Event Monitoring Service

Event Monitoring Service Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . .10

EMS Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15

EMS Resource Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16

Client and Target Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

EMS with ServiceGuard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

EMS GUI Client Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

EMS and Target Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19

Resource Monitors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

Installing Resource Monitors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

Conﬁguring Resource Monitors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21

Writing Resource Monitors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21

EMS Framework Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

The EMS API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

The registrar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

The Resource Dictionary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24

2. The EMS Application Programming Interface (API)

Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26

EMS Data Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27

EMS Resource Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29

Logging and Tracing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32

Function Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34

rm_copy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35

Function Prototype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35

Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35

Returned Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35

Usage Notes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35