Create MQ Listener (CRTMQMLSR)
- 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
| 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.
Examples
>None
Error messages
>Unknown
Parent topic: CL commands reference for IBM i