IBM Integration Bus, Version 9.0.0.8 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

mqsistart command

Use the mqsistart command to start the specified broker if all initial verification tests complete successfully.

Supported platforms

  • Windows
  • Linux and UNIX systems
  • z/OS® as a console command.

Purpose

The mqsistart command:

  • On distributed systems, starts the associated queue manager if it is not running.
  • Checks that the broker environment is set up correctly; for example, that the installed level of Java™ is supported.
  • Verifies that the WebSphere® MQ queues are defined and accessible.

    The command completes these checks, and reports all errors in the system log, or to the command line, or both. If one or more checks fail, the command does not start the component.

  • On Linux and UNIX systems, where the mqsisetdbparms command has been used to associate the datasource with the broker, the mqsistart command:
    • Checks broker connectivity to, and
    • Performs tests against
    any user data sources where the IBM® Integration Bus Database Extender SupportPac is being used for extended database support.

    If any issues are identified, a warning is reported to the system log and command line. However, this step does not prevent the broker from starting cleanly.

  • Checks the publish/subscribe mode (attribute PSMODE) of the queue manager associated with the broker. If the PSMODE is set to DISABLED, it is changed to COMPAT and this is reported to the system log. If the PSMODE is already set to COMPAT or ENABLED, the setting is not changed.
Select the appropriate link for details of this command on the platform, or platforms, that your enterprise uses:

Authorization

For information about platform-specific authorizations, see the following topics: If you have enabled broker administration security, you must also set up the authority detailed in Tasks and authorizations for administration security.

The broker starts only if the user ID under which it will run is authorized to access both the following locations. On Windows, the user ID is defined by the ServiceUserID specified on mqsicreatebroker; on Linux and UNIX systems, it is the user ID with which you run this command:

  • Home directory, where IBM Integration Bus has been installed.
  • Working directory, if specified by the -w flag on the mqsicreatebroker command.

an07230_.htm | Last updated Friday, 21 July 2017