FTAM/9000 Programmer's Guide

Chapter 3 163
HP FTAM/9000 Data Structures
Local_event_name
Local_event_name uniquely identifies a specific asynchronous function
call and also determines whether a call is synchronous or asynchronous.
If the call is synchronous, the value must be zero (0).
The em_wait() function uses Local_event_name to identify a completed
asynchronous operation. This identification is the same value that you
passed to the operation when you initiated it. Though em_wait() can wait
on multiple asynchronous operations, only one Local_event_name
returns per call. You must know the Local_event_name of the event for
which you are waiting.
Each outstanding asynchronous function must have a unique
Local_event_name with a value greater than zero (0). A recommended
practice is to start with the value one (1) and then increase by
increments. You will find this method especially helpful when tracking
incoming events.