runmqlsr (run listener)

Run a listener process to listen for remote requests on various communication protocols.

Purpose

Use the runmqlsr command to start a listener process.

This command is run synchronously and waits until the listener process has finished before returning to the caller.

Syntax

Read syntax diagramSkip visual syntax diagram runmqlsr   -t   tcp   -p Port  -i IPAddr  -b Backlog  lu62   -n TpName  netbios   -a Adapter  -l LocalName  -e Names  -s Sessions  -o Commands  spx   -x Socket  -b Backlog  -m QMgrName

Required parameters

-t
The transmission protocol to be used:
Table 1. Transmission protocol values.
Header Header
tcp Transmission Control Protocol / Internet Protocol (TCP/IP)
lu62 [Windows]SNA LU 6.2 ( Windows only)
netbios [Windows]NetBIOS ( Windows only)
spx [Windows]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. It must not exceed 65535.
-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 you 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 TCP, LU62, NETBIOS, and SPX for a list of default values and further information.

Return codes

Return code Description
0 Command completed normally
4 Command completed after being ended by the endmqlsr command
10 Command completed with unexpected results
20 An error occurred during processing: the AMQMSRVN process did not start.

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