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