STOP LISTENER
Use the MQSC command STOP LISTENER to stop a channel listener.
UNIX and Linux® | Windows |
---|---|
Usage notes
On z/OS:- The command server and the channel initiator must be running.
- If a listener is listening on multiple addresses or ports, only the address and port combinations with the address, or port, specified are stopped.
- If a listener is listening on all addresses for a particular port, a stop request for a specific IPADDR with the same port fails.
- If neither an address nor a port is specified, all addresses and ports are stopped and the listener task ends.
Parameter descriptions for STOP LISTENER
- (name)
- Name of the listener to be stopped. If you specify this parameter,
you cannot specify any other parameters.
This parameter is required on all platforms other than z/OS where it is not a supported parameter.
- CMDSCOPE
- This parameter specifies how the command is executed
when the queue manager is a member of a queue-sharing group.
- ' '
- The command is executed on the queue manager on which it was entered. This is the default value.
- qmgr-name
- The command is executed on the queue manager you specify, providing
the queue manager is active within the queue-sharing group.
You can specify a queue manager name, other than the queue manager on which the command was entered, only if you are using a queue-sharing group environment and if the command server is enabled.
This parameter is valid only on z/OS.
- INDISP
- Specifies the disposition of the inbound transmissions
that the listener handles. The possible values are:
- QMGR
- Handling for transmissions directed to the queue manager. This is the default.
- GROUP
- Handling for transmissions directed to the queue-sharing group. This is allowed only if there is a shared queue manager environment.
This parameter is valid only on z/OS.
- IPADDR
- IP address for TCP/IP specified in IPv4 dotted decimal,
IPv6 hexadecimal notation, or alphanumeric form. This is valid only
if the transmission protocol (TRPTYPE) is TCP/IP.
This parameter is valid only on z/OS.
- PORT
- The port number
for TCP/IP. This is the port number on which the listener is to stop
listening. This is valid only if the transmission protocol is TCP/IP.
This parameter is valid only on z/OS.
- TRPTYPE
- Transmission protocol used. This is optional.
- TCP
- TCP. This is the default if TRPTYPE is not specified.
- LU62
- SNA LU 6.2.
This parameter is valid only on z/OS.
The listener stops in quiesce mode (it disregards any further requests).