The build descriptor option genProperties specifies
what kind of Java™ runtime properties to generate (if any) and, in
some cases, whether to generate a linkage properties file. This build descriptor
option is meaningful only when you are generating a Java program
(which can use either kind of output) or a wrapper (which can use only the
linkage properties file).
Valid values are as follows:
- NO (the default)
- EGL does not generate runtime or linkage properties.
- PROGRAM
- The effects are as follows:
- If you are generating a program to run outside of J2EE, EGL generates
a properties file that is specific to the program being generated. The name
of that file is as follows:
pgmAlias.properties
- pgmAlias
- The name of the program at run time.
- The other effects occur whether you specify PROGRAM or GLOBAL:
- If you are generating a program that runs in J2EE, EGL generates a J2EE
environment file or into a deployment descriptor; for details, see Understanding
alternatives for setting deployment-descriptor values.
- If you are generating a Java wrapper or calling program, EGL may
generate a linkage properties file; for details on the situation in which
this file is generated, see Linkage properties file (reference).
- GLOBAL
- The effects are as follows:
- If you are generating a program to run outside of J2EE, EGL generates
a properties file that is used throughout the run unit but is not named for
the initial program in the run unit. The name of that properties file is rununit.properties.
This
option is especially useful when the first program of a run unit does not
access a file or database but calls programs that do.
When generating
the caller, you can generate a properties file named for the program, and
the content might include no database-related properties. When you generate
the called program, you can generate rununit.properties,
and the content would be available for both programs.
- The other effects occur whether you specify GLOBAL or PROGRAM:
- If you are generating a program that runs in J2EE, EGL generates a J2EE
environment file or into a deployment descriptor; for details, see Understanding
alternatives for setting deployment-descriptor values.
- If you are generating a Java wrapper or calling program, EGL may
generate a linkage properties file; for details on the situation in which
this file is generated, see Linkage properties file (reference).
For further details, see Java runtime properties and Linkage
properties file.