Java 运行时属性(详细信息)

下表描述了部署描述符或程序属性文件中可以包括的属性,以及生成到 J2EE 环境文件中的值的源(如果有的话)。除非描述列另有声明,否则每个属性的 Java™ 类型都是 java.lang.String。

运行时属性 描述 生成的值的源
cso.cicsj2c.timeout 指定在使用 CICSJ2C 协议进行调用期间发生超时之前的毫秒数。缺省值为 30000,它表示 30 秒。如果将该值设置为 0,则不会发生超时。该值必须大于等于 0。

在此例中,Java 类型是 Java.lang.Integer。

当代码正在 WebSphere® 390 中运行时,该属性对调用没有任何影响;有关详细信息,请参阅为 CICSJ2C 调用设置 J2EE 服务器

构建描述符选项 cicsj2cTimeout
cso.linkageOptions.LO 指定链接属性文件的名称,该文件指导生成程序或包装器如何调用其它程序。LO 是生成时使用的链接选项部件的名称。有关详细信息,请参阅部署链接属性文件 LO 来自构建描述符选项 linkage;缺省值为后跟扩展名 .properties 的链接选项部件的名称
tcpiplistener.port

指定(类 CSOTcpipListener 或 CSOTcpipListenerJ2EE 的)EGL TCP/IP 侦听器用来进行侦听的端口号。不存在缺省值。有关详细信息,请参阅有关设置 TCP/IP 侦听器的主题。

在此例中,Java 类型是 Java.lang.Integer。

不生成
tcpiplistener.trace.file 指定要在其中记录一个或多个 EGL TCP/IP 侦听器(每个侦听器都具有类 CSOTcpipListener 或 CSOTcpipListenerJ2EE)的活动的文件名。缺省文件是 tcpiplistener.out。 不生成;跟踪仅供 IBM® 使用
tcpiplistener.trace.flag 指定是否跟踪一个或多个 EGL TCP/IP 侦听器(每个侦听器都具有类 CSOTcpipListener 或 CSOTcpipListenerJ2EE)的活动。选择下列各项之一:
  • 1 表示将活动记录到在属性 tcpiplistener.trace.flag 中标识的文件中
  • 0(缺省值)表示不记录活动

在此例中,Java 类型是 Java.lang.Integer。

有关详细信息,请参阅有关设置 TCP/IP 侦听器的主题。
不生成;跟踪仅供 IBM 使用
vgj.datemask. gregorian.long.locale 包含在下列两种情况的任何一种情况下使用的日期掩码:
  • 为系统变量 VGVar.currentFormattedGregorianDate 生成的 Java 代码被调用;或者
  • EGL 验证长度为 10 或更长的页项或文本表单字段(如果项属性 dateFormat 设置为 systemGregorianDateFormat 的话)。

locale 是在属性 vgj.nls.code 中指定的代码。在 Web 应用程序中,可以通过将另一个值赋值给 sysLib.setLocale 来更改所使用的日期掩码属性。

长格里历日期掩码的构建描述符值;缺省值是特定于语言环境的
vgj.datemask. gregorian.short.locale 包含当 EGL 验证长度小于 10 的页项或文本表单字段(如果项属性 dateFormat 设置为 systemGregorianDateFormat 的话)时使用的日期掩码。

locale 是在属性 vgj.nls.code 中指定的代码。在 Web 应用程序中,可以通过将另一个值赋值给 sysLib.setLocale 来更改所使用的日期掩码属性。

短格里历日期掩码的构建描述符值;缺省值是特定于语言环境的
vgj.datemask. julian.long.locale 包含在下列两种情况的任何一种情况下使用的日期掩码:
  • 调用为系统变量 VGVar.currentFormattedJulianDate 生成的 Java 代码;或者
  • 如果项属性 dateFormat 设置为 systemJulianDateFormat,则 EGL 验证页项或文本表单字段的长度是否为 10 或更长。

locale 是在属性 vgj.nls.code 中指定的代码。在 Web 应用程序中,可以通过将另一个值赋值给 sysLib.setLocale 来更改所使用的日期掩码属性。

长儒略历日期掩码的构建描述符值;缺省值是特定于语言环境的
vgj.datemask. julian.short.locale 包含当 EGL 验证长度小于 10 的页项或文本表单字段(如果项属性 dateFormat 设置为 systemJulianDateFormat 的话)时使用的日期掩码。

locale 是在属性 vgj.nls.code 中指定的代码。在 Web 应用程序中,可以通过将另一个值赋值给 sysLib.setLocale 来更改所使用的日期掩码属性。

