Home

 

strmqm (start queue manager)

 

 

Purpose

Use the strmqm command to start a local queue manager.

If the queue manager start up takes more than a few seconds WebSphere MQ will show intermittent messages detailing the start up progress. For more information on these messages see WebSphere MQ Messages.

 

Syntax

>>-strmqm--+-----------------+--+------------------+------------>
           +- -c --+-------+-+  '- -d--Information-'   
           |       '- -ns -' |                         
           +- -r ------------+                         
           '- -a ------------'                         

>--+------+--+----------+--------------------------------------><
   '- -z -'  '-QMgrName-'   

 

Optional parameters

-c

Starts the queue manager, redefines the default and system objects, then stops the queue manager. (Use the crtmqm command to create the default and system objects for a queue manager.) Any existing system and default objects belonging to the queue manager are replaced if you specify this flag.

-ns

Prevents any of the following processes from starting automatically when the queue manager starts:

• The channel initiator

• The command server

• Listeners

• Services

-r

Updates the backup queue manager. The backup queue manager is not started.

WebSphere MQ updates the backup queue manager's objects by reading the queue manager log and replaying updates to the object files.

For more information on using backup queue managers, see Backing up and restoring WebSphere MQ.

-a

Activate the specified backup queue manager. The backup queue manager is not started.

Once activated, a backup queue manager can be started using the control command strmqm QMgrName. The requirement to activate a backup queue manager prevents accidental startup.

Once activated, a backup queue manager can no longer be updated.

For more information on using backup queue managers, see Backing up and restoring WebSphere MQ.

-d Information

Specifies whether information messages are displayed. Possible values for Information follow:

	all	All information messages are displayed. This is the default value.
	minimal	The minimal number of information messages are displayed.
	none	No information messages are displayed. This parameter is equivalent to -z.

The -z parameter takes precedence over this parameter.

-z

Suppresses error messages.

This flag is used within WebSphere MQ to suppress unwanted information messages. Because using this flag could result in loss of information, do not use it when entering commands on a command line.

This parameter takes precedence over the -d parameter.

QMgrName

The name of a local queue manager. If omitted, the default queue manager is used.

 

Return codes

0	Queue manager started
3	Queue manager being created
5	Queue manager running
16	Queue manager does not exist
23	Log not available
24	A process that was using the previous instance of the queue manager has not yet disconnected.
49	Queue manager stopping
69	Storage not available
71	Unexpected error
72	Queue manager name error
100	Log location invalid
119	User not authorized to start the queue manager

 

Examples

The following command starts the queue manager account:

strmqm account

 

Related commands

crtmqm	Create a queue manager
dltmqm	Delete a queue manager
endmqm	End a queue manager

 

Parent topic:

The control commands

fa16090_

 

Home