A CreateInvokeEJB 2.1 service combines the functionality of the CreateEJB 2.1 and InvokeEJB 2.1 adapter services and the RemoveEJB Java service into one service. Services configured with this template create one or more instances of a single 2.1 EJB class and invoke a single method on those instances. Unlike CreateEJB 2.1, the remote EJB instances are not returned to the caller. CreateInvokeEJB 2.1 automatically calls RemoveEJB for each non-entity EJB instance; however, RemoveEJB is never called for an entity bean. See Removing EJBs for more information about the RemoveEJB service.

Use the CreateInvokeEJB 2.1 template when you want to create an adapter service that will retrieve an EJB, run a method on that bean, then release it. Because it does not return any Handle objects in its output, the lifecycle of the EJB is entirely contained within the bounds of the adapter service: the EJB is created, a single method is invoked and its output captured, then its remove() method is called. For this reason, a CreateInvokeEJB 2.1 service is not particularly useful with stateful session beans.

At design time, a CreateInvokeEJB 2.1 service requires the JNDI lookup name of the EJB to create, the identity of the create method to invoke, and the identity of the bean method to invoke. As with the other service templates, you may override the default names of any parameter used in a home or remote method. See Configuring CreateInvokeEJB 2.1 Services for more information about the parameters.

In a CreateInvokeEJB 2.1 service's input signature, the document names used to contain EJB method arguments are pre-configured and localized. The input document name of the home method is EJBHome_Args and the input document name of the bean method is EJBObject_Args. The documents appear in the input signature only if the corresponding methods have any arguments.