STOP LISTENER

Using MQSC commands

For information on how you use MQSC commands, see Performing local administration tasks using MQSC commands.

z/OS

STOP LISTENER

Notes:

• ¹ Valid only on z/OS when the queue manager is a member of a queue sharing group.

Other platforms

STOP LISTENER

Usage notes

• 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 runs when the queue manager is a member of a queue sharing group.

' '

The command runs on the queue manager on which it was entered. This is the default value.

qmgr-name

The command runs 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.

IGNSTATE

Specifies whether the command fails if the listener is already stopped. The possible values are:

NO

The command fails if the listener is already stopped. This is the default value.

YES

The command succeeds regardless of the current state of the listener.