RemoteInvoke

The RemoteInvoke activity is used to remotely invoke other members in a space.

Note: TIBCO ActiveMatrix BusinessWorks cannot work as an invocable member.

General

In the General tab, you can specify the activity name, a space connection, and select a member type.

The following table describes the fields in the General tab of the RemoteInvoke activity:

Field Module Property? Description
Name No Specifies the name to be displayed as the label for the activity in the process.
Space Connection Yes Click the icon to select a space connection that defines how the application joins the space.

If no matching space connections are found, click Create Shared Resource to create one. See Creating a Metaspace Connection for details.

Invoke Type No Select the type of members that you want to invoke:
  • KEY: invokes the member that contains the key tuple in the space.
  • SELF: invokes the members that are defined in the metaspace shared resource.
  • SEEDERS: invokes all the seeders in the space.
  • LEECHES: invokes all the leeches in the space.
  • MEMBERS: invokes all the members in the space.
  • REMOTE: invokes all the remote members in the space.
  • CUSTOM: invokes the members specified in the Input tab.

Description

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

Input

In the Input tab, you can specify the class to be invoked, member names, and the key fields in the following input items:

Input Item Data Type Description
AliasName String Specifies the full package name for the invocable instance when the member type to be invoked is KEY. Otherwise, the full package name is specified for the member invocable instance.

The format of the alias name is package_name.class_name.

MemberName String Specifies the member names to be invoked.
Note: This field is displayed only when you select CUSTOM from the Invoke Type list in the General tab.
KeyTuple Any of the following data types:
  • Boolean
  • Char
  • Short
  • Integer
  • Long
  • Float
  • Double
  • Blob
  • String
  • Datetime
Specifies the key field names of the tuple which are defined in the space.
Note: This field is available only when you select KEY from the Invoke Type list in the General tab.
ContextTuple Any of the following data types:
  • Boolean
  • Char
  • Short
  • Integer
  • Long
  • Float
  • Double
  • Blob
  • String
  • Datetime
Specifies the parameters that are transferred to the class specified in the AliasName field.

Output

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

The following table describes the fields in the Output tab of the RemoteInvoke activity:

Output Item Data Type Description
The ResultList node contains the following fields.
HasError Boolean Indicates whether the results have errors.
  • The value is true when one or more results have errors.
  • The value is false when no error occurs.
Result Any of the following data types:
  • Boolean
  • Char
  • Short
  • Integer
  • Long
  • Float
  • Double
  • Blob
  • String
  • Datetime
Indicates the results that contain the following items:
  • Status: The ActiveSpaces status code returned by TIBCO ActiveSpaces functions. See TIBCO ActiveSpaces Java API Reference for more information.
  • Tuple: The tuples are returned from the invoked member.
  • HasError: (Boolean value) The value of true indicates that an error is returned. The value of false indicates that no error is returned.
  • Error: The error returned by TIBCO ActiveSpaces during the tuple processing.

Fault

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

The following table describes the errors in the Fault tab of the RemoteInvoke activity:

Error Schema Element Data Type Description
msg String The TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces error message.
msgCode String The TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces error code.
ASStatus String The status code returned by TIBCO ActiveSpaces functions.

See TIBCO ActiveSpaces Java API Reference for more information.