mqsichangeconfigmgr command

Supported platforms

Purpose

Use the mqsichangeconfigmgr command to change some of the properties of the Configuration Manager.

You must stop the Configuration Manager, using mqsistop, (see mqsistop command).

When you restart the Configuration Manager, using mqsistart, (see mqsistart command), it uses the changed parameters.

Syntax

Windows

Linux and UNIX systems

z/OS

z/OS console command

Synonym: cc

Parameters

configmgrName
(Optional - Windows. Required - Linux, UNIX systems, and z/OS) The name of the Configuration Manager that you want to change.

On Linux, UNIX systems and z/OS, this must be the first parameter specified. It is case-sensitive on Linux, UNIX systems and z/OS.

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

-a ServicePassword
(Optional - Windows platforms, Linux and UNIX systems only) 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.

-i ServiceUserID
(Optional - Windows platforms, Linux and UNIX systems only) 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 username 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 of the local group mqbrkrs. It can be an indirect or direct member of the group. 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 for Windows platforms and Security requirements for Linux and UNIX platforms for UNIX platforms.

-p migrationDataBasePassword
(Optional - Windows platforms, Linux and UNIX systems only) 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 component database access for instructions.

Responses

This command returns the following responses:
  • BIP8012 Unable to connect to system components
  • BIP8013 Component does not exist
  • BIP8018 Component running
  • BIP8021 User ID/password incorrect
  • BIP8022 Invalid user ID/password
  • BIP8023 Password required
  • BIP8030 Unable to modify user ID privileges

Examples

mqsichangeconfigmgr CMGR01 -i ADMIN
mqsichangeconfigmgr CMGR01 -s ""
Related concepts
Configuration Manager