(zos)

Use the Invoke API to call an enterprise bean from an external address space

Use this task when to use the Invoke API to call a stateless session bean from an external address space that is in an application that is deployed on a locally attached WebSphere Application Server for z/OS .

The WebSphere Application Server daemon group must be active on the same z/OS image that the register request originates from. Ensure that the current address space has already registered and is bound to the target WAS cell using the Register API.

This method is designed for high-level exploiters looking for a simplified path where the response area length is known beforehand.

1. Set up the client address space native language application, such as Cobol, PL/I, C/C++, or assembler program, to gather its parameters and designate the target service name as the JNDI home interface path name for the stateless session bean that it wants to start.

2. Call the Invoke (BBOA1INV) API. In the target EJB application, the execute method runs and then starts any business logic required before returning the response data as a serialized byte array back to the native language caller.

3. Review the response data. A 0 return code and reason code indicates that the client Invoke API completed successfully and the response data and response data length are saved in the areas designated by the caller.

4. The client application repeats these steps using the same register name call, calling as many stateless session beans as needed, and as often as needed. : With this API, the three primitive functions, Send_Request, Receive_RespLen, and Get_Data are all completed using the Invoke API. The calling thread is blocked until the response data is received and copied to the response area.

Results

The client started a stateless session bean from WebSphere Application Server using the optimized local adapter Invoke API.

Related concepts

Optimized local adapters on WebSphere Application Server for z/OS

Optimized local adapters for z/OS APIs

WebSphere Application Server transactions BBOC, BBO$, BBO#

Related tasks

Enable optimized local adapters support in CICS

Install the WebSphere BBOC, BBO$ and BBO# transactions in CICS