Change the status of an integration node so that it runs
as a WebSphere® MQ service, or remove
an existing service, by using the mqsichangebroker command.
About this task
To run an integration node as a WebSphere MQ service, complete the following
steps.
Procedure
- Stop the integration node and its associated queue manager.
If you are modifying a multi-instance integration node, you
must stop all integration node instances and the multi-instance queue
manager, if you want the changes to take effect immediately after
the queue manager restarts.
- Use the mqsichangebroker command
with the -d defined parameter to activate the WebSphere MQ service as follows:
mqsichangebroker IBNODE -d defined
where
IBNODE represents the
name of the integration node that you want to modify.
If
the WebSphere MQ service did not previously
exist, it is defined, and the service CONTROL attribute is set to
QMGR.
The integration node now starts and stops automatically
when the queue manager starts and stops.
You can stop
the integration node manually with the mqsistop command, but the integration
node will not restart until the queue manager is stopped and restarted.
For a multi-instance integration node, this can occur during failover
of the active queue manager.
To remove the WebSphere MQ service,
complete these further steps.
- Use the mqsichangebroker command with
the -d undefined parameter:
mqsichangebroker MyBroker -d undefined
where
IBNODE represents the
name of the integration node that you want to modify.
When a
WebSphere MQ service is being removed, and
the queue manager is stopped, the
mqsichangebroker command needs
to start the queue manager to perform the deletion of the service.
The command then stops the queue manager. The following example shows
a possible output:
>mqsichangebroker BK3 -d undefined
WebSphere MQ queue manager 'QM3' starting.
5 log records accessed on queue manager 'QM3' during the log replay phase.
Log replay for queue manager 'QM3' complete.
Transaction manager state recovered for queue manager 'QM3'.
WebSphere MQ queue manager 'QM3' started.
Waiting for queue manager 'QM3' to end.
Waiting for queue manager 'QM3' to end.
WebSphere MQ queue manager 'QM3' ended.
BIP8071I: Successful command completion.
- Start the integration node by using the mqsistart command.
- Start the queue manager.