APPLICATION (for a service)

This APPLICATION element defines a service within the Genero Application Server configuration file or in an external application configuration file.

Note: Since Genero 2.0, Web services are named applications as they host several Web services in one DVM.

Syntax

<APPLICATION [Id="app-name"]
       Parent="parent-app-name"
       xmlns:xsi="uri" 
       xsi:noNamespaceSchemaLocation="schema"
       [Abstract="{TRUE|FALSE}"]
       [mode="mode-name"]>
   [<DESCRIPTION>...</DESCRIPTION>]
   [<RESOURCE>...</RESOURCE>] [...]
   [<PROXY>...</PROXY>]
   [<EXECUTION>...</EXECUTION>]
   [<TIMEOUT>...</TIMEOUT>]
</APPLICATION>
  1. The app-name identifies the application. The Id attribute is required for applications defined within the Genero Application Server configuration file. For external configuration files, the Id attribute is ignored. The Id specified is compared to the application name in the request.
  2. The parent-app-name identifies the parent application, or the application from which this application will inherit its default configuration settings.
  3. The uri defines the URL of the XML schema. The default value is "http://www.w3.org/2001/XMLSchema-instance".
  4. The schema defines the XML schema instance. When defining external application files, the valid value for a Web service is "http://www.4js.com/ns/gas/version/cfextws.xsd"
  5. The Abstract attribute defines whether this application configuration element is for an abstract application or a real application. Valid values are "TRUE" and "FALSE". An abstract application acts as a template and can not instantiate Virtual Machines.
  6. The mode-name when set to "sticky", defines a Web service as a sticky Web service. See Configure sticky Web services.

Child elements

When you define a Web service application, you can specify the following elements:

  1. Zero or one DESCRIPTION element.
  2. Zero or more RESOURCE elements.
  3. Zero or one PROXY (for a service) element
  4. Zero or one EXECUTION element.
  5. Zero or more TIMEOUT elements.

Usage

You use this element to configure Web services you wish to make accessible through the GAS.

Example usage

<APPLICATION Id="webapp" Parent="ws.abswebapp">
  <EXECUTION>
    <PATH>$(res.path.fgldir.demo)</PATH>
    <MODULE>webapp.42r</MODULE>
  </EXECUTION>
  <TIMEOUT> </TIMEOUT>
</APPLICATION>

Parent elements

When used in an application configuration file (.xcf), it is the top-most element. When used in the GAS configuration file, this element is a child of the SERVICE_LIST element.