UDP Client Adapter
The UDP Client Adapter connects to a UDP Server to receive a data stream. The adapter passes the data stream to a parser. The parser parses the data stream into data tokens, which the mapping function converts into events.
The following table describes the UDP Client Adapter parameters:
UDP Client Adapter configuration parameters
Parameter | Description | |
---|---|---|
instanceName | Name of the adapter instance The instance name is the first entry in the adapter configuration and must be enclosed in square brackets.
| |
ConnectTimeout | Maximum time a connection will stay active | |
Engine | Type of adapter in use | |
IdleTimeout | Maximum time, in seconds, after which new data is expected to have arrived. | |
LocalHost | Local IP address on a computer with multiple network interfaces to which the UDP Client Adapter binds
| |
LocalPort | Local port number to which the UDP Client Adapter binds Default: ANY | |
Mapfile | Name of the MAP file used to generate events from the tokenized data | |
Parser | Parser instance that must be used to parse and tokenize the client input stream
| |
RemoteHost | Host name or IP address of the remote computer to which the UDP Client Adapter is connecting | |
RemotePort | Port on the remote computer to which the UDP Client Adapter is connecting | |
RestartInterval | Interval, in seconds, at which:
Default: 60
| |
SendOnConnect | String that is sent after a connection is established |
The following figure shows a sample UDP Client Adapter configuration, as it would appear in the mcxa.conf file.
Sample UDP client Adapter configuration
Engine = MA::Adapter::UdpClient
MapFile = mcudpclt.map
RemoteHost = test.bmc.com
RemotePort = 13
Parser = SeparatorParser
Diagnostics
All adapter errors are logged as events. Optionally, you can enable tracing by setting the tracing parameters in the global section of the mcxa.conf file. For more information, see Enabling tracing.
The UDP Client Adapter can generate an ERR_UDP_INIT error, which indicates that an error occurred when receiving data from the server. For more information, see the event that is created for this error.