strmqm (start queue manager)

Start a queue manager.

Purpose

You can use the strmqm command to start a queue manager.

If the queue manager is part of a high availability configuration, it might start on the other appliance if that is identified as the queue manager's preferred appliance. You can use the status command to check which is the queue manager's preferred appliance. See status.

You can use the strmqm command to start a queue manager in the primary role in a disaster recovery configuration. If you use the command to try to start a queue manager in the secondary role, you receive an error message.

Syntax

Read syntax diagramSkip visual syntax diagram strmqm   -c  -e CMDLEVEL=Level  -f  -d Information   -ns  QMgrName

Required parameters

None.

Optional parameters

-c
For an HA queue manager, this option only has an effect if it is used with the -ns option.
Specifies that the queue manager default and system objects are to be reset.
Any non-default values for the queue manager default and system objects are replaced with the default values.
The queue manager is stopped after the default and system objects are reset. After you have reset the default and system objects for the queue manager, you must use the strmqm command again to start the queue manager.
If you run mq strmqm -c on a queue manager that is being used as a IBM® MQ Managed File Transfer coordination queue manager, you must rerun the MQSC script that defines the coordination queue manager objects. This script is in a file called queue_manager_name.mqsc, which is in the IBM MQ Managed File Transfer configuration directory.
-d Information
For an HA queue manager, this option only has an effect if it is used with the -ns option.
Specifies whether information messages are displayed.
You can specify one of the following values for Information:
all
All information messages are displayed.
minimal
The minimal number of information messages are displayed
none
No information messages are displayed.
The default value is all.
-e CMDLEVEL=Level
For an HA queue manager, this option only has an effect if it is used with the -ns option.
Specifies which command level is enabled for the queue manager.
The queue manager is stopped after the command level is set. After you set the command level for the queue manager, you must use the mq strmqm command again to start the queue manager.
You must specify a command level that is greater than the current command level of the queue manager and less than or equal to the maximum command level supported by the IBM MQ Appliance.
This flag cannot be specified with -c.
-f
For an HA queue manager, this option only has an effect if it is used with the -ns option.
Specifies that the queue manager data directory is to be re-created and file permissions are to be reset.
Use this option if you know that a queue manager is not starting because its data directories are missing or corrupted.
If the command is successful, the queue manager starts. If the queue manager fails to start because the configuration information is missing, re-create the configuration information, and restart the queue manager.
You must not use this parameter to re-create the queue manager data directories if you can restore the directories by correcting the configuration. However, you must use this parameter to re-create the queue manager data directory if you are performing media recovery for a queue manager.
-ns
Specifies that the channel initiator, the command server, the listeners, and the services are not started automatically when the queue manager starts. Also specifies that a high availability system does not start; you can use this option together with the -c option to reset the HA queue manager without starting it. (If you start a queue manager that is normally part of an HA configuration, the queue manager starts on the issuing appliance, even if it is not the preferred location. If that appliance subsequently fails, the queue manager will not fail over to the other appliance in the HA group.)
QMgrName
Specifies the name of the queue manager to start.
The default value is the default queue manager.

Usage notes

  • This command must be run from the IBM MQ administration mode. If the system is in the IBM MQ administration mode the prompt includes mqa(mqcli)#. To enter the IBM MQ administration mode, enter mqcli on the command line. To exit the IBM MQ administration mode, enter exit on the command line.
  • The strmqm command is not required to start a newly-created HA queue manager. An HA queue manager is started automatically on creation.
  • The strmqm command is required to restart a stopped HA queue manager. In this case, the queue manager is started on the appliance that is the preferred location for the queue manager, regardless of which appliance the command is issued on. If the HA preferred location is not set, the queue manager starts on the same appliance that it stopped on.
  • For more information about creating and activating a backup queue manager, see Backing up and restoring WebSphere MQ queue manager data in the IBM MQ documentation.
  • For more information about this command in IBM MQ, see strmqm in the IBM MQ documentation.

Examples

  • The following command starts the queue manager QM1: 
    strmqm QM1
  • The following command resets the HA queue manager HAQM1 without starting it on the issuing appliance:
    strmqm -cns HAQM1

Related commands