The Bridge Service Manager

The Message Queue Bridge Service Manager is an application that runs in same JVM as a broker to manage the bridges configured for the broker. Two administrative components control operation of the Bridge Service Manager:

• Bridge-related broker properties

• The Bridge Manager utility (imqbridgermgr)

The following sections introduce these two components.

Bridge-Related Broker Properties

The operation of the Bridge Service Manager is in part controlled by several broker properties. These broker properties, all of which begin with imq.bridge, are listed in tables under Bridge Properties. Some of the properties apply to all bridges configured for the broker, while others apply only to a specific bridge. The properties that apply to a specific bridge all begin with imq.bridge.bridgeName, where bridgeName is:

• The same as the type of the bridge for bridge services that support only one bridge instance per broker, such as the STOMP bridge service

• A name you specify for a bridge instance for bridge services that support multiple bridge instances per broker, such as the JMS bridge service

Of all the bridge-related broker properties, the two most important are imq.bridge.enabled and imq.bridge.activelist:

• The imq.bridge.enabled property controls whether the Bridge Service Manager is enabled on the broker.

• The imq.bridge.activelist property contains a comma-separated list bridges (by name) to be loaded when the broker starts.

To Enable the Bridge Service Manager

1. Set the imq.bridge.enabled broker property to true.

2. Set the imq.bridge.admin.user broker property to the user name of the admin user.

3. Set the imq.bridge.admin.password broker property to the password of the admin user.

   Alternatively, you can specify the password using the -passfile option when you use the imqbrokerd command to start the broker hosting the bridge service manager.

4. Set the imq.bridge.activelist broker property to a comma-separated list of bridges to instantiate at broker startup.

Bridge Manager Utility

The Bridge Manager utility (imqbridgemgr) is the interface to the bridge management functions of the Bridge Service Manager. It provides commands to:

• Stop and start bridges

• Pause and resume bridges

• List configured bridges

• Manage type-dependent subcomponents of bridges, such as the links within a JMS bridge service

The imqbridgemgr utility uses the same command line syntax as the other Message Queue utilities:

imqbridgemgr subcommand commandArgument [ options ]

For example, the following command lists all bridges of type JMS on the broker localhost:7373:

imqbridgemgr list bridge -t jms -b localhost:7373

For the complete set of subcommands, command arguments, and options supported by the imqbridgemgr utility, see Bridge Manager Utility.

Logging of Bridge Services

Each bridge managed by the Bridge Service Manager for a broker has its own log file. Where these log files are stored depends on how Message Queue was installed:

From IPS packages: IMQ_VARHOME/instances/broker-name/bridges/bridge-name/




From Solaris SVR4 packages: /var/imq/instances/broker-name/bridges/bridge-name/




From Linux RPM packages: /var/opt/sun/mq/instances/broker-name/bridges/bridge-name/

The JMS and STOMP bridge services use the Java logging facility, which can be configured by the Java logging configuration file. The logging level for a bridge can be controlled by setting the imq.bridge.bridge-name.level property in the Java logging configuration file. Then, the Java system property java.util.logging.config.file can be set to the Java logging configuration file when the broker is started; as in:

imqbrokerd -Djava.util.logging.config.file=config-file