Event overview

An Open Server application responds to requests from clients. Some of these requests trigger a Server-Library event.

Not all events are provoked by client activity. The application itself queues programmer-defined events and SRV_DISCONNECT, SRV_URGDISCONNECT, and SRV_STOP events by calling the srv_event or srv_event_deferred routine. For more information on using the srv_event routine to raise events, see its reference page. Open Server can also trigger a SRV_STOP event in response to a fatal server error. Open Server raises a SRV_START event automatically, as part of the server’s start-up process.

An event occurs in a specific context; it corresponds to a particular category of activity. For example, a connection attempt from a client or remote server triggers a SRV_CONNECT event, while a client’s bulk copy request causes Open Server to raise a SRV_BULK event.

There are two kinds of events in Open Server: standard and programmer-defined. Standard events are defined internally in Open Server. Programmer-defined events are, as the name suggests, defined within the application. For more details on both kinds of events, see“Standard events”, and “Programmer-defined events”.