mqsistart command

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

Supported platforms

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

Purpose

The mqsistart command:

  • Checks that the integration node environment is set up correctly; for example, that the installed level of Java™ is supported.
  • On Linux and UNIX systems, where the mqsisetdbparms command was used to associate the data source with the integration node, the mqsistart command:
    • Checks integration node 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 integration node from starting cleanly.

  • If the integration node has a queue manager, and that queue manager that is not running, the command returns an error.

  • Checks the publish/subscribe mode (attribute PSMODE) of the queue manager that is associated with the integration node. 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 integration node administration security, you must also set up the authority that is detailed in Tasks and authorizations for administration security.

The integration node 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.