TCP Server Connector

This Connector supports Server and Iterator modes only.

In Server mode, this Connector waits for incoming TCP connections on a specified port and spawns a new thread to handle the incoming request. When the new thread has started, the original Server mode Connector goes back to listening mode. When the newly created thread has completed, the thread stops and the TCP connection is closed.

In Iterator mode, the Connector is single-threaded, in that it waits for a connection on the IP address of the local machine and the port specified. Once the connection is received, the Connector will generate Entries based on received data until the Client closes the connection.

Configuration

TCP Port

The TCP port on which to listen for incoming connections.

Connection Backlog

This represents the maximum queue length for incoming connection indications (a request to connect). If a connection indication arrives when the queue is full, the connection is refused.

Use SSL

If checked, the Connector will deploy the Secure Socket Layer (SSL) on the connection.

Require Client Authentication

If checked, the Connector will require clients to supply client-side SSL certificates that can be matched to the configured Tivoli® Directory Integrator trust store.

Detailed Log

If this parameter is checked, more detailed log messages are generated.

Connector Schema

The Connector makes the following properties available in the Input Attribute Map:

tcp.originator

The Connector object.

event.originator

The Connector object. This is the same object as the one stored in tcp.originator. This Attribute ensures compatibility with the now obsolete TCP Port EventHandler.

tcp.inputstream

TCP socket input stream (java.io.InputStream)

event.inputstream

TCP socket input stream (java.io.InputStream). This is the same object as the one stored in tcp.inputstream. This Attribute ensures compatibility with the obsolete TCP Port EventHandler.

tcp.outputstream

TCP socket output stream (java.io.OutputStream).

event.outputstream

TCP socket output stream (java.io.OutputStream). This is the same object as the one stored in tcp.outputstream. This Attribute ensures compatibility with the obsolete TCP Port EventHandler.

tcp.remoteIP

Remote IP address (dot notation).

tcp.remotePort

Remote TCP port number.

tcp.remoteHost

Remote hostname.

tcp.localIP

Local IP address (dot notation).

tcp.localPort

Local TCP port number.

tcp.localHost

Local hostname.

tcp.socket

TCP Socket object (java.net.Socket).

The TCP Server Connector does not use its Output Attribute Map - it just closes the Connection to the client application when done.

The tcp.inputstream and tcp.outputstream Attribute values are meant to be used via scripting in the AssemblyLine to read the client request and write the response respectively.

See also

TCP Connector.