如果您想要使用出站 API 从部署在
WebSphere® Application Server for z/OS® 上的应用程序中连接到外部地址空间中的应用程序,请使用此任务。
开始之前
必须设置守护程序组、地址空间和外部地址空间,这样才能使用优化本地适配器 API。必须通过调用 BBOA1REG API 在守护程序组中注册外部地址空间。
在外部地址空间中运行的应用程序必须已使用其中一个 API(包括 BBOA1SRV、BBOA1RCA 或 BBOA1RCS)将其自身注册为优化本地适配器服务器任务。
请使用
WebSphere Application Server 管理控制台或
olaRar.py 脚本对优化本地适配器资源适配器归档 (RAR) 文件
ola.rar 进行部署和配置。
过程
- 找到将要进行外部调用的应用程序中的应用程序部署描述符。 这是部署在
WebSphere Application Server 上并且要从中进行出站调用的应用程序。
- 创建指向优化本地适配器连接工厂的资源引用。 优化本地适配器连接工厂是您在 WebSphere Application Server 上安装 ola.rar 文件时创建的。
- 找到优化本地适配器的连接工厂。 可以通过在 Java™ 命名目录接口 (JNDI) 中查找资源引用来找到此连接工厂,例如:
Context ctx = new InitialContext();
ConnectionFactory cf = ctx.lookup("java:comp/env/ola");
- 创建 ConnectionSpecImpl 方法调用并提供要连接到的注册名称。 可使用注册名称作为受管连接工厂上的属性,或使用 ConnectionSpecImpl 方法 setRegisterName 来提供正在所要连接的外部地址空间或子系统中运行的应用程序的注册名称。这必须是外部地址空间或子系统中的应用程序使用某个服务器优化本地适配器 API(BBOA1SRV、BBOA1RCA 或 BBOA1RCS)提供的注册名称。例如,
ConnectionSpecImpl csi = new ConnectionSpecImpl();
csi.setRegisterName ("MyRES1");
注意: 如果在 ConnectionFactory 对象上使用
RegisterName 定制属性指定了注册名称,那么不必在 ConnectionSpecImpl
对象上设置注册名称。
注意: 如果要使用资源适配器高可用性功能,那么必须确保应用程序未使用
setRegisterName 方法,并且您必须在受管连接的连接工厂属性中配置目标注册名称。有关如何配置高可用性的更多信息,请参阅“启用资源适配器高可用性支持”主题。
- 可选: 如果要调用未使用优化本地适配器服务器 API(BBOA1SRV、BBOA1RCA
或 BBOA1RCS)的信息管理系统 (IMS™) 事务,请使用此步骤设置
IMS 开放式事务管理器访问 (OTMA) 参数。 可将 IMS OTMA
服务器名称、XCF 组标识和事务级别设置为受管连接工厂上的属性,或使用对应 ConnectionSpecImpl
setter 方法(setOTMAServerName、setOTMAGroupID 和 setOTMATranLevel)来为正在外部地址空间中运行的应用程序或您要连接至的子系统提供此信息。
注意: 使用基于 OTMA 的优化本地适配器时,注册名称在 IMS 事务端没有对应项。可设置注册名称,但它不会用于基于 OTMA 的优化本地适配器。有关更多信息,请参阅“使用基于 OTMA 的优化本地适配器调用现有
IMS 事务”主题。
- 使用连接工厂来创建连接,例如:
Connection con = cf.getConnection(csi);
结果
WebSphere Application Server 上部署的应用程序连接至外部地址空间,并且准备调用位于外部地址空间的服务。