TCPIPSender

Note: Can be used in conjunction with TCPIPReceiver.

Sends raw data to the specified host, which may be another FME workspace running in a different process, (located on the same machine or on a different machine), or any client application that communicates over TCP/IP.

To transport data from one FME process to another: use the TCPIPSender transformer in the source FME workspace to send data to a TCPIPReceiver transformer in the receiving FME workspace.

Input Ports

Input

This transformer accepts any feature.

Output Ports

This transformer has no output ports.

Parameters

Initiation Sequence

The Initiation Sequence specifies whether the transformer is responsible for establishing the connection (Establish), and or connecting to an establishing host (Connect). If the TCPIPReceiver is used with a corresponding TCPIPSender, either the sender or receiver can be the establisher.

Note: The workspace that establishes the connection must be running before the connecting workspace.

Establishing Host

This parameter is only needed by the workspace with the Initiation Sequence parameter set to Connect, and only when the workspaces are running on different machines.

Port or Service to Use

Specify either a port number or a service (for example, http, ftp, telnet, imap, gopher, pop3, www, and smtp are services that are typically associated with well-known port numbers).

The default value is 8586.

Attribute to Stream

This parameter specifies the name of the output attribute.

Send Data Length

If this parameter is set to Yes, then the TCPIPSender will transmit the size of each data transmission (in bytes) before sending the data payload. For example, if the TCPIPSender was sending the data “1234”, it would first transmit a value of “4” to let the receiver know to expect 4 bytes, and then transmit the data itself. If this parameter is set to No, then the TCPIPSender will just transmit the given data.

Usage Notes

To set up a data stream between two FME workspaces using the TCPIPReceiver and TCPIPSender transformers:

• One workspace is the designated "establisher" of the transport stream. If there are multiple transport streams between workspaces, one workspace must be the establisher of all the streams, and the other will connect to those transport streams. This is regardless of whether the individual transporters are sending or receiving data.
• The establishing workspace must be started before the workspace that is connecting. A TCPIPReceiver/TCPIPSender cannot successfully connect to a transport stream that is not already established.
• For each transport channel, there must be a different port that is used for each server machine.

Editing Transformer Parameters

Using a set of menu options, transformer parameters can be assigned by referencing other elements in the workspace. More advanced functions, such as an advanced editor and an arithmetic editor, are also available in some transformers. To access a menu of these options, click beside the applicable parameter. For more information, see Transformer Parameter Menu Options.

Transformer Categories

Integrations

Web

Workflows

FME Licensing Level

FME Professional edition and above

Technical History

Associated FME function or factory: TransporterFactory

Search FME Community

Search for samples and information about this transformer on the FME Community.