Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

You To open the TCP/IP collection agent configuration, click Build → New Configuration. Select Workflow from the Configurations dialog from a workflow configuration: you can right. When prompted to Select workflow type, select Realtime. Click Add agent and selectTcp Ip from the Agent Selection dialog. Double-click the agent icon and select Configuration..., or doubleor right-click the agent iconicon and select Edit agent, to display the Agent Configuration dialog.

TCP/IP Tab

Image Removed Image Added

TCP/IP collection agent configuration dialog - TCP/IP tab

SettingDescription

Host

The IP address or hostname to which the TCP collector will bindconnects. If the host is bound connected the port must also be boundconnected. If left empty, the TCP collector binds connects to all IP-addresses available on in the system.

Note
titleNote!

This setting can be dynamically updated.


Port

The port number from which the data is received. Make sure the port is not used by other applications.

Note
titleNote!

The port can also be dynamically updated while the agent is running. Double-click the agent in the Workflow Editor in monitor mode and modify it. To Save the workflow to trigger the agent to use the new port the workflow must be saved. For further information about updating agent configurations while the a workflow is running, see Dynamic Update in 1.2 Administration and Management in Legacy Desktop.


Allow Multiple Connections

If enabled, Select this checkbox to allow several TCP/IP connections are allowed simultaneously. If disabledcleared, only one at a time connection is allowed.

Number of Connections Allowed

If Allow Multiple Connections is enabled, the maximum number of simultaneous connections is specified as selected, enter a number between 2 and 65000 to specify the number of allowed connections.

Send Response

If enabled, Select this checkbox to have the collector will be able to send a response back to the source. If If Allow Multiple Connections is enabled is selected, the collector expects a UDR extended with the default TCPIPUDR as a reply. If disabledthe checkbox is cleared, it expects a bytearray.

Note
titleNote!

Drag and release drop in the opposite direction in the workflow to create a response route between the agents. The TCP/IP agent must be connected to an agent utilizing APL. This , since responses are created with using APL commands.

Image Removed Image Added

For a description of the differences between a single - and a multiple connection setupor multiple connections, see A TCP/IP Example.

Send TCPIPStateUDR

If enabled, you can Select this checkbox to track the connection state of the client . When this option is selected and have the collection agent sends send a udr UDR indicating the status of the client connection each time it changes state. See TCPIPStateUDR in TCP/IP Related UDR Types.

Note
titleNote!

It This information is not detected if a client is powered down or if its network cable has been is removed.


Decoder Tab

Image RemovedImage Added

TCP/IP collection agent configuration dialog - Decoder tab

...

Decoder

...

List holding available decoders introduced via the Ultra Format Editor. The decoders are named according to the following syntax:

<decoder> (<module>)

The option MZ Format Tagged UDRs indicate that the expected UDRs are stored in one of the built-in formats. If the compressed format is used, the decoder will automatically detect this. Select this option to make the Tagged UDR Type list accessible for configuration. If this option is selected, the Tagged UDR Type list will be enabled.

...

Tagged UDR Type

...

List of available internal UDR formats stored in the Ultra and Code servers. The formats are named according to the following syntax:

<internal> (<module>)

If the decoder is to reprocess UDRs of an internal format, the Decoder MZ format tagged UDRs has to be selected to enable this list. Once enabled, the internal format may be selected.

...

Full Decode

If enabled, the UDR will be fully decoded before inserted into the workflow. This may have a negative impact on performance since all fields may not be accessed in the workflow, making decoding of all fields unnecessary.

...

Insert excerpt
Inter Workflow Collection Agent in a Real-Time Workflow
Inter Workflow Collection Agent in a Real-Time Workflow
nopaneltrue

Extra System Properties

This section describes the extra system properties that you can use to configure the TCP/IP Collection Agent.

SettingDescription

mz.tcpip.logginginterval_ms

This property allows you to limit the number of exceptions from the TCP Collection Agent to one exception per specified interval (in milliseconds).

Warning
Only change the property if support has expressly recommended it. It is normally not recommend to set this property.


...