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

The General tab contains the following fields:

Field	Module Property?	Description
Name	No	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	Name of the remote interface (the interface which extends javax.ejb.EJBObject) obtained by the EJB2Home activity. This field is populated automatically based on the selected EJB2Home activity.
Remote Interface Method	No	Method of the remote interface to call. The list provides a list of public methods contained in the remote interface class.

Description

The Description tab provides a short description for the activity.

Advanced

The Advanced tab contains the following fields:

Field	Module Property?	Description
Release Remote Object	No	If this field is selected, the remote object is released after this activity is completed. If this field is clear, the remote object is used by subsequent EJB2Remote activities within this process definition. This field is only meaningful for stateful session and entity beans. Cached remote stateless session beans are never released when this field is checked. This field 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 are invoking a method on a stateful session or entity bean, only check this field 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 is the input for the activity:

Input Item	Data Type	Description
MethodParameters	complex	An object containing the parameters required by the remote interface method (shown only if the method is selected in the General tab requires parameters).

Output

The following is the output for the activity:

Output Item	Data Type	Description
MethodReturnValue	complex	The value returned by the remote interface method. Shown only if the remote interface method selected in the General tab returns a value.

Fault

The Fault tab lists exceptions that are thrown by this activity:

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