runmqlsr (run listener)

 

 

Purpose

Use the runmqlsr command to start a listener process.

 

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-'                             |
   '- udp --+----------+----------------------------------'
            '- -p Port-'
 
>--+--------------+--------------------------------------------><
   '- -m queue_manager-'
 
 

 

Required parameters

-t

The transmission protocol to be used:

tcp	Transmission Control Protocol / Internet Protocol (TCP/IP)
lu62	SNA LU 6.2 (Windows NT and Windows 2000 only)
netbios	NetBIOS (Windows NT and Windows 2000 only)
spx	SPX (Windows NT and Windows 2000 only)
udp	User datagram protocol (UDP) (AIX only)

 

Optional parameters

-p Port

The port number for TCP/IP. This flag is valid for TCP and UDP. 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 dotted decimal or alphanumeric format. This flag is valid only for TCP/IP. If you omit this parameter, the listener listens on all IP addresses available to the TCP/IP stack.

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

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

 

AIX is a trademark of the IBM Corporation in the United States, other countries, or both.