Listen for Alert Message

The Listen for Alert Message activity starts a process when an alert is triggered in TIBCO Managed File Transfer Command Center.

The JMS alert action is triggered when a transfer matches all the alert trigger criteria defined in TIBCO Managed File Transfer Command Center. Then, TIBCO Managed File Transfer Command Center sends an alert message to a JMS topic to which the Listen for Alert Message activity listens with the specified message selector.

Alerts can be triggered by either internet server transfers or platform server transfers.

Note: The Listen for Alert Message activity only supports the Transfer Event Alert type that is defined in TIBCO Managed File Transfer Command Center.

General

The General tab of the Listen for Alert Message activity contains the following fields:

Field Module Property? Description
Name No The name to be displayed as the label for the activity in a process.
MFT Connection Yes The MFT Shared Connection shared resource used to build connection between the plug-in and the JMS server.

Click to select an MFT Shared Connection shared resource. If no matching MFT Shared Connection shared resources are available, click Create Shared Resource to create one.

For details about how to create an MFT Shared Connection shared resource, see Creating MFT Shared Connection.

MFT Message Selector Yes A JMS message selector used to determine which message is received.

The following properties can be used as the selector: JMSType, AlertID, AlertDescription, Severity, TransferType, ServerName, TransferDirection, Department, ClientFileName, ServerFileName, TransferStatus, ProcessName, TransferDescription, TemplateFile, and Comment.

For example:

JMSType='valueInCCAlert', TransferType='Internet Transfer', or AlertID='L50920000001'

These plug-in properties correspond to those in TIBCO Managed File Transfer Command Center, see Property Correspondence for more information.

See the JMS specification or the TIBCO Enterprise Message Service documentation for more information about the syntax of a message selector string.

Durable Subscriber Yes A durable subscription.

Select this check box to create a durable subscription. Otherwise, a non-durable subscription is created.

If you select this check box, specify a name in the Subscription Name field that is registered with the JMS application as the durable subscriber name.

After a durable subscription is created, it can only be removed by accessing an administration tool of the JMS provider. For more information about managing durable subscriptions, see the TIBCO Enterprise Message Service documentation.

Subscription Name Yes The subscription name registered with the JMS application for durable subscriptions.
Note: This field is available only when the Durable Subscriber check box is selected.
Refresh Management Yes Select or clear the check box to specify whether or not you want to refresh the configuration and management related information defined in TIBCO Managed File Transfer Command Center.

If you select this check box, the plug-in requests the management messages for the activity. Otherwise, the plug-in uses the cached management information.

Description

A short description for the Listen for Alert Message activity.

Advanced

The Advanced tab of the Listen for Alert Message activity contains the following fields:

Field Module Property? Description
Sequence Key No This field contains an XPath expression that specifies the order of running processes. Process instances with sequencing keys that evaluate to the same value are executed sequentially in the order the process instances were created.

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

Custom Job ID No This field contains an XPath expression that specifies a custom ID for the process instance.

Conversations

In the Conversations tab of the Listen for Alert Message activity, you can initiate or join a conversation.

Conversations receive a message after creating a process instance, which is initiated or joined by an activity. This activity can be used to initiate a conversation. Click the Add New Conversation icon to initiate a conversation. For details about conversations, see TIBCO ActiveMatrix BusinessWorks Application Development.

Output

The following is the output of the Listen for Alert Message activity:

Output Item Data Type Description
Properties JMSCorrelationID String The message ID of an original request message.

The value is the same as the value of the JMSCorrelationID input element.

JMSType String The message type used to distinguish between the messages stored in the same JMS queue.
JMSDestination String The destination where a message is received.
Comment String The comment defined on the alert configuration page in TIBCO Managed File Transfer Command Center.
Body ResponseType String The response type.
ServerName String The platform or Internet sever that executes the current transfer.
HostName String The host that the transferred files are uploaded to or downloaded from.
NumRecords Integer The number of audit records in the body of message. The value is always 1.
AuditRecord None This node contains details about the audit record.

For information about the definition of each property of the audit record, see the TIBCO Managed File Transfer Command Center documentation.

Fault

The Fault tab lists exceptions that are thrown by the Listen for Alert Message activity:

Exception Thrown when...
MFTConnectionException The plug-in fails to connect to the JMS server or TIBCO Managed File Transfer Command Center.
MFTValidationException A request message does not match the predefined request schema.