IMS 连接工厂属性

必须正确配置 IMS™ TM 资源适配器连接工厂的定制属性,以便与目标企业信息系统的特征相匹配。

创建 IMS 服务定义或者对 WebSphere® Application Server 定义 IMS 连接工厂时,必须为 IMS Connector for Java™ 与 IMS Connect 之间连接的某些属性提供值。以下列表描述了这些连接属性:

HostName
此值仅对于 TCP/IP 连接才是必需的。对于本地选项连接,会忽略该值。必须将值“myHostNm”替换为运行目标 IMS Connect 的机器的 IP 地址或主机名。
PortNumber
此值仅对于 TCP/IP 连接才是必需的。对于本地选项连接,会忽略该值。必须将值“0”替换为目标 IMS Connect 用于 TCP/IP 连接的端口编号。可在单个 TCP/IP 端口上打开多个套接字,并且可配置 IMS Connect 以使用多个端口与 IMS Connector for Java 和其他客户机进行通信。有关 PortNumber 属性的更多信息,请参阅 IMS Connect Guide and Reference(SC18-9287-02)中的“Configuring IMS Connect”。
CM0Dedicated
此值是可选的,并且仅适用于 TCP/IP 连接。缺省值为 FALSE。值为 FALSE 则表示连接工厂将生成可共享持久套接字连接,并且 IMS Connector for Java 将生成 clientID 来标识套接字连接。这些连接可供落实方式 0 以及落实方式 1 的交互进行使用。如果值为 TRUE,则表示连接工厂将生成专用持久套接字连接,这就要求使用用户指定的 clientID 来标识套接字连接。每个专用持久套接字连接是为特定 clientID 保留的,并且在专用持久套接字连接上只允许落实方式 0 交互。
SSLEnabled
此值是可选的,并且仅适用于 TCP/IP 连接。缺省值为 FALSE。值 TRUE 指示将使用此连接工厂及连接属性中指定的 HostName 和 PortNumber 创建与 IMS Connect 的 SSL 套接字连接。此 PortNumber 在 IMS Connect 配置中必须配置为 SSL 端口。值 FALSE 指示不会使用 SSL 套接字连接至 PortNumber 属性中指定的端口。
SSLKeyStoreName
此值是可选的,仅适用于 TCP/IP 连接,且 SSLEnabled 必须设置为 TRUE。SSL 专用密钥及其相关联的公用密钥证书都存储在称为密钥库、用密码保护的数据库中。为了方便起见,还可以将可信任的证书存储在密钥库中,而 Truststore Name 属性可以为空,也可以指向密钥库文件。如果 SSLKeyStoreName / SSKeyStorePassword 属性留空,则会在服务器日志中生成参考消息。
在 z/OS® 上运行时,可使用 SSLKeyStoreName 属性指定 JKS 密钥库或 RACF® 密钥环。对于非 z/OS 平台,指定 JKS 密钥库文件的标准路径名。对于 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 中运行时,如果 SSLKeyStoreName 与上述 RACF 密钥环格式相匹配,则 IMS Connector for Java 将使用指定的 RACF 密钥环作为其密钥库。如果指定的密钥库类型是除了 JCERACFKSJCE4758RACFKS 之外的任何类型,则 IMS Connector for Java 会尝试将指定的 SSLKeyStoreName 解释为 JKS 密钥库文件的名称。
注意:JKS 文件可以采用其他文件扩展名;它并非一定为 .ks。
SSLKeyStorePassword
此值是可选的,仅适用于 TCP/IP 连接,且 SSLEnabled 必须设置为 TRUE。指定密钥库的密码。
SSLTrustStoreName
此值是可选的,仅适用于 TCP/IP 连接,且 SSLEnabled 必须设置为 TRUE。对于非 z/OS 平台,指定 JKS 信任库文件的标准路径名。对于 z/OS,指定 JKS 名称或信任库的 RACF 密钥环。SSLKeyStoreName 和 SSLTrustStoreName 属性的值将使用相同格式。有关此格式的讨论,请参阅 KeyStore Name 属性的描述。
信任库文件是一个用来包含公用密钥或证书的密钥数据库文件(密钥库)。为了方便起见,还可以将专用密钥存储在信任库中,而 Keystore Name 属性可以为空,也可以指向信任库文件。如果 SSLTrustStoreName / SSLTrustStorePassword 属性留空,则会在服务器日志中生成一条参考消息。
注意:JKS 文件可以采用其他文件扩展名;它并非一定为 .ks。
SSLTrustStorePassword
此值是可选的,仅适用于 TCP/IP 连接,且 SSLEnabled 必须设置为 TRUE。指定信任库的密码。
SSLEncryptionType
SSLEncryptionType 属性的值不区分大小写且可选。它仅适用于 TCP/IP 连接,且 SSLEnabled 必须设置为 TRUE。请选择加密类型 STRONG、WEAK 或 ENULL。STRONG 和 WEAK 反映与密钥长度有关的密码强度。可用于导出的所有这些密码都属于 WEAK 类别,其他密码则属于 STRONG 类别。缺省情况下,加密类型设置为 WEAK。当指定了 ENULL 时,IMS TM 资源适配器将使用名称包含字符串“NULL”的加密算法规范。Null 加密允许在 SSL 握手过程中发生认证,这是当前真实情况。一旦套接字的握手过程(需要时包括认证)已完成,通过该套接字的所有消息就都将以明文形式流动。
IMSConnectName
此值仅对于本地选项连接才是必需的。指定目标 IMS Connect 的作业名。如果指定了 IMSConnectName,则会忽略主机名、端口号以及与 SSL 有关的属性。对连接工厂指定 IMS Connect 名称后,只能使用该连接工厂创建“本地选项”连接。
UserName
此值是可选的,如果应用程序组件或容器未提供 UserName 属性,则此值是用于由此连接工厂创建的连接的缺省安全授权工具(SAF)用户名。
Password
此值是可选的,如果使用了缺省用户名,则此值表示用于由此连接工厂创建的连接的密码。
GroupName
此值是可选的,如果使用了缺省用户名,则此值表示用于由此连接工厂创建的所有连接的 IMS 组名。
注: 只有在组件管理的 EIS 登录环境中才能提供 GroupName 属性。
DataStoreName
此值是必需的,它表示目标 IMS 数据存储器的名称。必须将缺省值“myDStrNm”替换为在目标 IMS Connect 配置成员中指定的数据存储器语句的标识参数。在 IMS Connect 与 IMS OTMA 之间进行内部 XCF 通信期间,此属性还用作 IMS 的 XCF 成员名。对 DataStoreName 指定的值区分大小写。
TraceLevel
此属性是可选的,它表示要跟踪的信息的级别。有关跟踪级别的其他信息,请参阅使用 IMS TM 资源适配器进行记录和跟踪
TransactionResourceRegistration
此值是可选的,它表示事务资源注册(事务参与)的类型。建议不要使用此属性,但为了与较早应用程序兼容仍然支持此属性。有效值为 STATIC(立即)或 DYNAMIC(延迟)。如果将此属性设置为 DYNAMIC,则会延迟将资源加入到事务作用域内,直到第一次将该资源用于交互为止。
MFS XMI Repository ID
此值是可选的,并且是用于标识存储库位置的唯一名称。此标识仅适用于 MFS 事务,必须与在应用程序的已生成格式处理程序中定义的存储库字段相匹配。此字段的缺省值为“default”。
MFS XMI Repository URI
此值是可选的,并且指定 XMI 存储库的物理位置。URI 适用于此字段的有效格式,包括:
  • 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。

反馈