Starting a channel initiator

To start a channel initiator, you must first create a service that will start the channel initiator.

About this task

Because a channel initiator is just a special type of trigger monitor, to start a channel initiator from IBM® MQ Explorer, you must first create a service that will run the runmqchi command (to start the channel initiator) when the service starts.

The following instructions assume that you are creating a service called ChannelInitiator on a queue manager called QM1. For more information about channel initiators, see Starting and stopping the channel initiator in the IBM MQ online product documentation.

To create the channel initiator service:

Procedure

  1. In the Navigator view, expand the queue manager, QM1, that you want to start the channel initiator on.
  2. Right-click the queue manager's Services folder, then click New... > Service. The New Service dialog opens.
  3. In the New Service dialog, type a name for the service, for example, ChannelInitiator, then click Next. You can now configure the new service, ChannelInitiator.
  4. Optional: In the Description field, type a description of the ChannelInitiator service, for example, A channel initiator for queue manager QM1.
  5. In the Service control field, configure how the service starts and stops:
    • To start and stop the service automatically when the queue manager starts and stops, click Queue Manager
    • To start the service automatically when the queue manager starts but not to stop when the queue manager stops, click Queue Manager Start
    • To configure the service so that you must manually start and stop it, click Manual.
  6. In the Start Command field, type the full path to the runmqchi command.
    • Type: MQ_INSTALLATION_PATH\bin\runmqchi where MQ_INSTALLATION_PATH is replaced by the high-level directory in which IBM MQ is installed.
  7. If QM1 is not the default queue manager, in the Start args field, type -m QM1
  8. If you want to use a queue other than SYSTEM.CHANNEL.INITQ as the initiation queue, in the Start args field, type -q initq_name where initq_name is the name of the queue.
  9. In the Service Type field, select Command.
  10. Click Finish.
    The new service, ChannelInitiator, is created on the selected queue manager, QM1.
  11. Start the service.
    For instructions, see Starting and stopping a custom service.

Results

The service, ChannelInitiator, starts and runs the runmqchi command, which starts the channel initiator on the queue manager, QM1.