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 J2EE, 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 J2EE deployment descriptor for the project; or
- a J2EE environment file.
In general, if one of the following is true:
- the generatable part is a JSF Handler part; or
- the generatable part is a VGWebTransaction, or
- the j2ee build descriptor option is
set to YES;
and if the
genProperties build descriptor
option is set to GLOBAL or PROGRAM, then the values of some build
descriptor options that are used at Java run
time get stored in a file.
If you are generating in a non-J2EE environment, EGL stores these
settings in a
program properties file. This is one of three
different possible files, which are searched in the following order:
- user.properties
- EGL does not create this file; you must create it yourself in
your home directory (for example, C:\Documents and Settings\Administrator).
- programName.properties
- EGL creates this file in the appropriate package in the Java Resources directory (for example, src/com/companyb/customerpackage)
if the genProperties build descriptor option
is set to PROGRAM.
- rununit.properties
- EGL creates this file in the Java Resources
directory if the genProperties build descriptor
option is set to GLOBAL.
All three are plain text files with entries in the form:
setting = value
This example shows what part of a properties file might look like:
# This file contains properties for generated
# Java programs that are being debugged in a
# non-J2EE Java project
vgj.nls.code = ENU
vgj.datemask.gregorian.long.ENU = MM/dd/yyyy