APPLICATION (for an application)

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

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>] [...]
   [<EXECUTION>...</EXECUTION>]
   [<AUTO_LOGOUT>...</AUTO_LOGOUT>] 
   [<UA_OUTPUT>...</UA_OUTPUT>]
   [<END_URL>...</END_URL>]
</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 applications is "http://www.4js.com/ns/gas/version/cfextwa.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

The APPLICATION element may contain the following elements:

  1. Zero or one DESCRIPTION element.
  2. Zero or more RESOURCE elements.
  3. Zero or one EXECUTION (for an application) elements.
  4. Zero or one AUTO_LOGOUT elements.
  5. Zero or one UA_OUTPUT elements. This element is used for all UI applications.
  6. Zero or one END_URL element.

Usage

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

Example external Web application configuration file

<?xml version="1.0" encoding="UTF-8"?>
  <APPLICATION Parent="defaultgwc"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.4js.com/ns/gas/3.21/cfextwa.xsd">
  <EXECUTION>
    <PATH>$(res.path.fgldir.demo)</PATH>
    <MODULE>demo.42r</MODULE>
    <ACCESS_CONTROL>
        <ALLOW_FROM>$(res.access.control)</ALLOW_FROM>
    </ACCESS_CONTROL>
  </EXECUTION>
  <AUTO_LOGOUT Using="cpn.wa.autologout"/>
  <UA_OUTPUT>
     <PROXY>$(res.uaproxy.cmd)</PROXY>
     <PUBLIC_IMAGEPATH>$(res.public.resources)</PUBLIC_IMAGEPATH>
     <GBC>gwc-dev</GBC>
     <TIMEOUT> Using="cpn.wa.timeout"</TIMEOUT>
  </UA_OUTPUT>
  <END_URL>http://www.4js.com</END_URL>
</APPLICATION>

For more information, see Configuring applications on GAS.

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 APPLICATION_LIST element.