当您创建 IMS™ 服务定义或者对 WebSphere® Application Server 定义 IMS 连接工厂时,必须为 IMS Connector for Java 与 IMS Connect 之间的连接的某些属性提供值。以下列表描述了这些连接属性:
- Host name
- 此属性对于 TCP/IP 连接是必需的:它表示运行目标 IMS Connect 的机器的 IP 地址或主机名。必须将值“myHostNm”替换为对于 IMS 环境有效的值。
- Port number
- 此属性对于 TCP/IP 连接是必需的:它表示目标 IMS Connect 用于建立 TCP/IP 连接的端口的编号。可以在单个 TCP/IP 端口上打开多个套接字。有关 PortNumber 属性的更多信息,请参阅 IMS Connect Guide and Reference(SC27-0946-03)中的“Configuring IMS Connect”。必须将值“0”替换为对于 IMS 环境有效的值。
- CM0Dedicated
- 缺省值为 false。值为 FALSE 则表示连接工厂将生成可共享持久套接字连接,并且 IMS Connector for Java 将生成 clientID 来标识套接字连接。这些连接可供落实方式 0 以及落实方式 1 的交互使用。如果值为 TRUE,则表示连接工厂将生成专用持久套接字连接,这就要求使用用户指定的 clientID 来标识套接字连接。专用持久套接字连接是为特定 clientID 保留的,并且只允许落实方式 0 的交互。此属性仅适用于 TCP/IP 连接。
- SSL Enabled
- 缺省值为 false。此属性仅对于 TCP/IP 连接有效。如果该属性的值为 true,则表示 IMS Connector for Java 将使用在这些连接属性中指定的 HostName 和 PortNumber 来创建与 IMS Connect 的 SSL 套接字连接。IMS Connect 必须将此端口配置为 SSL 端口。如果该属性的值为 false,则表示将不会使用 SSL 套接字来连接至在 Port Number 属性中指定的端口。
- KeyStore Name
- 对于非 z/OS 平台,指定 JKS 密钥库文件的标准路径名。对于
z/OS,可以按如上所示指定 JKS 密钥库文件的名称,也可以将它指定为一个特殊字符串,并且该字符串提供了访问 RACF 密钥环所需要的信息。
- 专用密钥及其相关联的公用密钥证书都存储在称为密钥库的用密码保护的数据库中。为了方便起见,还可以将可信任的证书存储在密钥库中,而 Truststore Name 属性可以是空的也可以指向密钥库文件。如果
TrustStore Name/TrustStore Password 属性是空的,则在服务器日志中会生成一条参考消息。
- 当在 z/OS 上运行时,密钥库名称可以用来指定 JKS 密钥库或 RACF 密钥环。JKS 密钥库文件的标准路径名的一个示例为:c:\keystore\MyKeystore.ks。RACF 密钥环被指定为:keystore_type:keyring_name:racfid。当对 SSL 使用了软件加密时,keystore_type 必须为 JCERACFKS;而如果使用了硬件加密,则 keystore_type 必须为 JCE4758RACFKS。将 keyring_name 替换为您正用作密钥库的 RACF 密钥环的名称;将 racfid 替换为已被授权访问指定密钥环的 RACF 标识。指定的 RACF 密钥环的示例为“JCERACFKS:myKeyring:kruser01”或“JCE4758RACFKS:myKeyring:kruser01”。当在 z/OS 中运行时,如果密钥库名称符合上述 RACF 密钥环格式,则 IMS Connector for Java 将使用指定的
RACF 密钥环作为它的密钥库。如果指定的密钥库类型是除了 JCERACFKS 或 JCE4758RACFKS 之外的任何类型,则 IMS Connector for Java 会尝试将指定的密钥库名称解释为 JKS 密钥库文件的名称。
- 注意:JKS 文件可以采用其它文件扩展名;它并不是必须为 .ks。
- KeyStore Password
- 指定密钥库的密码。专用密钥及其相关联的公用密钥证书都存储在称为密钥库的用密码保护的数据库中。
- TrustStore Name
- 对于非 z/OS 平台,指定 JKS 信任密钥库文件的标准路径名。对于
z/OS,指定信任密钥库的 JKS 名称或 RACF 密钥环。Keystore Name 和 Truststore Name 属性的值将使用相同的格式。有关此格式的讨论,请参阅对 Keystore Name 属性的描述。
- 信任密钥库文件是一个用来包含公用密钥或证书的密钥数据库文件(密钥库)。为了方便起见,还可以将专用密钥存储在信任密钥库中,而 Keystore Name 属性可以是空的也可以指向信任密钥库文件。如果
KeyStore Name/KeyStore Password 属性是空的,则在服务器日志中会生成一条参考消息。
- 注意:JKS 文件可以采用其它文件扩展名;它并不是必须为 .ks。
- TrustStore Password
- 指定信任密钥库的密码。信任密钥库文件是一个包含公用密钥的密钥数据库文件。
- Encryption Type
- 选择加密类型。STRONG 和 WEAK 与密码的强度(即,密钥长度)相关。可以用于导出的所有密码都属于 WEAK 类别,其它密码则属于 STRONG 类别。缺省情况下,加密类型设置为 WEAK。
- IMS Connect name
- 此属性对于“本地选项”连接是必需的:它表示目标 IMS Connect 的作业名。如果指定了 IMS Connect name,它就会覆盖 Host name、Port number 以及与 SSL 相关的属性。
- Default user name
- 此属性是可选的:如果应用程序组件未提供 UserName 属性,则此属性表示将用于由此连接工厂创建的连接的缺省安全授权工具(SAF)用户名。
- Default password
- 此属性是可选的:如果使用了 default user name,则此属性表示将用于由此连接工厂创建的连接的密码。
- Default group name
- 此属性是可选的:如果使用了 default user name,则此属性表示将用于由此连接工厂创建的所有连接的 IMS 组名。
注: 只有在组件管理的环境中才能提供 GroupName 属性。
- Data store name
- 此属性是必需的:它表示目标 IMS 数据存储器的名称。它必须与在 IMS Connect 配置成员中指定的 Datastore 语句的 ID 参数相匹配。在 IMS Connect 与 IMS OTMA 之间进行内部 XCF 通信期间,此属性还用作 IMS 的 XCF 成员名。必须将缺省值“myDStrNm”替换为对于 IMS 环境有效的值。
- Trace level
- 此属性是可选的:它表示要跟踪的信息的级别。有关跟踪级别的更多信息,请参阅 IMS 资源适配器的记录和跟踪。
- TransactionResourceRegistration
- 此属性是可选的:它表示事务资源注册(加入)的类型。有效值为“静态”(立即)或“动态”(延迟)。如果将此属性设置为“动态”,则会延迟将资源加入到事务作用域内,直到第一次将该资源用于交互为止。
- MFS XMI Repository ID
- 已定义的 J2C 连接工厂的一种资源属性,可在服务器配置的 J2C 选项页面上访问它。此字段包含一个用于标识资源库位置的唯一名称。此标识必须与在应用程序的已生成格式处理程序中定义的资源库字段相匹配。此字段的缺省值为“default”。
- MFS XMI Repository URI
- 已定义的 J2C 连接工厂的一种资源属性,可在服务器配置的 J2C 选项页面上访问它。此字段指定 XMI 资源库的物理位置。此字段的有效格式包括:
- file://path_to_xmi,其中 path_to_xmi 是包含 XMI 文件的本地文件系统上的一个目录,例如,file://c:/xmi。
- http://url_to_xmi,其中 url_to_xmi 是一个有效的 URL,它将被解析为包含 XMI 文件的一个目录,例如,http://sampleserver.com/xmi。
- hfs://path_to_xmi,其中 path_to_xmi 是主机 z/OS® 上的 HFS 目录。此格式仅支持 WebSphere Application Server for z/OS。