Starting the WebSphere MQ channels and listeners

This topic tells you how to start the channels and listeners on Linux, UNIX systems and Windows platforms.

To complete the connection between two components that are supported by different queue managers, start the server channels that you created in Connecting the User Name Server to a broker on z/OS.

Before you can do that, you need to start the WebSphere MQ listeners that are to receive the messages sent out from these channels.
Note: All the examples use port 1414, the default WebSphere MQ port. You must ensure that you use the port space in the channel definition and that this port is not in use by another application.

UNIX systems

  1. To start a listener enter the following command in a shell window:
    runmqlsr -t tcp -p 1414 -m WBRK_QM
  2. To start a sender channel, enter the following command in a shell window:
    runmqchl -c BROKER.CONFIG -m WBRK_QM

LINUX systems

  • If you are using WebSphere MQ Version 6.0, listeners and channels can be started using the WebSphere MQ Explorer, in the same way as with Windows platforms, as described in Windows platforms using WebSphere MQ Version 6.
  • If you are using WebSphere MQ Version 5, listeners and channels must be started by entering commands in a shell window, as described in this section.
  1. To start a listener, enter the following command in a shell window:
    runmqlsr -t tcp -p 1414 -m WBRK_QM
  2. To start a sender channel, enter the following command in a shell window:
    runmqchl -c BROKER.CONFIG -m WBRK_QM

Windows platforms using WebSphere MQ Version 6

If you are using WebSphere MQ Version 6.0, start listeners and channels using WebSphere MQ Explorer.
  1. To start a listener as a background task:
    1. Click Start > Programs > IBM WebSphere MQ > WebSphere MQ Explorer.
    2. In the left pane expand the queue manager, expand Advanced, and select Listeners
    3. Right-click Listeners > New > TCP Listener..., enter a name for the listener, then click Finish. A new listener is created with transport type TCP and (default) port number 1414.
    4. Right-click the new listener and click Start to start it.
  2. To start the sender channels as background tasks using WebSphere MQ Explorer expand the queue manager, expand Advanced, and select Channels.
  3. If you prefer, you can start listeners and channels as foreground tasks:
    1. To start a listener, enter the following command on the command line:
      runmqlsr -t tcp -p 1414 -m WBRK_CONFIG_QM
    2. To start channels, enter the following commands:
      runmqchl -m WBRK_UNS_QM -c WBRK_UN_TO_BR
       
      runmqchl -m WBRK_QM -c WBRK_BR_TO_UN

Windows platforms using WebSphere MQ Version 5

If you are using WebSphere MQ Version 5, start the listeners using WebSphere MQ Services, and start channels by entering commands on the command line.
  1. To start a listener as a background task:
    1. Click Start > Programs > IBM WebSphere MQ > WebSphere MQ Services.
    2. Expand the left pane and select the queue manager WBRK_CONFIG_QM to display its services in the right pane.
    3. If the listener is displayed, right-click and select AllĀ Tasks > Start to start the listener.
    4. If the listener is not displayed:
      1. Right-click the queue manager and select New > Listener. A new listener is created with (default) transport type TCP and (default) port number 1414.
      2. Right-click the new listener and select Start to start it.
  2. If you prefer, you can start a listener as a foreground task. Enter the following command on the command line:
    runmqlsr -t tcp -p 1414 -m WBRK_CONFIG_QM
  3. To start the channels as foreground tasks, enter the following commands:
    runmqchl -m WBRK_UNS_QM -c WBRK_UN_TO_BR
     
    runmqchl -m WBRK_QM -c WBRK_BR_TO_UN
Related concepts
Broker domains