STOP LISTENER

---

Use STOP LISTENER to stop a channel listener.

Notes:

1. This is valid only for channels used for distributed queuing without CICS. If you are using CICS for distributed queuing, see the WebSphere MQ Intercommunication manual.

2. The command server and the channel initiator must be running.

3. If a listener is listening on multiple addresses or ports, only the address and port combinations with the address, or port, specified are stopped.

4. If a listener is listening on all addresses for a particular port, a stop request for a specific IPADDR with the same port fails.

5. If neither an address nor a port is specified, all addresses and ports are stopped and the listener task ends.

Synonym: STOP LSTR

STOP LISTENER
 
                  .-CMDSCOPE(' ')------------.
>>-STOP LISTENER--+--------------------------+------------------>
                  |                     (1)  |
                  '-CMDSCOPE(qmgr-name)------'
 
   .-INDISP(QMGR)-------.
>--+--------------------+--+------------------------+----------->
   |               (1)  |  '---IPADDR(ip-address)---'
   '-INDISP(GROUP)------'
 
                              .-TRPTYPE(TCP)--.
>--+-----------------------+--+---------------+----------------><
   '---PORT(port-number)---'  '-TRPTYPE(LU62)-'
 
 

Notes:

1. Valid only on full function WebSphere MQ for z/OS when the queue manager is a member of a queue-sharing group.

 

Parameter descriptions

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.

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.

IPADDR

IP address for TCP/IP specified in dotted decimal or alphanumeric form. This is valid only if the transmission protocol (TRPTYPE) is TCP/IP.

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.

TRPTYPE

Transmission protocol used. This is optional.

TCP

TCP. This is the default if TRPTYPE is not specified.

LU62

SNA LU 6.2.

The listener stops in quiesce mode (it disregards any further requests).

 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.