The TCP stanza on IBM i
Use these queue manager properties pages, or stanzas in the qm.ini
file, to specify network protocol configuration parameters. They override the default attributes for
channels.
Note: Only attributes representing changes to the default values need to be specified.
- TCP
- The following attributes can be specified:
- Port= 1414|port_number
- The default port number, in decimal notation, for TCP/IP sessions. The default port number from
IBM MQ Version 8.0 is 1414.
- KeepAlive= NO|YES
- Switch the KeepAlive function on or off. KeepAlive=YES causes TCP/IP to check periodically that
the other end of the connection is still available. If it is not, the channel is closed.
- ListenerBacklog=number
- When receiving on TCP/IP, a maximum number of outstanding connection requests is set. This can
be considered to be a backlog of requests waiting on the TCP/IP port for the listener to
accept the request. The default listener backlog value for IBM i is 255; the maximum is 512. If the backlog reaches the
value of 512, the TCP/IP connection is rejected and the channel cannot start.
For MCA channels,
this results in the channel going into a RETRY state and retrying the connection at a later time.
For client connections, the client receives an MQRC_Q_MGR_NOT_AVAILABLE reason code from MQCONN
and should retry the connection at a later time.
The ListenerBacklog attribute allows you to override the default number of
outstanding requests for the TCP/IP listener.
- Connect_Timeout=number|0
- The number of seconds before an attempt to connect the socket times out. The default value of
zero specifies that there is no connect timeout.
-
The following group of properties can be used to control the size of buffers used by TCP/IP. The
values are passed directly to the TCP/IP layer of the operating system. Great care should be taken
when using these properties. If the values are set incorrectly it can adversely affect the TCP/IP
performance. For further information about how this affects performance refer to the TCP/IP
documentation for your environment. A value of zero indicates that the operating system will manage
the buffer sizes, as opposed to the buffer sizes being fixed by IBM MQ.
- SndBuffSize=number|0
- The size in bytes of the TCP/IP send buffer used by the sending end of channels. This stanza
value can be overridden by a stanza more specific to the channel type, for example RcvSndBuffSize.
If the value is set as zero, the operating system defaults are used. If no value is set, then the
IBM MQ default, 32768, is used.
- RcvBuffSize=number|0
- The size in bytes of the TCP/IP receive buffer used by the receiving end of channels. This
stanza value can be overridden by a stanza more specific to the channel type, for example
RcvRcvBuffSize. If the value is set as zero, the operating system defaults are used. If no value is
set, then the IBM MQ default, 32768, is used.
- RcvSndBuffSize=number|0
- The size in bytes of the TCP/IP send buffer used by the sender end of a receiver channel. If the
value is set as zero, the operating system defaults are used. If no value is set, then the IBM MQ default, 32768, is used.
- RcvRcvBuffSize=number|0
- The size in bytes of the TCP/IP receive buffer used by the receiving end of a receiver channel.
If the value is set as zero, the operating system defaults are used. If no value is set, then the
IBM MQ default, 32768, is used.
- SvrSndBuffSize=number|0
- The size in bytes of the TCP/IP send buffer used by the server end of a client-connection
server-connection channel. If the value is set as zero, the operating system defaults are used. If
no value is set, then the IBM MQ default, 32768, is
used.
- SvrRcvBuffSize=number|0
- The size in bytes of the TCP/IP receive buffer used by the server end of a client-connection
server-connection channel. If the value is set as zero, the operating system defaults are used. If
no value is set, then the IBM MQ default, 32768, is
used.