Stop Channel Listener
The Stop Channel Listener (MQCMD_STOP_CHANNEL_LISTENER) command stops an IBM MQ listener.
Required parameters
- ListenerName (MQCFST)
- Listener name (parameter identifier: MQCACH_LISTENER_NAME). This parameter does not apply to
z/OS .
The name of the listener definition to be stopped. If this parameter is specified, no other parameters can be specified.
The maximum length of the string is MQ_LISTENER_NAME_LENGTH.
Optional parameters for z/OS
- CommandScope (MQCFST)
- Command scope (parameter identifier: MQCACF_COMMAND_SCOPE).
Specifies how the command is processed when the queue manager is a member of a queue sharing group. We can specify one of the following:
- blank (or omit the parameter altogether). The command is processed on the queue manager on which it was entered.
- a queue manager name. The command is processed on the queue manager you specify, providing it is active within the queue sharing group. If you specify a queue manager name other than the queue manager on which it was entered, we must be using a queue sharing group environment, and the command server must be enabled.
This parameter is valid only on z/OS.
The maximum length is MQ_QSG_NAME_LENGTH.
- InboundDisposition (MQCFIN)
- Inbound transmission disposition (parameter identifier: MQIACH_INBOUND_DISP).
Specifies the disposition of the inbound transmissions that the listener handles. The value can
be any of the following values:
- MQINBD_Q_MGR
- Handling for transmissions directed to the queue manager. MQINBD_Q_MGR is the default.
- MQINBD_GROUP
- Handling for transmissions directed to the queue sharing group. MQINBD_GROUP is permitted only if there is a shared queue manager environment.
This parameter is valid only on z/OS.
- IPAddress (MQCFST)
- IP address (parameter identifier: MQCACH_IP_ADDRESS).
The IP address for TCP/IP specified in dotted decimal or alphanumeric form. This parameter is valid on z/OS only where channels have a TransportType of MQXPT_TCP.
The maximum length of the string is MQ_IP_ADDRESS_LENGTH.
- Port (MQCFIN)
- Port number for TCP (parameter identifier: MQIACH_PORT_NUMBER).
The port number for TCP. This parameter is valid only on z/OS where channels have a TransportType of MQXPT_TCP.
- TransportType (MQCFIN)
- Transmission protocol type (parameter identifier: MQIACH_XMIT_PROTOCOL_TYPE).
The value can be:
- MQXPT_LU62
- LU 6.2.
- MQXPT_TCP
- TCP.
This parameter is valid only on z/OS.
Optional parameters for Multiplatforms
- MQIACF_IGNORE_STATE
- 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:
- MQIS_NO
- If the channel listener being stopped is already in that state, the command returns RC=10. This is the existing behavior, and NO is the default value.
- MQIS_YES
- If the channel listener being stopped is already in that state, the command returns RC=0. The return code is the case as if the channel listener is not running.
Error codes
This command might return the following error code in the response format header, in addition to the values shown in Error codes applicable to all commands.
- Reason (MQLONG)
- The value can be any of the following values:
- MQRCCF_LISTENER_STOPPED
- Listener not running.
Parent topic: Definitions of the Programmable Command Formats