WebSphere Message Broker, Version 8.0.0.7 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

mqsiaddbrokerinstance command - Linux and UNIX systems

Use the mqsiaddbrokerinstance command to add a multi-instance broker on Linux and UNIX systems.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-mqsiaddbrokerinstance--brokerName-- -e -- sharedWorkpath ---->

>--+------------------+----------------------------------------><
   '- -w -- Workpath -'   

Parameters

brokerName
(Required) The name of the broker instance that you are adding. You must specify the name as the first parameter and the name is case-sensitive. The broker instance name must match that of a multi-instance enabled broker previously created using the mqsicreatebroker command.

For restrictions on the character set that you can use, see Characters allowed in object names.

-e sharedWorkpath
(Required) The value represents the directory in which globally accessible working files for this broker are located in shared network storage (NFS or NAS).

You must ensure the broker has access to this network storage location before you start the broker, and that the queue manager for the broker has been configured as a WebSphere® MQ multi-instance queue manager.

The information stored in this shared directory includes:
  • The broker registry
  • Component directories
  • Internal broker tables and files for deployed message flows
  • Configurable service properties.
-w Workpath
(Optional) The directory in which working files specific to this broker instance are stored locally on the server where the broker instance is going to run. If you do not specify this parameter, files are stored in the default Work path, which is the one you specified when the product was installed. If you specify this parameter, you must create this directory before you start the broker.

This directory is also used for trace records that are created when tracing is active. These records are written to a subdirectory, log, which you must create before you start the broker.

Error logs that are written by the broker when a process ends abnormally are stored in this directory.

The error log is unbounded and continues to grow. Check this directory periodically and clear out old error information.

You cannot change this parameter using the mqsichangebroker command. To specify or change the work path, delete and re-create the broker.

Specifying this parameter creates a separate working directory for the broker. This working directory is a subset of the default working directory structure that contains fewer subdirectories and no common\profiles subdirectory.

Examples

The following example adds a broker instance on broker Mybroker using queue manager MyQmgr on the shared work path MyNetworkSharedWorkpath:

mqsiaddbrokerinstance MyBroker –e /MyNetworkSharedWorkpath
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2016Copyright IBM Corporation 1999, 2016.

        
        Last updated:
        
        Last updated: 2016-05-23 14:48:18


Reference topicReference topic | Version 8.0.0.7 | bn13520_.dita