TCP_RECV_BUFFER - UDM Manager configuration option

Description

The TCP_RECV_BUFFER option specifies the size of the TCP receive buffer used for socket connections.

TCP_RECV_BUFFER provides the ability to tune TCP data transfer performance between a UDM manager and a UDM server, that is for UDM two-party sessions. See Network Data Transfer Tuning for a description on using this option to tune data transfer performance.

UDM will instruct TCP to set the socket receive buffer to the specified size. The actual TCP receive buffer size used is determined by TCP based on its configuration. The TCP configuration can limit the buffer size to a maximum value for example.

The UDM manager establishes a socket connection with the UDM server by first connecting to the remote Universal Broker. Universal Broker will start a UDM server and pass the socket connection to the UDM server. The TCP buffers are set when the connection is first established. Consequentially, the Universal Broker TCP buffers must be configured as well to tune data transfer performance. Refer to Universal Broker TCP_RECV_BUFFER and TCP_SEND_BUFFER options.

UDM three-party sessions transfer data between two UDM servers, the primary and secondary. The primary UDM server establishes a socket connection with the secondary Universal Broker in order to start the secondary UDM server. TCP buffers for the socket connection between the primary and secondary UDM servers are configured with the TCP_SEND_BUFFER and TCP_RECV_BUFFER options of the primary UDM server and the secondary Universal Broker.

Usage

Method

Syntax

IBM i

UNIX

Windows

z/OS

Command Line, Short Form

n/a





Command Line, Long Form

-tcp_recv_buffer size [ unit ]



(tick)

(tick)

Environment Variable

UDMTCPRECVBUFFER=size [ unit ]


(tick)

(tick)

(tick)

Configuration File Keyword

tcp_recv_buffer size [ unit ]


(tick)

(tick)

(tick)

STRUDM Parameter

n/a





Values

The size value specifies the requested size of the TCP receive buffer.

The size value is specified in units of unit. Possible unit values are

Unit

Description

B

Bytes (the default)

K

Kilobytes (1024 bytes)

M

Megabytes (1048576 bytes)

G

Gigabytes (1073741824 bytes)

The unit value is case insensitive.

The maximum supported buffer size is 1G. The default is 0B.