EJB2Remote

The EJB2Remote activity invokes remote methods on the remote object from an EJB server for EJB 2.x. This activity must be placed after an EJB2Home activity in a process definition.

General

In the General tab, you can establish a connection to an EJB server, and specify the remote interface and call a method.

Field Module Property? Description
Name No The name to be displayed as the label for the activity in the process.
Home Activity No The EJB2Home activity in the process definition that obtained the reference to the remote object.

The list only supplies EJB2Home activities that obtain references to remote objects. EJB2Home activities that do not create remote objects are not listed.

Remote Interface Class No The name of the remote interface (the interface that extends javax.ejb.EJBObject) obtained by the EJB2Home activity. This field is populated automatically based on the selected EJB2Home activity.
Remote Interface Method No The method of the remote interface to be called. The list provides a list of public methods contained in the remote interface class.

Description

In the Description tab, you can enter a short description for the EJB2Remote activity.

Advanced

In the Advanced tab, you can specify the remote objects that you want to release:

Field Module Property? Description
Release Remote Object No If this check box is selected, the remote object is released after this activity is completed. If this check box is cleared, the remote object is used by subsequent EJB2Remote activities within this process definition.

This check box is only meaningful for stateful session and entity beans. Cached remote stateless session beans are never released when this check box is selected. This check box is useful if you want to release the memory used by the stateful session and entity bean before continuing with the remainder of the process definition.

Note: If you invoke a method on a stateful session or entity bean, select this check box only when no subsequent activities in the process definition invoke the remote object. If the object is released and a subsequent invocation is made, an error is returned.

Input

The following table lists the input element in the Input tab of the EJB2Remote activity:

Input Item Data Type Description
MethodParameters Complex An object containing the parameters required by the remote interface method. This item is displayed only if the method selected in the General tab requires parameters.

Output

In the Output tab, you can find the search results.

The following table lists the output element in the Output tab of the EJB2Remote activity:

Output Item Data Type Description
MethodReturnValue Complex The value returned by the remote interface method. This item is displayed only if the remote interface method selected in the General tab returns a value.

Fault

In the Fault tab, you can find the error code and error message of the EJB2Remote activity. See Error Codes for more detailed explanation of errors.

The following table lists error schema elements in the Fault tab of the EJB2Remote activity:

Error Schema Element Data Type Description
errorCode String Displays the error code returned by the plug-in.
errorMessage String Displays the error message returned by the plug-in.
errorStackTrace String Displays the complete stack trace that causes the exception.
exceptionClassName String Displays the class name of the root exception that causes the exception.