Use mqsistart to start a WebSphere Business Integration Message Broker component. If the queue manager associated with this component (defined in the corresponding create command) is not already running, it is also started by this command. However, no additional WebSphere MQ services (listeners, channels, or channel initiators) associated with the started component are started. Use WebSphere MQ Services (or MQSC) to start any additional services required.
Successful completion of this command indicates that the Windows service, or UNIX daemon has started successfully, and that the component startup has been initiated. Check the Windows system event log or UNIX syslog to determine if the component and all related software have started successfully, are initially active, and remain in an active state. Any errors that have prevented successful startup, detected by the component are recorded in the log. Continue to monitor the Windows system event log or UNIX syslog.
If the queue manager supporting the component specified on this command is not already running, it is started by this command, but on Windows platforms , is not started as a service. On this system, it stops if you log off. To avoid this happening, either remain logged on, or change the startup status of the queue manager service (described in Creating a Configuration Manager). (If you lock your workstation, the queue manager does not stop.)
Use the startcomponent command to start a broker or User Name Server when its controller (control process) is already running.
The broker consists of a controller and the component (broker or User Name Server). When the controller address space is started, this causes the component to start automatically. This behavior can be changed by an optional start parameter in the started task. If the parameter is set to MAN, the component does not start automatically; the default is AUTO.
Issuing commands against the controller means issuing start, stop, or modify commands from the console to the controller address space. There are two scenarios using this command. The first is that the controller is started with the parameter MAN instead of AUTO. The second is that, after a stopcomponent command, the component has to be restarted.
On Windows platforms, the user ID used to invoke this command must have Administrator authority on the local system.
On UNIX platforms, the user ID used to invoke this command must either be root or must be the same as that specified in the -i parameter when the component is created. It must also be a member of the mqbrkrs and mqm groups.
When the Windows service for your platform or UNIX daemon is started, it runs under the user ID specified by the -i flag on the appropriatemqsicreatexxxx command. The component only starts if the ServiceUserID specified is authorized to access the home directory (where WebSphere Business Integration Message Broker has been installed), and the working directory (if specified by the -w flag on the mqsicreatexxxx command).
The security requirements for using this command are summarized in Security requirements for Windows platforms and Security requirements for UNIX platforms.
mqsistart WBRK_BROKER
Related reference
Syntax preference
mqsistop command
Notices |
Trademarks |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
an07230_ |