Starting a channel initiator

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


Because a channel initiator is just a special type of trigger monitor, to start a channel initiator from IBM MQ Explorer, we 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 we are creating a service called ChannelInitiator on a queue manager called QM1. For more information about channel initiators, see Start and stop the channel initiator.

To create the channel initiator service:


Procedure

  1. In the Navigator view, expand the queue manager, QM1, that we 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. We 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 we 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. 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 Start and stop a custom service.


Results

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

Parent topic: Start and stop objects and services


Related concepts