The next table describes the properties that can be included in the deployment descriptor or program properties file, as well as the source of the value generated into the J2EE environment file, if any. The Java™ type for each property is java.lang.String unless the description column says otherwise.
Runtime property | Description | Source of the generated value |
---|---|---|
cso.cicsj2c.timeout | Specifies the number of milliseconds before a timeout
occurs during a call that uses protocol CICSJ2C. The default value is 30000,
which represents 30 seconds. If the value is set to 0, no timeout occurs.
The value must be greater than or equal to 0. The Java type in this case is Java.lang.Integer. The property has no effect on calls when the code is running in WebSphere® 390; for details, see Setting up the J2EE server for CICSJ2C calls. |
Build descriptor option cicsj2cTimeout |
cso.linkageOptions.LO | Specifies the name of a linkage properties file that guides how the generated program or wrapper calls other programs. LO is the name of the linkage options part used at generation. For details, see Deploying a linkage properties file. | LO is from the build descriptor option linkage; and the default value is the name of the linkage options part followed by the extension .properties |
tcpiplistener.port | Specifies the number of the port on which an EGL TCP/IP listener (of class CSOTcpipListener or CSOTcpipListenerJ2EE) listens. No default exists. For details, see the topics that concern Setting up the TCP/IP listener. The Java type in this case is Java.lang.Integer. |
Not generated |
tcpiplistener.trace.file | Specifies the name of the file in which to record the activity of one or more EGL TCP/IP listeners (each is of class CSOTcpipListener or CSOTcpipListenerJ2EE). The default file is tcpiplistener.out. | Not generated; tracing is only for use by IBM® |
tcpiplistener.trace.flag | Specifies whether to trace the activity of one or more
EGL TCP/IP listeners (each of class CSOTcpipListener or CSOTcpipListenerJ2EE).
Select one of these:
The Java type in this case is Java.lang.Integer. For details, see the topics that concern Setting up the TCP/IP listener. |
Not generated; tracing is only for use by IBM |
vgj.datemask. gregorian.long.locale | Contains the date mask used in either of two cases:
locale is the code specified in property vgj.nls.code. In Web applications, you may change the date-mask property in use by assigning a different value to sysLib.setLocale. |
Build descriptor value for the long Gregorian date mask; the default value is specific to the locale |
vgj.datemask. gregorian.short.locale | Contains the date mask used when EGL validates a page
item or text-form field that has a length of less than 10, if the item property dateFormat is
set to systemGregorianDateFormat. locale is the code specified in property vgj.nls.code. In Web applications, you may change the date-mask property in use by assigning a different value to sysLib.setLocale. |
Build descriptor value for the short Gregorian date mask; the default value is specific to the locale |
vgj.datemask. julian.long.locale | Contains the date mask used in either of two cases:
locale is the code specified in property vgj.nls.code. In Web applications, you may change the date-mask property in use by assigning a different value to sysLib.setLocale. |
Build descriptor value for the long Julian date mask; the default value is specific to the locale |
vgj.datemask. julian.short.locale | Contains the date mask used when EGL validates a page
item or text-form field that has a length of less than 10, if the item property dateFormat is
set to systemJulianDateFormat. locale is the code specified in property vgj.nls.code. In Web applications, you may change the date-mask property in use by assigning a different value to sysLib.setLocale. |
Build descriptor value for the short Julian date mask; the default value is specific to the locale |
vgj.default.databaseDelimiter | Specifies the symbol used to separate one value from the next in the system functions SysLib.loadTable and SysLib.unLoadTable. The default value is a pipe (|). | Build descriptor option dbContentSeparator |
vgj.default.dateFormat | Sets the initial value of system variable StrLib.defaultDateFormat; for details on valid values, see Date, time, and timestamp specifiers | Build descriptor option defaultDateFormat |
vgj.defaultI4GLNativeLibrary | Specifies the DLL name accessed by a library of type nativeLibrary. The property is required if you did not specify the library property dllName | |
vgj.default.moneyFormat | Sets the initial value of system variable StrLib.defaultMoneyFormat; for details on valid values, see formatNumber() | Build descriptor option defaultMoneyFormat |
vgj.default.numericFormat | Sets the initial value of system variable StrLib.defaultNumericFormat; for details on valid values, see formatNumber() | Build descriptor option defaultNumericFormat |
vgj.default.timeFormat | Sets the initial value of system variable StrLib.defaultTimeFormat; for details on valid values, see Date, time, and timestamp specifiers | Build descriptor option defaultTimeFormat |
vgj.default.timestampFormat | Sets the initial value of system variable StrLib.defaultTimestampFormat; for details on valid values, see Date, time, and timestamp specifiers | Build descriptor option defaultTimestampFormat |
vgj.jdbc.database.SN | Specifies the JDBC database name that is used when a
database connection is made by way of the system function sysLib.connect or
VGLib.connectionService. The meaning of the value is different for J2EE
connections as compared with standard (non-J2EE) connections:
You must customize the name of the property itself when you specify a substitution value for SN, at deployment time. The substitution value in turn must match either the server name that is included in the invocation of VGLib.connectionService or the database name that is included in the invocation of sysLib.connect. |
Build descriptor value for the database name that you want to associate with the specified "server name" |
vgj.jdbc.default. database.autoCommit | Specifies whether a commit occurs after every change to the default database. Valid values are true and false, as described in sqlCommitControl. | Build descriptor option sqlCommitControl |
vgj.jdbc.default. database.programName | Specifies the default database name that is used for
an SQL I/O operation if no prior database connection exists. EGL includes
the program name (or program alias, if any) as a substitution value for programName so
that each program has its own default database. The program name is optional,
however, and a property named vgj.jdbc.default.database is used as a default
for any program that is not referenced in a program-specific property of this
kind. The meaning of the value in the property itself is different for J2EE connections as compared with non-J2EE connections:
|
Depends on the connection type:
|
vgj.jdbc.default.password | Specifies the password for accessing the database connection
identified in vgj.jdbc.default.database. To avoid
exposing passwords in the J2EE environment file, do one of the following tasks:
|
Build descriptor option sqlPassword |
vgj.jdbc.default.userid | Specifies the userid for accessing the database connection identified in vgj.jdbc.default.database. | Build descriptor option sqlID |
vgj.jdbc.drivers | Specifices the driver class for accessing the database connection identified in vgj.jdbc.default.database. This property is not present in the deployment descriptor or J2EE environment file and is used only for a standard (non-J2EE) JDBC connection. | Build descriptor option sqlJDBCDriverClass |
vgj.messages.file | Specifies a properties file that includes messages you
create or customize. The file is searched in these cases:
|
Build descriptor option userMessageFile |
vgj.nls.code | Specifies the three-letter NLS code of the program.
For a list of valid values, see targetNLS. If the property is not set,
these rules apply:
|
Build descriptor option targetNLS |
vgj.nls.currency | Specifies the character used as a currency symbol. The default is determined by the locale associated with vgj.nls.code. | Build descriptor option currencySymbol |
vgj.nls.number.decimal | Specifies the character used as a decimal symbol. The default is determined by the locale associated with vgj.nls.code. | Build descriptor option decimalSymbol |
vgj.properties.file | Used only if the first program in a non-J2EE run unit
was generated with VisualAge® Generator or with an EGL version that
preceded 6.0. vgj.properties.file specifies an alternate properties file. The file is used throughout a non-J2EE run unit in place of any non-global program properties file. Use of the global file is unaffected. (In run units whose first program was generated with the older EGL or with VisualAge Generator, the global file is called vgj.properties.) The file referenced by the property vgj.properties.file is used only if you include that property in a command-line directive, as in this example: java -Dvgj.properties.file= c:\new.properties The value of vgj.properties.file includes the fully qualified path to the properties file. Specifying the property vgj.properties.file in a properties file has no effect. |
|
vgj.ra.QN.conversionTable | Specifies the name of the conversion table used by a generated Java program during access of the MQSeries® message queue identified by QN. Valid values are programControlled, NONE, or a conversion table name. The default is NONE. | Resource associations property conversionTable |
vgj.ra.FN.fileType | Specifies the type of file associated with FN,
which is a file or queue name identified in the record part. The property
value is seqws or mq, as described in Record and file type cross-reference.
You must specify this deployment descriptor property for each logical file that your program uses. |
Resource associations property fileType |
vgj.ra.FN.replace | Specifies the effect of an add statement on a record
associated with FN, which is a file name identified in a record. Select
one of two values:
The Java type in this case is java.lang.Integer. |
Resource associations property replace |
vgj.ra.FN.systemName | Specifies the name of the physical file or message queue
associated with FN, which is a file or queue name identified in the
record part. You must specify this deployment descriptor property for each logical file that your program uses. |
Resource associations property systemName |
vgj.ra.FN.text | Specifies whether to cause a generated Java program
to do the following when accessing a file by way of a serial record:
FN is the file name associated with the serial record. Select
one of these values:
The Java type in this case is java.lang.Integer. |
Resource associations property text |
vgj.trace.device.option | Destination of trace data, if any. Select one of these
values:
The Java type in this case is java.lang.Integer. |
The generated value, if any, is 2 |
vgj.trace.device.spec | Specifies the name of the output file if vgj.trace.device.option is set to 2. An exception is that VSAM I/O traces are written to vsam.out. | The generated value, if any, is vgjtrace.out |
vgj.trace.type | Specifies the runtime trace setting. Sum the values
of interest to get the tracing you want:
The Java type in this case is java.lang.Integer. |
The generated value, if any, is 0 |
Related tasks
Deploying a linkage properties file
Setting up a J2EE JDBC connection
Setting up the J2EE runtime environment for EGL-generated code
Setting up the TCP/IP listener for a called appl in a J2EE appl client module
Setting up the TCP/IP listener for a called non-J2EE application
Understanding how a standard JDBC connection is made
Related reference
callLink element
cicsj2cTimeout
connect()
connectionService()
currentFormattedGregorianDate
currentFormattedJulianDate
currentShortGregorianDate
currentShortJulianDate
Date, time, and timestamp format specifiers
decimalSymbol
defaultDateFormat (EGL system variable)
defaultMoneyFormat (EGL system variable)
defaultNumericFormat (EGL system variable)
defaultTimeFormat (system variable)
defaultTimestampFormat (EGL system variable)
formatNumber()
getMessage()
linkage
Linkage properties file (details)
loadTable()
Message customization for EGL Java run time
Record and file type cross-reference
setLocale()
sqlCommitControl
sqlDB
sqlID
sqlJDBCDriverClass
sqlJNDIName
sqlPassword
targetNLS
unloadTable()