runmqlsr (run listener)
Purpose
Use the runmqlsr command to start a listener process.
This command is run synchronously and will wait until the listener process has finished before returning to the caller.
Syntax
>>-runmqlsr-- -t -----------------------------------------------> >--+- tcp --+------------+--+--------------+--+---------------+-+--> | '- -p --Port-' '- -i --IPAddr-' '- -b --Backlog-' | +- lu62 -- -n --TpName---------------------------------------+ | .---------------------. | | V | | +- netbios ----+-----------------+-+-------------------------+ | +- -a --Adapter---+ | | +- -l --LocalName-+ | | +- -e --Names-----+ | | +- -s --Sessions--+ | | '- -o --Commands--' | | .-------------------. | | V | | '- spx ----+---------------+-+-------------------------------' +- -x --Socket--+ '- -b --Backlog-' >--+----------------+------------------------------------------>< '- -m --QMgrName-'
Required parameters
- -t
- The transmission protocol to be used:
tcp Transmission Control Protocol / Internet Protocol (TCP/IP) lu62 SNA LU 6.2 (Windows only) netbios NetBIOS (Windows only) spx SPX (Windows only)
Optional parameters
- -p Port
- The port number for TCP/IP. This flag is valid for TCP only. If you omit the port number, it is taken from the queue manager configuration information, or from defaults in the program. The default value is 1414.
- -i IPAddr
- The IP address for the listener, specified in one of the following formats:
- IPv4 dotted decimal
- IPv6 hexadecimal notation
- Alphanumeric format
This flag is valid for TCP/IP only.
On systems that are both IPv4 and IPv6 capable we can split the traffic by running two separate listeners, one listening on all IPv4 addresses and one listening on all IPv6 addresses. If you omit this parameter, the listener listens on all configured IPv4 and IPv6 addresses.
- -n TpName
- The LU 6.2 transaction program name. This flag is valid only for the LU 6.2 transmission protocol. If you omit the name, it is taken from the queue manager configuration information.
- -a Adapter
- The adapter number on which NetBIOS listens. By default the listener uses adapter 0.
- -l LocalName
- The NetBIOS local name that the listener uses. The default is specified in the queue manager configuration information.
- -e Names
- The number of names that the listener can use. The default value is specified in the queue manager configuration information.
- -s Sessions
- The number of sessions that the listener can use. The default value is specified in the queue manager configuration information.
- -o Commands
- The number of commands that the listener can use. The default value is specified in the queue manager configuration information.
- -x Socket
- The SPX socket on which SPX listens. The default value is hexadecimal 5E86.
- -m QMgrName
- The name of the queue manager. By default the command operates on the default queue manager.
- -b Backlog
- The number of concurrent connection requests that the listener supports. See LU62, NETBIOS, TCP, and SPX for a list of default values and further information.
Return codes
0 Command completed normally 10 Command completed with unexpected results 20 An error occurred during processing
Examples
The following command runs a listener on the default queue manager using the NetBIOS protocol. The listener can use a maximum of five names, five commands, and five sessions. These resources must be within the limits set in the queue manager configuration information.
runmqlsr -t netbios -e 5 -s 5 -o 5
Parent topic:
The control commands
fa15940_
Home