---

2.6.1 OSA Events

   The OSA Event Manager uses the Presentation Manager to send OSA events 
   between applications on the same computer. 

   Applications typically use OSA events to request services and information 
   from other applications or to provide services and information in response 
   to such requests.  For example, any application can use the Get Data OSA 
   event to request that your application locate and return a particular set 
   of data, such as a table.  If your application supports the Get Data 
   event, it should be able to recognize the event and respond by locating 
   the requested data and returning a copy of the data to the application 
   that requested it. 

   Communication between two applications that support OSA events is 
   initiated by a client application, which sends an OSA event to request a 
   service or information.  For example, a client application might request 
   services such as printing specific files, checking the spelling of a list 
   of words, or performing a numeric calculation; or it might request 
   information, such as one customer's address or a list of names and 
   addresses of all customers living in Florida.  The application providing 
   the service or the requested information is called a server application. 

   The client application uses OSA Event Manager routines to create and send 
   the OSA event, and the server application uses OSA Event Manager routines 
   to interpret the OSA event and respond appropriately.  If the client 
   application requests that the server application adds information to a 
   reply OSA event, the server application adds the information that the OSA 
   Event Manager returns to the client application. 

   If an OSA event is one of the standard events defined in the OSA Event 
   Registry: Standard Suites, the client application can construct the event 
   and the server application can interpret it according to the standard 
   definition for that event.  To ensure that an application can respond to 
   OSA events sent by other applications, it should support the standard OSA 
   events that are appropriate for the application. 

IBM BookManager® BookServer Copyright 1989, 1999 IBM Corporation. All rights reserved.