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
|
|
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
|
|
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
|
|
-b hostName:portNumber |
The broker housing the
bridge. Literal IP addresses as host names: You can use a literal IPv4 or IPv6 address as a host name.
If you use a literal IPv6 address, its format must conform to RFC2732,
Format for Literal IPv6 Addresses in URL's. 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 |
|