genProperties

The build descriptor option genProperties specifies what kind of Java run-time 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 run-time 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 run-time properties and Linkage properties file.

Related concepts
J2EE environment file
Java run-time properties
Linkage options part
Linkage properties file

Related tasks
Build descriptor options
Setting deployment-descriptor values

Related reference
Java run-time properties (details)