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 |