Write TCP Data

Write TCP Data is an asynchronous activity that sends data on the specified TCP connection. The connection must be opened by an activity or process starter that executed previously in the process.

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.
Type None The type of the data to write. This can be either Text or Binary.

Specifying Text in this field displays the Separator and Encoding fields.

Specifying Binary in this field displays the User Defined Separator field.

Separator Yes The type of separator to use. The separator is written to the TCP connection after the specified data is written.

Select User-defined separator from the drop-down list to enable the User Defined Separator field.

User Defined Separator Yes This field specifies the separator character to use.

When Binary is selected in the Type field, a user-defined separator can be a string representation of a single byte value or it can be comma-separated byte values (for example, 0x0a, 0x0b, 0x0c). For valid string representations of byte value, refer to the Java documentation for the decode(String n) method of java.lang.Byte.

Encoding Yes When text data is specified, this field determines the character encoding to use for the text data.

Description

Provide a short description of the activity.

Input

The following is the input for activity.

Input Item Datatype Description
connection binary The handle to the connection that you want to write data to. This connection is obtained from a previously executed activity in the process that opened the connection.
data string or binary The data to write to the TCP connection. The data type of this field is either String or Binary, depending upon the data selected in the Type field in the General tab.
encoding string An optional element. When writing text data, this specifies the character encoding of the text. This value overrides the value specified in the Encoding field in the General tab.
separator binary An optional element. This is available only when you select the s option on the General tab.
timeout number An optional element. The time to wait (in milliseconds) for this activity to complete.

Output

This activity has no output.

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.