短儒略历日期掩码的构建描述符值;缺省值是特定于语言环境的
vgj.defaultI4GLNativeLibrary 指定类型为 nativeLibrary 的库访问的 DLL 名称。如果未指定库属性 dllName,则该属性是必需的  
vgj.jdbc.database.SN 指定当通过系统函数 sysLib.connect 或 VGLib.connectionService 来建立数据库连接时使用的 JDBC 数据库名称。
该值对于 J2EE 连接和标准(非 J2EE)连接有不同的意义:
  • 对于 J2EE 连接(在生产环境中需要此连接),该值是在 JNDI 注册表中与数据源绑定的名称;例如,jdbc/MyDB
  • 对于标准 JDBC 连接(可能用于调试),该值是连接 URL;例如,jdbc:db2:MyDB

在部署时,当指定 SN 的替换值时,必须定制属性本身的名称。而替换值又必须与包含在 VGLib.connectionService 调用中的服务器名称或包含在 sysLib.connect 调用中的数据库名称相匹配。

要与指定的“服务器名称”相关联的数据库名称的构建描述符值
vgj.jdbc.default. database.autoCommit 指定在每次更改缺省数据库之后是否提交。有效值包括 true 和 false,如 sqlCommitControl 中所述。 构建描述符选项 sqlCommitControl
vgj.jdbc.default. database.programName 指定当先前不存在数据库连接时用于 SQL I/O 操作的缺省数据库名称。EGL 将包括程序名(或程序别名,如果有的话)来作为 programName 的替换值,因此,每个程序都有自己的缺省数据库。但是,程序名是可选的,并且名为 vgj.jdbc.default.database 的属性被用作未在此类特定于程序的属性中引用的任何程序的缺省值。

对于 J2EE 连接和非 J2EE 连接,此属性本身中的值的含义有所不同:

  • 对于 J2EE 连接,该值是在 JNDI 注册表中与数据源绑定的名称;例如,jdbc/MyDB
  • 对于标准 JDBC 连接,该值是连接 URL;例如,jdbc:db2:MyDB
取决于连接类型:
  • 对于 J2EE 连接,构建描述符选项 sqlJNDIName
  • 对于非 J2EE 连接,构建描述符选项 sqlDB
vgj.jdbc.default.password 指定用于访问在 vgj.jdbc.default.database 中标识的数据库连接的密码。
为了避免在 J2EE 环境文件中泄露密码,执行下列其中一项任务:
  • 使用系统函数 sysLib.connect 或 VGLib.connectionService 来在程序和函数脚本中指定密码;或者
  • 在 Web 应用程序服务器中的数据源规范中包括用户标识和密码,如设置 J2EE JDBC 连接中所述。
构建描述符选项 sqlPassword
vgj.jdbc.default.userid 指定用于访问在 vgj.jdbc.default.database 中标识的数据库连接的用户标识。 构建描述符选项 sqlID
vgj.jdbc.drivers 指定用于访问在 vgj.jdbc.default.database 中标识的数据库连接的驱动程序类。此属性在部署描述符或 J2EE 环境文件中不存在,并且仅用于标准(非 J2EE)JDBC 连接。 构建描述符选项 sqlJDBCDriverClass
vgj.messages.file 指定包括创建或定制的消息的属性文件。在下列两种情况下将搜索该文件:
  • 当 EGL 运行时响应函数 SysLib.getMessage 的调用时,该函数会返回您创建的消息;有关详细信息,请参阅 SysLib.getMessage
  • 当 EGL 尝试显示 Java 运行时消息时,如 EGL 运行时消息的消息定制中所述
 
vgj.nls.code 指定程序的三个字母的 NLS 代码。有关有效值的列表,请参阅 targetNLS。
如果未设置此属性,则下列规则适用:
  • 此值缺省为与缺省 Java 语言环境相对应的 NLS 代码
  • 如果缺省 Java 语言环境未与 EGL 支持的任何 NLS 代码相对应,则值为 ENU
构建描述符选项 targetNLS
vgj.nls.currency 指定用作货币符号的字符。缺省值由与 vgj.nls.code 相关联的语言环境确定。 构建描述符选项 currencySymbol
vgj.nls.number.decimal 指定用作十进制符号的字符。缺省值由与 vgj.nls.code 相关联的语言环境确定。 构建描述符选项 decimalSymbol
vgj.properties.file 仅当非 J2EE 运行单元中的第一个程序是使用 VisualAge® Generator 或 6.0 之前的 EGL 版本生成的时候,才应使用它。

vgj.properties.file 指定另一属性文件。将在非 J2EE 运行单元中全局使用该文件以替代任何非全局程序属性文件。全局文件的使用不受影响。(在使用旧版本 EGL 或 VisualAge Generator 生成第一个程序的运行单元中,全局文件被称为 vgj.properties。)

