RMI Server

Copyright © Cloud Software Group, Inc. All Rights Reserved

RMI Server

Process Starter

The RMI Server process starter registers the specified remote object name with the specified registry server and then creates process instances to handle incoming requests for the object. The process definition acts as the implementation of the specified object.

You can specify an output schema on the Output editor tab to extract expected fields from the incoming request object. The data in the output schema is then available to subsequent activities in the process definition. The request and reply Java objects are also output and available to activities that can accept Java objects as input (for example, Java Code or Java Method). You can send a reply to the client by invoking the appropriate methods on the reply object, if the client requires a reply.

Configuration

The Configuration tab has the following fields.

Field

Global Var?

Description

Name

No

The name to appear as the label for the activity in the process definition.

Description

No

Short description of the activity.

Alias Library

No

Use this field to specify an AliasLibrary resource that is used to locate the Java class files. See TIBCO Designer Palette Reference for more information about AliasLibrary resources.

Remote Object Name

Yes

Name of the Java object that this process definition implements.

Registry Host Name

Yes

Host name of the registry server with which you want to register the specified object.

Registry Server Port

Yes

Port number for the registry server.

Misc

The Misc tab contains the following fields:

Field

Description

Sequencing Key

This field can contain an XPath expression that specifies which processes should run in order. Process instances with sequencing keys that evaluate to the same value will be executed sequentially in the order the process instance was created.

See TIBCO ActiveMatrix BusinessWorks Process Design for more information about controlling the execution order of process instances and about XPath expressions.

Custom Id

This field can contain an XPath expression that specifies a custom ID for the process instance. This ID is displayed in the View Service dialog of TIBCO Administrator, and it is also available in the $_processContext process variable.

Output Editor

The Output Editor tab allows you to define a custom schema for expected fields in the request object. See Appendix A, Specifying Data Schema for a complete description of using the Output Editor tab.

Output

The output for the activity is the following.

Output Item

Datatype

Description

request

Java Object

An object reference to the request object sent in the RMI request. The client might not send any data in the request, and in that case, this element will be nil.

reply

Java Object

An object reference to the reply object required by the client. The client might not require a reply, and in that case, this element will be nil.

<data>

varies

The output schema specified on the Output Editor tab. Data from the request object is extracted into the elements of this output schema. This allows you to easily access data from the request object without passing the object to a Java Code or Java to XML activity.

Field	Global Var?	Description
Name	No	The name to appear as the label for the activity in the process definition.
Description	No	Short description of the activity.
Alias Library	No	Use this field to specify an AliasLibrary resource that is used to locate the Java class files. See TIBCO Designer Palette Reference for more information about AliasLibrary resources.
Remote Object Name	Yes	Name of the Java object that this process definition implements.
Registry Host Name	Yes	Host name of the registry server with which you want to register the specified object.
Registry Server Port	Yes	Port number for the registry server.

Field	Description
Sequencing Key	This field can contain an XPath expression that specifies which processes should run in order. Process instances with sequencing keys that evaluate to the same value will be executed sequentially in the order the process instance was created. See TIBCO ActiveMatrix BusinessWorks Process Design for more information about controlling the execution order of process instances and about XPath expressions.
Custom Id	This field can contain an XPath expression that specifies a custom ID for the process instance. This ID is displayed in the View Service dialog of TIBCO Administrator, and it is also available in the $_processContext process variable.

Output Item	Datatype	Description
request	Java Object	An object reference to the request object sent in the RMI request. The client might not send any data in the request, and in that case, this element will be nil.
reply	Java Object	An object reference to the reply object required by the client. The client might not require a reply, and in that case, this element will be nil.
<data>	varies	The output schema specified on the Output Editor tab. Data from the request object is extracted into the elements of this output schema. This allows you to easily access data from the request object without passing the object to a Java Code or Java to XML activity.