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

Start of change
  • 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 not using WebSphere MQ Version 6.0, listeners and channels must be started by entering commands in a shell window, as described in this section.
End of change
  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
Start of change

Windows platforms using WebSphere MQ Version 6

If you are using WebSphere MQ Version 6.0, listeners and channels are started using the WebSphere MQ Explorer.
  1. To start a listener use the following steps:
    1. Click Start > Programs > IBM WebSphere MQ > WebSphere MQ Explorer
    2. In the left pane expand the queue manager WBRK_CONFIG_QM, expand Advanced, and then 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. This starts the listener.
  2. To start a listener as a foreground task, enter the following command on the command line:
    runmqlsr -t tcp -p 1414 -m WBRK_CONFIG_QM
    To start a sender channel, use WebSphere MQ Explorer. This starts the channels as background tasks.
  3. If you prefer, you can enter the commands:
    runmqchl -m WBRK_UNS_QM -c WBRK_UN_TO_BR
     
    runmqchl -m WBRK_QM -c WBRK_BR_TO_UN
End of change
Start of change

Windows platforms NOT using WebSphere MQ Version 6

If you are not using WebSphere MQ Version 6.0, listeners are started using WebSphere MQ Services, and channels by entering commands on the command line.
  1. Start a listener as a background task by using WebSphere MQ Services:
    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 it and click AllĀ Tasks -> Start. This starts the listener. If the listener is not displayed:
    4. Right-click the queue manager and click New -> Listener. A new listener is created with (default) transport type TCP and (default) port number 1414.
    5. Right-click the new listener and click Start. This starts the listener.
  2. Start 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
End of change