Websydian v6.1 online documentationOnline documentation - Websydian v6.5

Implementing the Application Service Listener Function

Specify and Implement Application Service Listener

A DWA Websydian application is designed and developed like a standard Websydian application with a Dispatcher function and a number of Page Generator functions and Event Handlers implementing the HTML pages and the events (HTML buttons or links) in the application.

The only difference now is that an additional listener job - the Application Service Listener (also known as Application Listener function) - must be specified to accept connections from the Websydian Web Server Component. To create this function, inherit from the WSYBASE/ApplicationServiceListener function.

Create the following triples (replace MySessionControl with the Session Control implemented in the model - if Session Control is implemented):

MyListener is a FNC WSYBASE/ApplicationServiceListener
MySessionControl.Abstract.ApplicationServiceListener
calls FNC MyDispatcher
impl name NME DWASvc
file name NME DWASvc

In the Call to EventDispatcher edit point, insert a call to the Dispatcher function and give the Application Service Listener function a meaningful implementation and file name.

If Session Control is implemented the ApplicationServiceListener must inherit from the abstract ApplicationServiceListener placed under Abstract in the implemented Session Control entity.

Generate and Build

Before you generate and build the application, remember to set the variant for the WSYBASE library model to the desired DWA variant, e.g. DWA - Windows.

Generate and build the objects contained in the subject area specific for your choice of variant. Please refer to Generate and Build Considerations for more details.

For information on how to configure the Generate and Build settings please refer to Setting up Your CA Plex Environment.

Please refer to the deployment part for details on how to deploy, setup and configure a DWA system.

The Application Service Listener must be configured correctly when deployed. Please refer to the Deploying DWA Applications document for further information on deployment.

Windows Specific Implementation

If the variant used is DWA - Windows, it is necessary to create an EXE-wrapper for the Application Listener Function to launch the Application Service Listener.