Connect EJB form - Completing the Service tab
Use the Service tab to identify the properties of the remote EJB service. Complete the Service tab first.
As you work with the form, the information on this tab is used to connect to the JNDI server and automatically complete fields on the Create and Remote tabs.
JNDI server
Field | Description |
Server name | 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 . This field supports the Global
Resource Settings syntax (= |
Lookup name | Select a key to use to look up the EJB home object of the remote EJB in the JNDI server. |
EJB home
Field | Description |
Java class | Enter the name of the EJB Home Interface class to use to create an instance of the EJB client stub. If the JNDI Server and Lookup Name values are valid, this value is automatically filled in. |
Create method | Optional. Enter the type-signature of the EJB Home Interface method that
creates an instance of the EJB client stub (for example: create(String,
int) ). This field is not required if you select the Require use
of a valid object handle option of the EJB Remote/Initialize
Object field. |
EJB remote
Field | Description |
Initialize object |
Select how to initialize the EJB client stub:
|
Java class | 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, this value is filled in automatically. |
Remote method |
Enter the type-signature of the EJB Remote Interface method that is called
each time this connector is called. For example:
|
Finalize object |
Select how to finalize the EJB client stub:
|
Object handle property | 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. |
Error handling and test
Field | Description |
Error handling | |
Status value property |
Optional. Select a property for reporting the status of the remote service
request. You can use the standard property
@baseclass.pyStatusValue. The literal value
Good
identifies success.
|
Status message property | Optional. Select a property for providing more information about errors that occur when processing the remote service request. You can use the standard property @baseclass.pyStatusValue. |
Invocation exception property |
Optional. Select a property of mode
Java Object
to contain a
Java exception, if this connection throws any exceptions at runtime.
|
Error handler flow | 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. |
Test connectivity | Click this button at any time after you have completed the information on this
tab to confirm that Pega Platform can connect to the JNDI server
identified and can validate the Home Interface and Remote Interface. The system presents test results in a separate window, identifying the parameters used in the test, the steps attempted, and the outcome of each step. |
Generate test client |
As a debugging aid, if your
Pega Platform
is hosted on a
Java EE-platform (not Apache Tomcat) you can generate a stand-alone Java client
program that calls the EJB.
This produces a Java source file in the
|
Simulations | Click to create a simulator for this connect rule. |
Previous topic Connect EJB rules - Completing the New or Save As form Next topic Connect EJB form - Completing the Create tab