STOP LISTENER

Use the MQSC command STOP LISTENER to stop a channel listener.


Use MQSC commands

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

We can issue this command from sources CR. For an explanation of the source symbols, see Sources from which we can issue MQSC commands on z/OS .

Synonym: STOP LSTR


z/OS


STOP LISTENER

STOP LISTENER CMDSCOPE(' ')CMDSCOPE(qmgr-name)1INDISP(QMGR)INDISP(GROUP)1IPADDR(string)PORT(integer)TRPTYPE(TCP)TRPTYPE(LU62)Notes:


Other platforms


STOP LISTENER

STOP LISTENER ? ( name ) IGNSTATE(NO)(YES)


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, we 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.

      We can specify a queue manager name, other than the queue manager on which the command was entered, only if we 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
    This parameter allows you to specify whether we want the command to return an error return code, if the object is already in the state the command would move it to. Possible values are:

      NO
      If the listener being stopped is already in that state, the command returns RC=10. This is the existing behavior, and NO is the default value.

      YES
      If the listener being stopped is already in that state, the command returns RC=0. The return code is the case as if the listener is not running.

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

Parent topic: MQSC commands