Wait for TCP Request

Wait for TCP Request is a signal-in activity that waits for a TCP client connection request. When a connection request occurs, the activity places a handle to the open connection in the connection output element. The subsequent activities in the process use this connection key to read data from, write data to, or close the connection.

General

The General tab 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 for the TCP connection to use the keep alive feature of sockets.
Note: TCP keep alive is different from HTTP keep alive.

Description

Provide a short description of the activity.

Event

The Event tab has the following fields.

Field Description
Event Timeout (seconds) A message may arrive before this activity is executed. Specify the amount of time (in seconds) for a message to wait, if the message is received before this activity is executed.
Activity Timeout (msec) Specify the amount of time (in milliseconds) for an activity to wait before it is executed.

Conversations

You can initiate or join the conversation here. Click the Joining Existing Conversation button to join multiple conversations. Click the Add New Conversation button to initiate 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 key 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. Select the Enable DNS Lookup field in the General tab to enable this field.
Port integer The port number of the client sending the TCP request.

Fault

The Fault tab lists the possible exceptions generated by this activity. For more information about error codes and the corrective action to take, see the TIBCO ActiveMatrix BusinessWorks™ Error Codes guide.

Fault Generated When..
TCPActivityFault There is some problem associated with the activity at runtime.