CRTMQMLSR (Create MQ Listener)

Where allowed to run: All environments (*ALL)
Threadsafe: Yes

The Create MQ Listener (CRTMQMLSR) command creates a new MQ listener definition, specifying those attributes that are to be different from the default.

Parameters

Table 1. Command parameters
Keyword	Description	Choices	Notes
LSRNAME	Listener name	Character value	Required, Key, Positional 1
MQMNAME	Message Queue Manager name	`Character value`, *DFT	Optional, Key, Positional 2
REPLACE	Replace	NO, YES	Optional, Positional 3
TEXT	Text 'description'	`Character value`, BLANK, SYSDFTLSR	Optional, Positional 4
CONTROL	Listener control	SYSDFTLSR, MANUAL, QMGR, STARTONLY	Optional, Positional 5
PORT	Port number	0-65535, *SYSDFTLSR	Optional, Positional 6
IPADDR	IP Address	`Character value`, BLANK, SYSDFTLSR	Optional, Positional 7
BACKLOG	Listener backlog	0-999999999, *SYSDFTLSR	Optional, Positional 8

Listener name (LSRNAME)

The name of the new MQ listener definition to be created.

The possible values are:

listener-name: Specify the name of the listener definition. The maximum length of the string is 48 bytes.

Message Queue Manager name (MQMNAME)

Specifies the name of the queue manager.

The possible values are:

*DFT: Use the default queue manager.
queue-manager-name: The name of a message queue manager.

Replace (REPLACE)

If a listener definition with the same name already exists, this specifies whether it is to be replaced.

The possible values are:

*NO: This definition does not replace any existing listener definition with the same name. The command fails if the named listener definition already exists.
*YES: Replace the existing listener definition. If there is no definition with the same name, a new definition is created.

Text 'description' (TEXT)

Specifies text that briefly describes the listener definition.

Note: The field length is 64 bytes and the maximum number of characters is reduced if the system is using a double-byte character set (DBCS).

The possible values are:

*SYSDFTLSR: The value of this attribute is taken from the system default listener.
*BLANK: The text is set to a blank string.
description: Specify the new descriptive information.

Listener control (CONTROL)

Whether the listener starts automatically when the queue manager is started.

The possible values are:

*SYSDFTLSR: The value for this attribute is taken from the system default listener.
*MANUAL: The listener is not automatically started or stopped.
*QMGR: The listener is started and stopped as the queue manager is started and stopped.
*STARTONLY: The listener is started as the queue manager is started, but is not requested to stop when the queue manager is stopped.

Port number (PORT)

The port number to be used by the listener.

The possible values are:

*SYSDFTLSR: The value for this attribute is taken from the system default listener.
port-number: The port number to be used.

IP Address (IPADDR)

The IP address to be used by the listener.

The possible values are:

*SYSDFTLSR: The value for this attribute is taken from the system default listener.
ip-addr: The IP address to be used.

Listener backlog (BACKLOG)

The number of concurrent connection requests the listener supports.

The possible values are:

*SYSDFTLSR: The value for this attribute is taken from the system default listener.
backlog: The number of concurrent connection requests supported.