WEB APPLICATION TIMEOUT COMPONENT

The WEB_APPLICATION_TIMEOUT_COMPONENT element creates a Web application timeout component, which define a set of timeout values to be used when configuring a Web application. It takes an attribute Id, which specifies the unique identifier for this set of timeout definitions. It is this unique identifier that is referenced with an application's configuration, providing that application with a set of timeout values.

Why are Web application timeouts necessary? When a Front End client connects to a DVM via the Genero Application Server (GAS), the connection between the Front End client and the GAS is not persistent (although the connection between the GAS and the DVM is persistent). The Genero Application Server needs the timeout settings to determine whether these components have remained alive and that communication can continue between the two.

The Front End client can send two types of requests to the DVM: a POST request when sending data to the DVM and a GET request when asking whether there is data to retrieve. The Genero Application Server, however, cannot send a request to the Front End client because the Front End client does not have a public address.

As a result, a request is always initiated by the Front End client and the server response is done with the same connection. Between requests, the Genero Application Server stores data sent from the DVM in its buffer and keeps it for the next GET request from the Front End client.

Syntax

<WEB_APPLICATION_TIMEOUT_COMPONENT Id="appTimeOutID">
 [ <USER_AGENT> uaTimeOut </USER_AGENT> ]
 [ <REQUEST_RESULT> requestTimeOut </REQUEST_RESULT>]
 [ <DVM_AVAILABLE> dvmTimeOut </DVM_AVAILABLE> ]
 [ <DVM_PINGTIMEOUT> dvmPingTimeOut </DVM_PINGTIMEOUT> ]
</WEB_APPLICATION_TIMEOUT_COMPONENT>

Child elements

The WEB_APPLICATION_TIMEOUT_COMPONENT element may contain the following child elements:

Zero or one USER_AGENT element.
Zero or one REQUEST_RESULT element.
Zero or one DVM_AVAILABLE element.
Zero or one DVM_PINGTIMEOUT element.

Example

<WEB_APPLICATION_TIMEOUT_COMPONENT Id="cpn.wa.timeout.set1">
  <USER_AGENT>300</USER_AGENT>
  <REQUEST_RESULT>60</REQUEST_RESULT>
  <DVM_AVAILABLE>10</DVM_AVAILABLE>
  <DVM_PINGTIMEOUT>300</DVM_PINGTIMEOUT>
</WEB_APPLICATION_TIMEOUT_COMPONENT>

In this example, the Id value - cpn.wa.timeout.set1 - can be referenced when defining an application. When an application references a component by its Id value, it inherits the settings defined by that component.