Sun GlassFish Message Queue 4.4 Administration Guide

Bridge Manager Utility

The Bridge Manager utility (imqbridgemgr) is used to manage the bridges configured for a broker, including the links within bridge types that support links. The basic syntax of imqbridgemgr is:

imqbridgemgr subcommand commandArgument [ options ]
imqbridgemgr -h | -help
imqbridgemgr -H | -Help
imqbridgemgr -v | -version

Table 16–17 lists the imqbridgemgr subcommands for general bridge management, Table 16–18 lists the imqbridgemgr subcommands for link management, which are applicable only to bridge types that support links, and Table 16–19 lists the imqbridgemgr options.

Table 16–17 Bridge Manager Subcommands for Bridge Management


Subcommand	Description
`list bridge`	Lists the bridges specified by the command options provided. For each bridge, the bridge name, type and state are displayed.
`pause bridge`	Pauses the bridges specified by the command options provided if the bridge type supports this subcommand. Attempting to pause a bridge that is stopped generates an error, and attempting to pause a bridge that is already paused has no effect.
`resume bridge`	Resumes the bridges specified by the command options provided if the bridge type supports this subcommand. Attempting to resume a bridge that is stopped generates an error, and attempting to resume a bridge that is already started has no effect.
`start bridge`	Starts the bridges specified by the command options provided. Attempting to start a bridge that is paused causes the bridge to resume, and attempting to start a bridge that is already started has no effect.
`stop bridge`	Stops the bridges specified by the command options provided. Attempting to stop a bridge that is paused causes the bridge to stop, and attempting to stop a bridge that is already stopped has no effect.

Table 16–18 Bridge Manager Subcommands for Link Management


Subcommand	Description
`list link`	Lists the links specified by the command options provided. For each link, the link name, state, source, target, and transaction status are displayed.
`pause link`	Pauses the link specified by the command options provided. Attempting to pause a link that is stopped, in the process of stopping, or has never been started generates an error. Attempting to pause a link that is already paused or in the process of pausing has no effect.
`resume link`	Resumes the link specified by the command options provided. Attempting to resume a link that is stopped, in the process of stopping, or has never been started generates an error. Attempting to resume a link that is already started or in the process of starting has no effect.
`start link`	Starts the link specified by the command options provided. Attempting to start a link that is paused causes the link to resume. Attempting to start a link that is in the process of pausing causes the link to complete pausing and then to resume. Attempting to start a link that is already started or in the process of starting has no effect.
`stop link`	Stops the link specified by the command options provided. Attempting to stop a link that has never been started generates an error. Attempting to stop a link that is in the process of starting causes the link to complete starting and then to stop. Attempting to stop a link that is paused causes the link to stop. Attempting to stop a link that is in the process of pausing causes the link to complete pausing and then to stop. Attempting to stop a link that is already stopped or in the process of stopping has no effect.

Table 16–19 lists the options to the imqbridgemgr command.

Table 16–19 Bridge Manager Options


Option	Description
`-b` `hostName:portNumber`	The broker housing the bridge. Default value: localhost:7676
`-bn` `bridgeName`	The name of the bridge.
`-f`	Perform the action without user confirmation
`-javahome` `path`	Location of an alternative Java runtime. Default behavior: Use the runtime installed with Message Queue.
`-ln` `linkName`	The name of the link.
`-passfile` `path`	Location of password file
`-rtm` `timeoutInterval`	Initial timeout interval, in seconds This is the initial length of time that the Command utility will wait for a reply from the broker before retrying a request. Each subsequent retry will use a timeout interval that is a multiple of this initial interval. Default value: 10
`-rtr` `numRetries`	Number of retries to attempt after a broker request times out Default value: 5
`-s`	Silent mode (no output displayed)
`-secure`	Use secure connection to broker with `ssladmin` connection service
`-t` `bridgeType`	The type of the bridge: `JMS` or `STOMP`
`-u` `userName`	User name for authentication