仅当将该属性包括在命令行伪指令中时,才会使用被属性 vgj.properties.file 引用的文件,如以下示例所示:

java -Dvgj.properties.file=c:\new.properties

vgj.properties.file 的值包括指向属性文件的标准路径。

在属性文件中指定属性 vgj.properties.file 不起作用。

 
vgj.ra.QN.conversionTable 指定在访问 QN 标识的 MQSeries® 消息队列期间由生成的 Java 程序使用的转换表的名称。有效值为 programControlled、NONE 或转换表名称。缺省值为 NONE。 资源关联属性 conversionTable
vgj.ra.FN.fileType 指定与 FN(这是在记录部件中标识的文件或队列名)相关联的文件的类型。属性值是 seqws 或 mq,如记录和文件类型交叉引用中所述。

必须为程序使用的每个逻辑文件指定此部署描述符属性。

资源关联属性 fileType
vgj.ra.FN.replace 指定 add 语句对与 FN(这是记录中标识的文件名)相关联的记录的作用。选择下列两个值中的一个:
  • 1(如果语句替换文件记录的话)
  • 0(缺省值,如果语句将记录追加至文件的话)

在此例中,Java 类型为 java.lang.Integer。

资源关联属性 replace
vgj.ra.FN.systemName 指定与 FN(这是在记录部件中标识的文件或队列名)相关联的物理文件或消息队列的名称。

必须为程序使用的每个逻辑文件指定此部署描述符属性。

资源关联属性 systemName
vgj.ra.FN.text 指定当通过串行记录来访问文件时是否导致生成的 Java 程序执行下列操作:
  • add 操作期间追加行结束字符。在非 UNIX 平台上,那些字符是回车符和换行符;在 UNIX® 平台上,只能是换行符。
  • get next 操作期间除去行结束字符。

FN 是与串行记录相关联的文件名。

选择下列其中一个值:
  • 1 表示进行更改
  • 0(缺省值)表示禁止进行更改

在此例中,Java 类型为 java.lang.Integer。

资源关联属性 text
vgj.trace.device.option 跟踪数据的目标(如果有的话)。选择下列其中一个值:
  • 0 表示写至 System.out
  • 1 表示写至 System.err
  • 2(缺省值)表示写至 vgj.trace.device.spec 中指定的文件,但在以下情况下例外:对于 VSAM I/O 跟踪,写至 vsam.out

在此例中,Java 类型为 java.lang.Integer。

生成的值(如果有的话)是 2
vgj.trace.device.spec 指定输出文件的名称(如果 vgj.trace.device.option 设置为 2 的话)。例外情况是:VSAM I/O 跟踪被写至 vsam.out。 生成的值(如果有的话)是 vgjtrace.out
vgj.trace.type 指定运行时跟踪设置。将感兴趣的值累加起来以获取想要的跟踪:
  • -1 表示全部跟踪
  • 0 表示不跟踪(缺省值)
  • 1 表示一般跟踪,包括函数调用和 call 语句
  • 2 表示处理数学的系统函数
  • 4 表示处理字符串的系统函数
  • 16 表示在 call 语句上传递的数据
  • 32 表示进行调用时使用的链接选项
  • 128 表示 jdbc I/O
  • 256 表示文件 I/O
  • 512 表示除 vgj.jdbc.default.password 之外的所有属性

在此例中,Java 类型为 java.lang.Integer。

生成的值(如果有的话)是 0

相关概念
Java 运行时属性
类型为 nativeLibrary 的库部件
链接属性文件

相关任务
部署链接属性文件
设置 J2EE JDBC 连接
为 EGL 生成的代码设置 J2EE 运行时环境

为 J2EE 应用程序客户机模块中的被调用程序设置 TCP/IP 侦听器
为调用的非 J2EE 应用程序设置 TCP/IP 侦听器
了解如何建立标准 JDBC 连接

相关参考
callLink 元素
cicsj2cTimeout
decimalSymbol
linkage
链接属性文件(详细信息)
EGL Java 运行时的消息定制
记录和文件类型交叉引用
sqlCommitControl
sqlDB
sqlID
sqlJDBCDriverClass
sqlJNDIName
sqlPassword
sysLib.connect
sysLib.getMessage
sysLib.setLocale
VGLib.connectionService
VGVar.currentFormattedGregorianDate
VGVar.currentFormattedJulianDate
VGVar.currentShortGregorianDate
VGVar.currentShortJulianDate
targetNLS

使用条款 | 反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.