/
TCPIP Related UDR Types - Collection Agent(4.2)

TCPIP Related UDR Types - Collection Agent(4.2)

Jun 03, 2024

TCPIPUDR

The TCPIPUDR is the UDR type created by default in the TCPIP agent. 

 

Field

Description

Field

Description

RemoteIP(ipaddress)

The IP address of the client.

RemotePort(int)

The port through which the agent connects to the client.

response(bytearray)

The data that the agent sends back to the client.

SequenceNumber(long)

A per-connection unique number that is generated by the TCPIP agent. This number allows you to follow the order in which the UDRs are collected. The agent counter is reset whenever connection with the agent is established.

  • The UDR fields RemoteIP, RemotePort, and SequenceNumber are accessible from the workflow configuration only if the TCPIP agent is configured with a decoder that extends the built-in TCPIP format. For further information see Decoder(3.2).

  • The TCPIPUDR cannot be cloned and the socket connection is not initialized if cloning is attempted. It is therefore recommended that you initialize every UDR from the decoder, and then route it into the workflow.

TCPIPStateUDR

You can configure the collection agent to track the connection state of the client. Whenever the client is connected or disconnected, the agent sends this UDR containing the status of the connection each time it changes state. To activate this function, go to the TCP/IP tab and select the check  box Send TCPIPStateUDR - see the TCP/IP Tab in TCP/IP Collection Agent(4.2).

Field

Description

Field

Description

data (bytearray)

This field is only populated when the collection agent tries to send a response to the client but the client is no longer connected. The agent then sends the TCPIPStateUDR back to the workflow with isConnected =false and data containing the response that APL wanted to send. During a normal state change, the value in the data field is null .

ipAddress (string)

The IP address of the client

isConnected (boolean)

This field indicates if the client is connected or disconnected. When there is a new connection, this field is set to true. When a connection is terminated or disconnected, this field is set to false.

port (int)

The port of the client

response(bytearray)

The data that the agent sends back to the client