Application configuration file

Create an application configuration file to provide the Genero Application Server (GAS) with the information needed to run an application.

The configuration file has an .xcf file extension. The filename identifies the name of the application. For example, if the configuration file is named app1.xcf, the name of your application (as it appears in the URL) is http://localhost:6394/ua/r/app1.

The configuration file defines an application environment. It starts with the APPLICATION (for an application) element. Within this element, you can have other elements:
  • defining local resources
  • specifying the execution environment
  • specifying the timeout, resources, and output settings
  • referring to previously defined components by using the attribute Using

The organization of the elements within the application configuration file depend on the type of application; whether it is for Genero Browser Client (GBC), Genero Web Service (GWS), or Genero Desktop Client (GDC).

Save the file in a defined GROUP directory. By default, the directory where the GAS searches for external application configuration files is defined in the GAS configuration file (default as.xcf) by the element:
<GROUP Id="_default">directory</GROUP>

The application configuration file becomes available once added to the GAS. It is re-read at each application launch. There is no need to restart the GAS after modifying an application configuration file.

This examples shows a well-formed external application configuration files.

Example - A simple application configuration file

The simplest application configuration file specifies a parent application and the path to the compiled application files. The application inherits the configuration of the parent application.

Things to note in this example:
  1. The Id attribute of <APPLICATION> element is omitted; even if included, its value is not read.
  2. The Parent application is the default abstract applications defaultwa.
  3. The path to the application executables is defined by the PATH component.
  4. The MODULE element can specify the name of the .42r module to run. In this example the module name is the same as the configuration filename; therefore the element is not necessary.
<APPLICATION Parent="defaultwa"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:noNamespaceSchemaLocation="http://www.4js.com/ns/gas/4.01/cfextwa.xsd">
  <EXECUTION>
    <PATH>$(res.path.fgldir.demo)/Widgets</PATH>
  </EXECUTION>
</APPLICATION>