mqsicreatebroker command

Use the mqsicreatebroker command to create an integration node.

Purpose

When you use the mqsicreatebroker command, the following actions are completed:
  1. On distributed systems, if the optional -q parameter is specified, the named local queue manager is associated with the integration node. This queue manager is used by default for MQ processing in the message flow if no queue manager has been specified explicitly on the MQ node.
    The queue manager that is specified on the integration node is also required for message flow nodes that use system queues to store state information about the messages, such as the event-driven processing nodes that are used for aggregation and timeout flows, message collections, and message sequences. The following IBM® Integration Bus features require a queue manager to be specified for the integration node, and they also require a set of system queues to be created:
    • Event-driven processing nodes
    • Publish/subscribe (if you are using WebSphere® MQ rather than MQTT)
    • An integration node listener
    • SAP nodes (for high availability)
    • Record and replay
    • Accounting and statistics using the web user interface (if you are using WebSphere MQ rather than MQTT)
    • FTEInput and FTEOutput nodes
    • CDInput and CDOutput nodes

    For information on creating the required queues, see Creating the default IBM Integration Bus queues on a WebSphere MQ queue manager

    Queues that are specified on event-driven processing nodes are created automatically when the flow is deployed, if the integration node has the required permissions to create the queues. If the queues are not created automatically, you can create them manually; see Creating the default IBM Integration Bus queues on a WebSphere MQ queue manager.

    If the specified queue manager does not exist, you must create it before the flow is deployed.

    If the -q parameter is not specified, some features that require access to WebSphere MQ will be unavailable. For more information about using WebSphere MQ with IBM Integration Bus, see Enhanced flexibility in interactions with WebSphere MQ and Installing WebSphere MQ.

    z/OS platformOn z/OS, the specified queue manager must exist locally, and the required queues are created automatically. If the named queue manager does not exist, the mqsicreatebroker command fails, and an error is issued.

  2. Windows platformOn Windows only, the command installs a service under which the integration node runs.
  3. The command creates the integration node in one of the available operation modes. If the full package is installed, the default mode is advanced. If the Developer Edition is installed, the default mode is developer. For more information, see Operation modes.
  4. The command creates a record for the component in the registry.
  5. Linux platformWindows platformUNIX platformOn Windows, Linux, and UNIX systems, the command allows you to specify whether the integration node can be started and stopped as a WebSphere MQ service.
  6. When you create an integration node, the default port that is used for the first integration node is 4414. You can disable the web user interface or change the port on which it runs by using the mqsichangeproperties command. If administration security is not enabled, web users can access the web user interface as a default user with unrestricted access to data and integration node resources.

Usage notes

In IBM Integration Bus Version 10.0, the -4 integrationRegistryHostName parameter is deprecated. The ability to share an Integration Registry across a multi-instance integration node environment is now available without the need to designate an Integration Registry host name.

When you create a multi-instance integration node, the resources are stored on a shared file system. The user that issues the mqsicreatebroker command must have the correct permissions on the shared file system to create these resources.

For details of this command on the operating system that your enterprise uses, see the appropriate topic.

Responses

If you run the mqsicreatebroker command and it fails, resolve the problem that caused the failure:
  • Check responses; see Responses to commands.
  • Check the error logs; see Local error logs.
  • Check the error messages in the error log; you can search for more information about error messages in the product documentation.
When you run the same command again, you might receive a series of messages that specify items that cannot be created. Receiving these messages does not indicate a problem with the mqsicreatebroker command itself.