[z/OS]

将优化本地适配器用于入站支持

实现优化本地适配器支持以对 WebSphere® Application Server for z/OS® Enterprise JavaBeans (EJB) 应用程序进行入站调用时,请使用此任务。

关于此任务

使用优化本地适配器以进行从外部地址空间至本地 WebSphere Application Server for z/OS 服务器上部署的 EJB 应用程序的入站调用,并进行从在 WebSphere Application Server for z/OS 下运行的应用程序至外部地址空间中运行的服务器程序的出站调用。下列步骤描述使用优化本地适配器应用程序编程接口 (API) 来调用本地 WebSphere Application Server for z/OS 服务器上部署的 EJB 应用程序时所需遵循的过程。

以下图示显示将优化本地适配器与客户信息控制系统 (CICS®) 配合使用时的流程。以下图示显示将优化本地适配器与客户信息控制系统 (CICS) 配合使用时的流程。CICS 至应用程序服务器 EJB 应用程序的入站调用

以下图示是将优化本地适配器与信息管理系统 (IMS™) 配合使用时的流程。 通过优化本地适配器对应用程序服务器的旧 IMS 入站调用

过程

  1. 启用服务器环境。 在此步骤中,将通过 WebSphere 环境变量在 WebSphere Application Server 守护程序组或单元中激活对优化本地适配器的支持。这会准备 WebSphere Application Server 以接收入站请求。
  2. 开发 EJB 应用程序。 您可以开发 EJB 应用程序或准备现有的应用程序。如果要调用 Cobol 或 C/C++ 程序或者要从 Cobol 或 C/C++ 程序进行调用,那么您可能想要使用 IBM® Rational® Application Developer 组装工具(例如,Rational® Application Developer)来创建带有与 Cobol 副本或 C/C++ 结构相对应的 getter 和 setter 辅助方法的 Java™ 类,并创建要通过优化本地适配器本机 API 启动的 EJB 应用程序。

    有关使用组装工具将 Cobol 副本或 C 结构转换为 Java 数据绑定辅助类的更多信息,请参阅组装工具信息中心。

    这些组装工具随 WebSphere Application Server for z/OS 交付并包含带有程序包 com.ibm.websphere.ola 的 Java 归档 (JAR) 文件,您必须将企业 Bean 标识为优化本地适配器调用的潜在目标。此程序包包含 ExecuteHome 和 Execute 类,这些类存放调用适配器所需的抽象接口。必须创建无状态会话 bean,该 bean 实现接受字节数组作为输入并返回字节数组作为输出的 execute() 方法,并对 EJB home 接口指定名称 com.ibm.websphere.ola.ExecuteHome,对远程接口指定 com.ibm.websphere.ola.Execute。要从外部地址空间启动的企业 Bean 必须包括名为 execute 的方法,该方法接受字节数组作为输入并返回字节数组作为输出。当外部地址空间使用其中一个适配器 API 调用(例如 Invoke 或 Send Request)时,此方法将接收到控制权。execute 方法是在远程接口 com.ibm.websphere.ola.Execute 中定义的,它包含应用程序的业务逻辑。

    注意: EJB 实现不能以任何方式修改或扩充 Home 接口和远程接口。远程接口的 execute 方法不支持应用程序异常。如果应用程序必须抛出异常,那么必须抛出 EJBException,后者可以有选择地包装所抛出的原始异常。
  3. 部署 EJB 应用程序。 开发 EJB 应用程序之后,必须将其打包到企业归档 (EAR) 文件中并将其部署到 WebSphere Application Server。此 EJB 应用程序将使用 com.ibm.websphere.ola 程序包中提供的 Home 接口和远程接口。以此方式开发的企业 Bean 将被赋予 Java 命名和目录接口 (JNDI) Home 名称并像任何其他 EJB 组件一样进行部署。要了解关于安装应用程序的更多信息,请阅读“安装企业应用程序文件”主题。
  4. (可选)使用 CICS 环境。 仅当连接至并使用客户信息控制系统 (CICS) 时,才需要完成此步骤。如果您正在使用 CICS,请使用此步骤来激活 CICS 区域中的适配器,以便对本地 WebSphere Application Server 上部署的 EJB 应用程序进行出站调用。这些出站调用是使用优化本地适配器本机 API 进行的。如果未使用 CICS,请跳至下一步。
    注意: 如果计划将 SAF 用户标识从 WebSphere Application Server for z/OS 传播至 CICS,请确保产品正在使用基于 SAF 的用户注册表。
  5. (可选)使用 IMS 环境。 如果连接至并使用 IMS 应用程序,请完成此步骤。
  6. 注册外部地址空间。 要让优化本地适配器对本地守护程序组或 WebSphere Application Server 单元进行入站调用,必须将当前地址空间与该 WebSphere Application Server 守护程序组绑定并设置连接属性。
  7. 保护用于入站支持的优化本地适配器。
  8. 进行入站调用。 根据要实现的目标以及所使用系统的不同,选择用于通过本机 API 进行调用的方法。
    1. 使用优化本地适配器本机 API 来调用无状态会话 bean 以及从外部地址空间连接到 WebSphere Application Server 在此方法中,您使用基本 API 从外部本机语言程序启动 EJB 应用程序并检索响应。此方法是为希望更为灵活并且响应区域最大长度在调用前未知的应用程序设计的。
    2. 使用优化本地适配器调用 API 来调用无状态会话 bean 以及从外部地址空间连接到 WebSphere Application Server 在此方法中,您使用调用 API 从外部本机语言程序中启动 EJB 应用程序并检索响应。此方法是为希望简化路径并且响应区域长度在调用前已知的使用者设计的。
    3. 使用优化本地适配器从客户机启动的事务中的外部地址空间中调用 WebSphere Application Server 中的 EJB 应用程序 在此方法中,您在客户机环境中开始一个事务,并调用正在 WebSphere Application Server 上运行的 EJB 应用程序。新事务将传播至 WebSphere Application Server。仅当从支持事务的环境(例如,CICS)中进行调用时,才支持此方法。
    4. 使用优化本地适配器从 WebSphere Application Server 中调用 EJB 应用程序,并忽略事务上下文 在此方法中,您在客户机环境中开始一个事务,然后调用 WebSphere Application Server 上部署的 EJB 应用程序并忽略事务上下文。仅当从支持事务的环境(例如,CICS)中进行调用时,才支持此方法。
  9. (可选)监视优化本地适配器。

结果

您已实现优化本地适配器支持,以便对 WebSphere Application Server 上部署的 EJB 应用程序进行入站调用。

指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_useola_in
文件名:tdat_useola_in.html