使用 WebSphere 优化本地适配器 (WOLA) 调用 API 从外部地址空间调用部署在 z/OS® 的本地 Liberty 服务器上的无状态会话 bean。
开始之前
要将企业 bean 标识为优化本地适配器调用的潜在目标,Enterprise JavaBean (EJB) 应用程序必须将 com.ibm.websphere.ola.ExecuteLocalBusiness 接口作为本地业务接口来实现。该接口位于 wlp/dev/api/ibm/com.ibm.websphere.appserver.api.zosLocalAdapters_1.0.0.jar 文件中。
在发出注册请求的同一 z/OS 映像上,Liberty 服务器必须处于活动状态。请确保当前地址空间已注册,并且已使用注册 API 绑定至目标优化本地适配器组。有关注册外部地址空间的更多信息,请参阅使用优化本地适配器向本地 Liberty 服务器注册外部地址空间。
关于此任务
当您在调用企业 bean 之前就知道响应区域长度时,这种调用企业 bean 的方法提供了一种简化方法。如果您在调用企业 bean 时不知道响应区域长度或者希望具有更高的灵活性,请参阅
使用 Liberty 优化本地适配器 API 从外部地址空间调用企业 bean。
过程
- 确定当您使用“调用”API BBOA1INV 来调用 Bean 时要使用哪些参数。
该 API 接受下列各项的参数:
- 您调用“注册”API 时所指定的注册名称
- 请求类型,对于本地 EJB 工作请求,必须将请求类型设置为 1
- 要调用的服务的名称,必须为无状态会话 bean 的 Java™ 命名和目录接口 (JNDI) 本地业务接口路径名
- 服务名称的长度
- 指向要发送的请求数据开始处的地址的指针
- 要发送的请求数据的长度
- 指向响应数据区域开始处的地址的指针
- 要发送的响应数据的长度
- 在连接超时之前的秒数
有关 API 参数的更多信息,请参阅Liberty for z/OS 上的优化本地适配器 API。
- 从客户机地址空间中的本地语言应用程序中,使用所选参数对调用者调用该调用 API。 在目标 Enterprise JavaBeans (EJB) 应用程序中,execute 方法将运行并接着启动任何所需的业务逻辑,然后将响应数据作为序列化字节数组返回给本地语言调用者。
- 查看响应数据。 返回码和原因码 0 表明已成功完成客户机调用 API 调用,响应数据和响应数据长度将保存在调用者指定的区域中。
- 客户机应用程序将使用同一注册名称调用来重复这些步骤,从而根据需要按所需频率调用任意数目的无状态会话 bean。
注意: 通过调用 API,三个基本函数(Send_Request、Receive_RespLen 和 Get_Data)都已完成。调用线程将被阻塞,直到接收到响应数据并将其复制到响应区域为止。
结果
客户机将使用优化本地适配器调用 API 以从
Liberty 服务器启动无状态会话 bean。