TCP, LU62, NETBIOS, and SPX
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.
- TCP
- Use the
TCP
queue manager properties page from the IBM® WebSphere® MQ Explorer, or theTCP
stanza in the qm.ini file, to specify Transmission Control Protocol/Internet Protocol (TCP/IP) configuration parameters.- Port=1414|port_number
- The default port number, in decimal notation, for TCP/IP sessions. The well known port number for WebSphere MQ is 1414.
- Library1=DLLName1 ( WebSphere MQ for Windows only)
- The name of the TCP/IP sockets DLL.
The default is WSOCK32.
- 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
- Override the default number of outstanding requests for the TCP/IP
listener.
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 values are shown in Table 1.
Table 1. Default outstanding connection requests (TCP) Platform Default ListenerBacklog value Windows Server 100 Windows Workstation 5 Linux® 100 Solaris 100 HP-UX 20 AIX® V4.2 or later 100 AIX V4.1 or earlier 10 Note: Some operating systems support a larger value than the default shown. Use this to avoid reaching the connection limit.Conversely, some operating systems might limit the size of the TCP backlog, so the effective TCP backlog could be smaller than requested here.
If the backlog reaches the values shown in Table 1, the TCP/IP connection is rejected and the channel cannot start. For message 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 retries the connection at a later time.
- SvrSndBuffSize=32768|number
- The size in bytes of the TCP/IP send buffer used by the server end of a client-connection server-connection channel.
- SvrRcvBuffSize=32768|number
- The size in bytes of the TCP/IP receive buffer used by the server end of a client-connection server-connection channel.
- Connect_Timeout=0|number
- 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.
- LU62 ( WebSphere MQ for Windows only)
- Use the
LU6.2
queue manager properties page from the IBM WebSphere MQ Explorer, or theLU62
stanza in the qm.ini file, to specify SNA LU 6.2 protocol configuration parameters.- TPName
- The TP name to start on the remote site.
- Library1=DLLName 1
- The name of the APPC DLL.
The default value is WCPIC32.
- Library2=DLLName2
- The same as Library1, used if the code is stored in two separate
libraries.
The default value is WCPIC32.
- NETBIOS ( WebSphere MQ for Windows only)
- Use the
Netbios
queue manager properties page from the IBM WebSphere MQ Explorer, or theNETBIOS
stanza in the qm.ini file, to specify NetBIOS protocol configuration parameters.- LocalName=name
- The name by which this machine is known on the LAN.
- AdapterNum=0|adapter_number
- The number of the LAN adapter. The default is adapter 0.
- NumSess=1|number_of_sessions
- The number of sessions to allocate. The default is 1.
- NumCmds=1|number_of_commands
- The number of commands to allocate. The default is 1.
- NumNames=1|number_of_names
- The number of names to allocate. The default is 1.
- Library1=DLLName1
- The name of the NetBIOS DLL.
The default value is NETAPI32.
- SPX ( WebSphere MQ for Windows only)
- Use the
SPX
queue manager properties page from the IBM WebSphere MQ Explorer, or theSPX
stanza in the qm.ini file, to specify SPX protocol configuration parameters.- Socket=5E86|socket_number
- The SPX socket number in hexadecimal notation. The default is X'5E86'.
- BoardNum=0|adapter_number
- The LAN adapter number. The default is adapter 0.
- KeepAlive=NO|YES
- Switch the KeepAlive function on or off.
KeepAlive=YES causes SPX to check periodically that the other end of the connection is still available. If it is not, the channel is closed.
- Library1=DLLName1
- The name of the SPX DLL.
The default is WSOCK32.DLL.
- Library2=DLLName2
- The same as LibraryName1, used if the code is
stored in two separate libraries.
The default is WSOCK32.DLL.
- ListenerBacklog=number
- Override the default number of outstanding requests for the SPX
listener.
When receiving on SPX, a maximum number of outstanding connection requests is set. This can be considered to be a backlog of requests waiting on the SPX socket for the listener to accept the request. The default listener backlog values are shown in Table 2.
Table 2. Default outstanding connection requests (SPX) Platform Default ListenerBacklog value Windows Server 100 Windows Workstation 5 Note: Some operating systems support a larger value than the default shown. Use this to avoid reaching the connection limit.Conversely, some operating systems might limit the size of the SPX backlog, so the effective SPX backlog could be smaller than requested here.
If the backlog reaches the values shown in Table 2, the SPX connection is rejected and the channel cannot start. For message 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.