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

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 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. 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 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 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