Working with listeners

We can use the listeners widget in the IBM MQ Console to add and delete listeners, start and stop listeners, view and set listener properties, and manage the authority records for a listener.


Before you begin

You must create a listeners widget before we can use it. For more information about creating IBM MQ object widgets, see Working with IBM MQ objects.


About this task

The listeners widget lists the listeners that exist for a specific queue manager. We can select individual listeners from the list to work with.

We cannot use the listeners widget on z/OS®.


Procedure

  • To add a TCP/IP listener:
    1. Click the create icon in the listeners widget toolbar.
    2. Enter a name for the listener. Valid characters are letters and numbers and the ., /, _, and % characters.
    3. Enter an available TCP/IP port for the listener. The port number must not exceed 65535.
    4. Click Create. The new listener is created.
  • To delete a listener:
    1. Select the listener to delete from the list in the listeners widget.
    2. Click the delete icon in the listeners widget toolbar.
    3. Confirm to delete the listener by clicking Delete. The listener is deleted.
  • To start a listener:
    1. Select the listener to start from the list in the listeners widget.
    2. Click the start icon in the listeners widget toolbar.
  • To stop a listener:
    1. Select the listener to stop from the list in the listeners widget.
    2. Click the stop icon in the listeners widget toolbar.
    3. Confirm to stop the listener by clicking Stop.
  • To view and edit the properties of a listener:
    1. Select the listener in the listeners widget.
    2. Click the properties icon in the listeners widget toolbar. Alternatively, double-click the listener.
    3. View the properties and edit them as required. If the property text box is disabled, the property is read-only, or can be edited only from the command line. For information about a property, view the property information in Listener properties in the MQ Explorer documentation.
  • To view and edit authority records for a listener:
    1. Select the listener in the listeners widget.
    2. Click ... > Manage authority records. The authority records show the permissions that users and administrators have on the selected listener.