HP-UX Event ManagerProgrammer's Guide

Table of Contents
About This Document ........................................................................................................9
Intended Audience.................................................................................................................................9
HP-UX Release Name and Release Identifier.........................................................................................9
Document Organization.........................................................................................................................9
Typographic Conventions......................................................................................................................9
Related Documents...............................................................................................................................10
HP Encourages Your Comments..........................................................................................................10
1 Introduction...................................................................................................................11
Events and Event Management............................................................................................................11
How EVM Events are Handled............................................................................................................12
2 Event Manager Events.................................................................................................15
EVM Event Content..............................................................................................................................15
Standard Data Items........................................................................................................................15
Event Name Data Item...............................................................................................................16
Reserved Component Names...............................................................................................17
Comparing Event Names......................................................................................................19
Event Format Data Item.............................................................................................................19
Event Priority Data Item............................................................................................................20
I18N Catalog Name, Message Set ID, and Message ID Data Items...........................................20
Reference Data Item...................................................................................................................21
Variable Data Items..........................................................................................................................21
Designing a Set of Events......................................................................................................................22
Deciding Which Status Changes are Eventworthy.........................................................................23
Writing Event Explanation Text.......................................................................................................24
Designing Event Templates..................................................................................................................24
Deciding What to Put in an Event Template...................................................................................25
Matching the Names of Posted Events with Event Template Names.............................................26
Merging Data Items from Templates and Posted Events................................................................26
Installing Template Files — Location, Naming, Ownership, and Permission Requirements.........27
Checking Event Template Registration...........................................................................................27
Establishing Translations for Event Text (I18N)..............................................................................28
3 The EVM Programming Interface................................................................................31
EVM Header File...................................................................................................................................31
EVM API Library..................................................................................................................................31
Building Your Code Using EVM APIs..................................................................................................31
Return Status Codes..............................................................................................................................31
Signal Handling....................................................................................................................................32
EVM Multithreaded Programs.............................................................................................................32
Reassigning and Replicating EVM Events............................................................................................32
Callback Functions................................................................................................................................33
Choosing a Connection Policy..............................................................................................................34
Handling Disconnections......................................................................................................................34
Missed Events.......................................................................................................................................35
Using Event Filters................................................................................................................................35
Table of Contents 3