Wait for Internet Server Completion

The Wait for Internet Server Completion activity receives an Internet transfer status response with its related request message based on a JMSCorrelationID.

The response indicates whether or not the transfer is completed successfully. The activity receives the status response from a JMS queue which is the same as the queue used by the Request Internet Server Transfer activity.

Use this activity together with the Request Internet Server Transfer activity.

Note: Ensure that you have selected the Check Transfer Status check box in the General tab of the Request Internet Server Transfer activity. Otherwise, no status message is returned, and a TimedOutException exception occurs.

General

The General tab of the Wait for Internet Server Completion 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.

Activity Timeout (second) No The amount of time the activity waits before getting a status response.

The valid range is 1 to 86400. The default value is 3600. This value overrides the default timeout value set on the JMS Configuration page in TIBCO Managed File Transfer Command Center.

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 Wait for Internet Server Completion activity.

Input

The following is the input of the Wait for Internet Server Completion activity:

Input Item Data Type Description
JMSCorrelationID String The JMS message ID of the original request message. The activity uses this ID to link a response message with its related request message.

For information about mapping and transforming input data, see TIBCO ActiveMatrix BusinessWorks Application Development.

Output

The following is the output of the Wait for Internet Server Completion activity:

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

The value is the same as 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.
ResponseType String The response type.
ReturnCode String The numeric code returned by TIBCO Managed File Transfer Command Center.

A value of 0 indicates that the command was executed successfully. A non-zero value usually indicates termination of the command due to an error. See Return Codes for more details.

NumRecords Integer The number of audit records in the message body. The value is always 1.
Message String A detailed transfer status message or an error message.
TransferStatus String The transfer status, for example, Transfer Complete.
Initiator

TransactionID

String The unique ID indicating that a request was submitted successfully.
Body ResponseType String The type of the response.
ServerName String The Internet server 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 Wait for Internet Server Completion activity:

Exception Thrown when...
ActivityTimedOutException The plug-in fails to get a status response due to a timeout error.
MFTConnectionException The plug-in fails to connect to the JMS server or TIBCO Managed File Transfer Command Center.
MFTReceiveException The plug-in fails to receive a status response.
MFTValidationException A request message does not match the predefined request schema.