Connect EJB form
Completing the Service tab

Field

Description

Select the JNDI server (instance of Data-Admin-Connect-JNDIServer) that identifies the EJB container with the bean you want to connect to. To connect to an EJB through its local interface, select the JNDI server named localEJBs. To connect to a remote EJB through an EJB reference rather than its JNDI name, select the JNDI server named remoteEJBrefs.

Additionally, this field supports the Global Resource Settings syntax (=.PageName.PropertyName). The default property name for this field is pyJNDIServerKey. For more information, see Using the Global Resource Settings feature.

Select a key for Process Commander to use to look up the EJB home object of the remote EJB in the JNDI server.

Field

Description

Select how to initialize the EJB client stub:

• Create a new object every time — Process Commander performs a JNDI lookup and uses the specified Create Method of the EJB Home Interface class to create an instance of the client stub each time this connector is called.
• If possible, use a valid object handle — Process Commander tries to restore the client stub instance using the value contained in the Object Handle property field. If the object handle value is blank or no longer valid, then Process Commander performs a JNDI lookup and uses the specified Create Method of the EJB Home Interface class to create an instance of the client stub.
• Require use of a valid object handle — Process Commander tries to restore the client stub instance using the value of the property identified in the Object Handle Property field. If the object handle value is blank or no longer valid, Process Commander reports an error using the status properties. Use this option if the remote method being called must be preceded by an earlier remote method call.

Enter the name of the EJB Remote Interface class that defines the remote methods that can be called on the EJB client stub instance. If the JNDI server and lookup names are valid, Process Commander fills this value in automatically.

Enter the type-signature of the EJB Remote Interface method that is called each time this connector is called. For example:

getListValue(int)

Select how Process Commander finalizes the EJB client stub:

• Remove object after method call — Process Commander calls the client stub’s Remove method after the remote service method is called.
• Keep alive and store object handle — Process Commander stores the client stub’s object handle value in the specified Object Handle property after the remote service method is called. Use this option if you intend to call multiple remote methods on a single EJB instance, either for performance reasons, or to maintain the session state between method calls.

Optional. Select a Single Value property for storing and/or recovering the serialized object handle of the EJB client stub instance. This field is not required if you select both the Create a new object every time option of the EJB Remote/Initialize Object field and the Remove object after method call option of the EJB Remote/Finalize Object field.

Field

Description

Optional. Select a property for reporting the status of the remote service request.

Optional. Select a property for providing more information about errors that occur when processing the remote service request.

Optional. Select a property of mode Java Object to contain a Java exception, if this connection throws any exceptions at runtime. BURND 9/9/04

C-1075 Optional. Identify a flow rule that is to be started when this connector rule is started by a flow rule but fails. The default flow rule Work-.ConnectionProblem provides one approach for handling such problems. See Handling connector exceptions.

Click this button at any time after you have completed the information on this tab to confirm that Process Commander can connect to the JNDI server identified and can validate the Home Interface and Remote Interface.

The Test Connectivity button does not work if either the localEJBs or remoteEJBrefs JNDI server is specified in the Server Name field.

C-1704The system presents test results in a separate window, identifying the parameters used in the test, the steps attempted, and the outcome of each step.

As a debugging aid, if your Process Commander is hosted on a J2EE-platform (not Apache Tomcat) you can generate a stand-alone Java client program that calls the EJB.

1. Save the rule.
2. Copy a vendor-supplied EJB.jar library to the server and make sure that this library appears in the server's $CLASSPATH Environment variable. See the Pega Developer Network article PRKB-20931 About the Process Commander class paths.
3. If you changed the $CLASSPATH, stop and restart Process Commander.
4. Open the Connect EJB rule.
5. Click  Generate Test Client  .

This produces a Java source file in the ServiceExport directory. C-771 ABLAL 1/30/2004

Click to create a simulator for this connect rule. See Creating Connect Simulators.