WebSphere Message Brokers
File: an28030_
Writer: Bill Oppenheimer

Reference topic

This build: July 31, 2007 21:34:05

mqsichangeconfigmgr command - Windows

Syntax

Parameters

ConfigmgrName
(Optional) The name, which is not case sensitive, of the Configuration Manager that you want to change.

The default name on Windows, if this parameter is not specified, is 'ConfigMgr'.

-i ServiceUserID
(Optional) The user ID under which the Windows system service runs. You can only change this value if you also change the password.

This can be specified in any valid user name syntax for the platform. If you use the unqualified form for this user ID (username) on Windows systems, the operating system searches for the user ID throughout its domain, starting with the local system. This search might take some time to complete.

The ServiceUserID specified must be a member (either direct or indirect) of the local group mqbrkrs. The ServiceUserID must also be authorized to access the home directory (where WebSphere Message Broker has been installed), and the working directory (if specified by the mqsicreateconfigmgr -w flag). This ID must also be a member (either direct or indirect) of the local group mqm.

The security requirements for the ServiceUserID are detailed in Security requirements for Windows platforms.

-a ServicePassword
(Optional) The password for the ServiceUserID.

If you created the Configuration Manager to use this user ID and password for database access as well (that is, you provided the same user ID and password for the service user ID using -a ServicePassword and -i ServiceUserID), ensure that you update all instances of the password on this command.

To complete a password change successfully, you must:
  • Stop the Configuration Manager.
  • Change the password using the appropriate operating system facilities.
  • Use this command to update all parameters that reference this same password.
  • Restart the Configuration Manager.

For compatibility with existing systems, you can still specify <password>. However, if you do not specify a password with this parameter when you run the command you are prompted to enter a password during its invocation, and to enter the password a second time to verify that you have entered it correctly.

-p MigrationDataBasePassword
(Optional) The password for the DB2 database that you are migrating.
Ensure that you change all instances of the use of this password. If you have created (or changed) the Configuration Manager to use the same user ID and password for its service user ID as well as its database access, you must update all instances at the same time. See the description of -a for further details.
-s UserNameServerQueueManagerName

(Optional) The name of the WebSphere MQ queue manager that is associated with the User Name Server. If you want to remove topic security, specify an empty string (two double quotation marks, "").

-j MaxJVMHeapSize

(Optional) The maximum Java virtual machine (JVM) heap size, in megabytes. The smallest value that you can set is 64. If you do not set this parameter, the default size of 128 MB is used.

If you want to change other properties, you must delete and recreate the Configuration Manager. If you want to change the DataBaseUserID, see Modifying access to the broker database for instructions.

Examples

mqsichangeconfigmgr CMGR01 -i ADMIN
mqsichangeconfigmgr CMGR01 -s ""
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:34:05

an28030_ This topic's URL is: