PersisterReceiver

The PersisterReceiver activity is used to start the persister and monitor the persister events.

Note: Before you use the PersisterReceiver and PersisterResponse activities, ensure that SHARE_ALL is selected from the Persistence Type list in the Advanced tab of the Space shared resource.

General

In the General tab, you can specify the activity name, a space connection, the time to wait for a response.

The following table describes the fields in the General tab of the PersisterReceiver 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.

Time to Wait for Response Yes Specifies the amount of time in milliseconds that the PersisterResponse activity waits for a response value before an exception is thrown to the PersisterReceiver activity.

The default value is 60000. The value of -1 indicates waiting indefinitely.

Description

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

Advanced

In the Advanced tab, you can specify the advanced configurations, such as a sequence key and a custom job ID.

The following table describes the fields in the Advanced tab of the PersisterReceiver activity:

Field Module Property? Description
Sequence Key Yes Specifies which processes run in order. Processes with the same sequence key are executed sequentially in the order in which the processes were created.
Custom Job Id Yes Specifies a custom job ID for the process instance. This ID is displayed in the TIBCO Administrator View Service dialog, and it is also available in the $_processContext process variable.

Conversations

A conversation can develop between a process and its clients, a process and its back-end services, and so on. A conversation is always initiated by one activity and joined by other activities.

You can use the following icons to manage conversations:

  • Click the Joining Existing Conversations icon to join multiple conversations.
  • Click the Add New Conversation icon to initiate a conversation.

For more details about conversations, see TIBCO ActiveMatrix BusinessWorks Application Development .

Output

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

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

Output Item Description
The ResultList node contains the following fields:
ActionType Retrieves the action type of a persister event listener with the TIBCO ActiveSpaces operation.

The value can be AlterAction, CloseAction, LoadAction, OpenAction, ReadAction, or WriteAction.

MetaspaceName Retrieves the name of the metaspace to which the currently connected space belongs. The value is null when the action type of the persister event listener is AlterAction.
SpaceName Retrieves the name of the currently connected space. The value is null when the action type of the persister event listener is AlterAction.
The ActionType field includes the following options:
AlterAction Retrieves data from the AlterAction event. This field is displayed only when you use the AlterAction action type.

The AlterAction field includes the following items:

  • NewFullSpaceDef: retrieves the new space definition of the currently connected space from the AlterAction event.

    The NewFullSpaceDef field includes the following items:

    • SpaceDef: retrieves data of the space definition.

      For more details about this field, see TIBCO ActiveSpaces Java API Reference.

    • FieldDefs: retrieves a collection of field definitions associated with the space definition.

      For more details about this field, see TIBCO ActiveSpaces Java API Reference.

    • KeyDef: retrieves data of the key index definition.

      For more details about this field, see TIBCO ActiveSpaces Java API Reference.

    • IndexDefs: retrieves a collection of index definitions associated with the space definition.

      For more details about this field, see TIBCO ActiveSpaces Java API Reference.

  • OldFullSpaceDef: retrieves the old space definition of the currently connected space from the AlterAction event.

    The OldFullSpaceDef field includes the following items:

    • SpaceDef: retrieves data of the space definition.

      For more details about this field, see TIBCO ActiveSpaces Java API Reference.

    • FieldDefs: retrieves a collection of field definitions associated with the space definition.

      For more details about this field, see TIBCO ActiveSpaces Java API Reference.

    • KeyDef: retrieves data of the key index definition.

      For more details about this field, see TIBCO ActiveSpaces Java API Reference.

    • IndexDefs: retrieves a collection of index definitions associated with the space definition.

      For more details about this field, see TIBCO ActiveSpaces Java API Reference.

ReadAction Retrieves data from the ReadAction event. This field is displayed only when you use the ReadAction action type.

The ReadAction field includes the following item:

Tuple: retrieves the incoming data from the read operation. For details about a tuple, see TIBCO ActiveSpaces Java API Reference.

WriteAction Retrieves data from the WriteAction event. This field is displayed only when you use the WriteAction action type.

The WriteAction field includes the following item:

writeOp: retrieves the data list from the WriteAction event. The writeOp field includes the following items:

  • writeType: retrieves the enum type of the write operation from the WriteAction event. The value can be PUT or TAKE.
  • Tuple: retrieves the incoming data from the write operation. For details about a tuple, see TIBCO ActiveSpaces Java API Reference.

Fault

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

The following table describes the errors in the Fault tab of the PersisterReceiver 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.