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.
Run-time 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 |
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 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 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 systemGregorian.
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 systemJulian.
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.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
sysLib.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 sysLib.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.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.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.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 run-time 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 concepts
Java run-time properties
Linkage properties file
Related tasks
Deploying a linkage properties file
Setting up a J2EE JDBC connection
Setting up the J2EE run-time environment for EGL-generated code
Setting up the TCP/IP listener
Understanding how a standard JDBC connection is made
Related reference
callLink element
cicsj2cTimeout
decimalSymbol
linkage
Linkage properties file (details)
Record and file type cross-reference
sqlDB
sqlID
sqlJDBCDriverClass
sqlJNDIName
sqlPassword
sysLib.connect
sysLib.connectionService
sysLib.setLocale
sysVar.currentFormattedDate
sysVar.currentFormattedJulianDate
sysVar.currentShortDate
sysVar.currentShortJulianDate
targetNLS
(C) Copyright IBM Corporation 1992, 2005. All Rights Reserved.