Connect Event Example

The following steps describe an Open Data Services connect event from its initiation, including the functions performed by the ODS Library and the functions performed by the Open Data Services server application:

1. The client application calls the DB-Library function dbopen. The dbopen function sends parameters to the client's network layer. The client's network layer sends the connection information to the LAN.
2. The Open Data Services network layer receives the client connection information. It creates and allocates an SRV_PROC structure containing the connection information and issues a connect event to the ODS Library.
3. The ODS Library calls the connect event handler provided in the Open Data Services server application, as shown in the following illustration:

   

4. The connect event handler provides whatever additional processing it defines.

   For example, if the Open Data Services server application provides a gateway, the connect event handler might respond to this event by establishing a connection to a remote database management system.

5. The connect event handler returns connection information to the client, as shown in the following illustration:

   

This completes the processing for the connect event. At this point, the client is logged in. Open Data Services waits for additional requests from the client, at which point the ODS Library generates another event and calls the appropriate event handler.