必须在本地节点上安装 z/OS® 资源归档 (RAR) 文件的优化本地适配器。在非 z/OS
平台上运行时,优化本地适配器 RAR 文件使用基于因特网 ORB 间协议的远程方法调用 (RMI-IIOP) 与远程 z/OS 节点上的优化本地适配器代理企业归档 (EAR) 文件实例通信。
开始之前
有关开发方式下的优化本地适配器的更多信息,请阅读“开发方式下的优化本地适配器部署”主题。
关于此任务
在本地节点上创建优化本地适配器连接工厂时,必须设置一些属性才允许进行此通信:
- RemoteHostname
- 远程 z/OS 节点的主机名
- RemotePort
- 远程 z/OS 节点上的 RMI 端口。它可以是特定 WebSphere® Application Server for z/OS 实例或 Node Agent 的 RMI 端口。
- RemoteJNDIName
- Java™ 命名和目录接口 (JNDI) 名称,此时远程节点上的 JNDI 中绑定了优化本地适配器代理 EAR。JNDI 查找是使用 JNDI InitialContext
执行的,JNDI InitialContext 是使用指定的 RemoteHostname 和 RemotePort 属性和通过请求 NameSpaceServerRoot 名称空间获取的。
- RemoteJNDIUsername
- 从远程节点获取 JNDI 命名上下文时要使用的用户名
- RemoteJNDIPassword
- 从远程节点获取 JNDI 命名上下文时要使用的密码。
- RemoteJNDIRealm
- 从远程节点获取 JNDI 命名上下文时要使用的领域名。本地节点和远程节点都使用 WebSphere 安全性但位于不同域中时,可能需要指定领域名。
过程
- 本地节点上的优化本地适配器 RAR 文件通过执行 JNDI 查找来获取对优化本地适配器代理 EAR 的引用。命名上下文是使用以下 URL 获取的:corbaloc:iiop:<RemoteHostname>:<RemotePort>/NameSpaceServerRoot。获取此上下文后,会使用 RemoteJNDIName 执行查找。 假定优化本地适配器代理 EAR 是使用缺省 JNDI 绑定位置在远程 z/OS
节点上安装的,那么可通过指定目标 WebSphere Application
Server for z/OS 实例的 RMI 端口和 RemoteJNDIName
com.ibm.ws390.ola.jca.ProxyEJBRemote(它是优化本地适配器代理远程接口的缺省绑定)在本地节点上安装优化本地适配器 RAR。
- 可通过在资源适配器的连接工厂属性上指定本地节点上的优化本地适配器 RAR 连接工厂的其他属性(例如,registerName)来设置这些属性。远程
z/OS 节点会使用这些值。
- 本地节点和远程 z/OS 节点可能未共享同一用户注册表。
优化本地适配器 RAR 连接工厂上提供了两个其他属性,以允许请求登录并指定要用于优化本地适配器交互的用户标识:
- Username
- 执行优化本地适配器交互时要使用的用户名
- Password
- 要与 Username 属性配合使用的密码。
指定 Username 和 Password 时,正好在执行优化本地适配器交互之前进行登录。如果登录成功,那么与 Username
对应的 z/OS 用户标识会随优化本地适配器请求发送。目前,MVS™
用户标识是在使用优化本地适配器链接服务器与 CICS® 通信时使用的。仅当在指定
SEC=YES 参数的情况下启动链接服务器并在指定 SEC=YES 参数的情况下运行 CICS 区域时,才会使用 z/OS 用户标识启动目标 CICS 事务。对于 IMS,仅当在 WebSphere Application Server
for z/OS 服务器上启用了 SYNC-TO-THREAD 选项并且 OTMASE=FULL OTMA 参数生效时,才会传播和断言此用户标识。
还可使用 J2C JAAS 别名来提供 Username 和 Password 值。要使用 J2C JAAS
别名,请在管理控制台中单击资源 > 资源适配器 >
J2C 连接工厂 > cf_name >
JAAS-J2C 认证数据 > alias_name,然后输入用户标识和密码。资源适配器会从此设置中检索用户标识和密码。如果提供了 JAAS 别名,又在连接工厂上提供了 Username 和 Password,那么连接工厂上的 Username 和
Password 优先。ConnectionSpecImpl 上的 setUserid() 和 setPassword() 方法优先于所有其他方法。