Change MQ Listener (CHGMQMLSR)
- Where allowed to run
- All environments (*ALL)
- Threadsafe
- Yes
The Change MQ Listener (CHGMQMLSR) command changes the specified attributes of an existing MQ listener definition.
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 |
| TEXT | Text 'description' | Character value, *BLANK, *SAME | Optional, Positional 3 |
| CONTROL | Listener control | *SAME, *MANUAL, *QMGR, *STARTONLY | Optional, Positional 4 |
| PORT | Port number | 0-65535, *SAME | Optional, Positional 5 |
| IPADDR | IP Address | Character value, *BLANK, *SAME | Optional, Positional 6 |
| BACKLOG | Listener backlog | 0-999999999, *SAME | Optional, Positional 7 |
Listener name (LSRNAME)
>The name of the listener definition to be changed.
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.
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:
- *SAME
- The attribute is unchanged.
- *BLANK
- The text is set to a blank string.
- description
- Specify no more than 64 characters enclosed in apostrophes.
Listener control (CONTROL)
>Whether the listener starts automatically when the queue manager is started.
The possible values are:
- *SAME
- The attribute is unchanged.
- *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 automatically stopped when the queue manager is stopped.
Port number (PORT)
>The port number to be used by the listener.
The possible values are:
- *SAME
- The attribute is unchanged.
- port-number
- The port number to be used.
IP Address (IPADDR)
>The IP address to be used by the listener.
The possible values are:
- *SAME
- The attribute is unchanged.
- ip-addr
- The IP address to be used.
Listener backlog (BACKLOG)
>The number of concurrent connection requests the listener supports.
The possible values are:
- *SAME
- The attribute is unchanged.
- backlog
- The number of concurrent connection requests supported.
Examples
>None
Error messages
>Unknown
Parent topic: CL commands reference for IBM i