TCP Receiver

TCP Receiver is a process starter activity that starts the process when a client requests a TCP connection. The connection element in the activity output contains the handle to the TCP connection. The subsequent activities in the process can use this handle for the TCP connection to read data from, write data to, or close the connection.

General

The General has the following fields.

Field Literal Value/Module Property/Process Property Description
Name None The name to be displayed as the label for the activity in the process.
Security Yes

To be included when encrypting or decrypting the messages. The drop-down list displays the SSL Server Configuration field. Use this field to specify the SSL parameters.

For more information, see SSL Server Configuration.

Host Yes The hostname or the host IP address of the TCP server to connect to.
Port Yes Specify the port number on which this TCP server is listening for requests.
Enable DNS Lookup None Select this check box to enable a domain name system (DNS) lookup for resolving the IP address to a DNS name.
Caution: Select this element only when required, as this may adversely affect throughput.
Keep Alive None Select this check box to specify for the TCP connections to use the keep alive feature of sockets.

Description

Provide a short description for the activity.

Advanced

The Advanced tab contains the following fields.

Field Description
Sequence Key This field can contain an XPath expression that specifies which processes should run in a specified order.

Process instances with sequencing keys evaluating to the same value are executed sequentially in the order of the process instance creation.

Custom Job Id This field can contain an XPath expression that specifies a custom ID for the process instance.

Conversations

You can initiate the conversation here. Click the Add New Conversation button to initiate multiple conversations.

For more information about conversations, see the TIBCO ActiveMatrix BusinessWorks™ Application Development guide.

Output

The following is the output of the activity.

Output Item Datatype Description
connection binary The handle to the open connection. This connection can be used by subsequent activities in the process definition to specify the TCP connection to write data to, read data from or close.
IP string The IP address of the client sending the TCP request.
Host string The host name of the client sending the TCP request. This field is available only when you select the Enable DNS Lookup field in the General tab.
Port integer The port number of the client sending the TCP request.