Home

 

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