JEE deployment descriptor

In addition to the properties associated with EGL parts, there are a number of Java™ runtime properties that control access to databases, files, and other resources. To help distinguish them from EGL properties, and to emphasize the fact that they are not properties under JEE, this documentation may refer to these Java™ runtime properties as settings.

When you generate Java™ code, and you have the genProperties build descriptor option set to GLOBAL or PROGRAM, the settings in various build descriptor options are stored as Java™ runtime properties, and are written to one of three locations:
  • a program properties file;
  • the JEE deployment descriptor for the project; or
  • a JEE environment file.
The JEE deployment descriptor is not created by EGL. However, if the following conditions apply, EGL will update the JEE deployment descriptor:
  • the j2ee build descriptor option to YES;
  • the genProject build descriptor option is set to a JEE project.
If the above conditions do not apply, Java™ runtime properties will either be stored in a program properties file, or a JEE environment file.

Updating the JEE deployment descriptor manually

If you are updating a deployment descriptor from a generated JEE environment file, follow these steps:
  1. Read the overview information in Setting JEE deployment descriptor values.
  2. If you worked on an application client or EJB project, you must make sure that the order of the sub-elements in the generated environment entries is correct, as described in JEE environment file.
  3. Copy the environment entries into your project's deployment descriptor as follows:
    1. Make a backup copy of the deployment descriptor.
    2. Open the JEE environment file, which is called programName-env.txt file. Copy the environment entries into the clipboard.
    3. Double-click on the deployment descriptor.
    4. Click on the Source tab.
    5. Paste the entries at a proper location.