This appendix shows the stanzas in the queue manager configuration file that relate to distributed queuing. It applies to:
Notes:
The stanzas that relate to distributed queuing are:
Figure 150 shows the values that you can set using these
stanzas. When you are defining one of these stanzas, you do not need to
start each item on a new line. You can use either a semicolon (;)
or a hash character (#) to indicate a comment.
Figure 150. qm.ini stanzas for distributed queuing
CHANNELS:
MAXCHANNELS=n ; Maximum number of channels allowed, the
; default value is 100
MAXACTIVECHANNELS=n ; Maximum number of channels allowed to be active at
; any time, the default is the value of MaxChannels
MAXINITIATORS=n ; Maximum number of initiators allowed, the
; default value is 3 (see note (DUP0018))
MQIBINDTYPE=type ; Whether the binding for applications is to be
; "fastpath" or "standard".
;The default is "standard". (see note (DUP0019))
ADOPTNEWMCA=chltype ; Stops previous process if channel fails to start.
; The default is "NO".
ADOPTNEWMCATIMEOUT=n ; Specifies the amount of time that the new
; process should wait for the old process to end.
; The default is 60.
ADOPTNEWMCACHECK= ; Specifies the type checking required.
typecheck ; For FAP1, FAP2, and FAP3, "NAME" and
; "ADDRESS" is the default.
; For FAP4 and later, "NAME",
; "ADDRESS", and "QM" is the
; default.
TCP: ; TCP entries
PORT=n ; Port number, the default is 1414
LIBRARY1=DLLName1 ; Name of TCP Sockets DLL (OS/2 only)
LIBRARY2=DLLName2 ; Same as above if code is in two libraries (OS/2 only)
KEEPALIVE=Yes ; Switch TCP/IP KeepAlive on
IPADDR=Addr/Name ; TCP/IP address or name for Listener
LU62: ; LU 6.2 entries (OS/2 only)
TPNAME=name ; TP Name to start on remote side
LIBRARY1=DLLName1 ; Name of APPC DLL (see note (DUP0020))
LIBRARY2=DLLName2 ; Same as above if code is in two libraries (see note (DUP0020))
LOCALLU=name ; LU to use on local system (OS/2 only)
NETBIOS: ; NetBIOS entries (OS/2 only)
LOCALNAME=name ; The name this machine will be known as on the LAN
ADAPTERNUM=n ; LAN adapter number, the default is adapter 0
NUMSESS=n ; Number of sessions to allocate, the default is 1
NUMCMDS=n ; Number of commands to allocate, the default is 1
NUMNAMES=n ; Number of names to allocate, the default is 1
LIBRARY1=DLLName1 ; Name of NetBIOS DLL
LIBRARY2=DLLName2 ; Same as above if code is in two libraries (OS/2 only)
SPX: ; SPX entries (OS/2 only)
SOCKET=n ; The socket number, the default is 5E86
BOARDNUM=0 ; LAN adapter number, the default is adapter 0 (OS/2 only)
KEEPALIVE=Yes ; Switch on "watchdog" to monitor sessions (OS/2 only)
LIBRARY1=DLLName1 ; Name of SPX DLL
LIBRARY2=DLLName2 ; Same as above if code is in two libraries (OS/2 only)
EXITPATH: ; Location of user exits (MQSeries for AIX,
; HP-UX, OS/2 Warp, and Solaris only)
EXITPATHS= ; String of directory paths
UDP: ; UDP entries (AIX only)
ACKREQ_TIMEOUT=n ; request for acknowledgement timeout
; attribute specifies the time, in
; seconds, that the internal state
; machines will wait for a protocol
; datagram before assuming that the
; datagram has been lost and retrying.
; The default is 5.
ACKREQ_RETRY=n ; request for acknowledgment retry
; attribute specifies the number of times
; that the internal state machines will
; resend protocol datagrams before giving
; up completely and causing a channel to
; close. (All the counts are reset to
; zero after success and thus are not
; cumulative.) The default is 60.
CONNECT_TIMEOUT=n ; connect request timeout attribute
; specifies the time, in seconds, that
; the internal state machines will wait
; for a protocol datagram before assuming
; that the datagram has been lost and
; retrying. The default is 5.
CONNECT_RETRY=n ; connect request retry attribute
; specifies the number of times that the
; internal state machines will resend
; protocol datagrams before giving up
; completely and causing a channel to
; close. (All the counts are reset to
; zero after success and thus are not
; cumulative.) The default is 60.
ACCEPT_TIMEOUT=n ; accept connection timeout attribute
; specifies the time, in seconds, that
; the internal state machines will wait
; for a protocol datagram before assuming
; that the datagram has been lost and
; retrying. The default is 5.
ACCEPT_RETRY=n ; accept connection retry attribute
; specifies the number of times that the
; internal state machines will resend
; protocol datagrams before giving up
; completely and causing a channel to
; close. (All the counts are reset to
; zero after success and thus are not
; cumulative.) The default is 60.
DROPPACKETS=n ; tests for the robustness of the
; protocols against lost datagrams
; Changing the value to something other
; than 0 causes datagrams to be thrown
; away and the protocol will cause them
; to be resent. Therefore, you are
; advised not to change the value of this
; attribute to anything other than 0 for
; normal usage.
BUNCHSIZE=n ; specifies the number of datagrams that
; are sent before an acknowledgement
; datagram is sent from the receiving
; node. The default is 8. Changing the
; default to a value higher than 8 may
; reduce the number of datagrams sent but
; may also affect other aspects of
; performance.
PACKETSIZE=n ; specifies the maximum size of UDP
; datagrams sent overthe IP network. The
; default value is 2048.
TRANSPORT: ; The Transport stanza (AIX only) is used
; to tailor User Datagram Protocol (UDP)
; support on your MQSeries system and
; must be coded in conjunction with the
; UDP stanza above.
RETRYEXIT= ; specifies the name of the library that
; contains the retry exit. The retry exit
; allows your application to suspend data
; being sent on a channel when
; communication is not possible. For AIX
; systems, the retry exit name takes the
; form xyz(myexit).
QUEUEMANAGERSTARTUP:
CHINIT=Yes ; Start the CHINIT"
Notes:
For more information about the qm.ini file and the other stanzas in it, refer to the WebSphere MQ System Administration Guide book for WebSphere MQ for AIX, HP-UX, Solaris, and Windows, and MQSeries V5.1 for Compaq Tru64 UNIX, and OS/2 Warp, and to the WebSphere MQ for iSeries V5.3 System Administration book for WebSphere MQ for iSeries.