mqsichangeconfigmgr command

Supported platforms

  • Windows 2000, Windows XP

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

Parameters

-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, either you omitted the configuration repository access parameters -u DataBaseUserID and -p DataBasePassword, or you included them but 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.
-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 Windows system username syntax:

  • domain\username
  • \\server\username
  • .\username
  • username

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 Business Integration Event 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.

-p DataBasePassword
(Optional) The password for the user ID with which the configuration repository database is to be accessed.

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, "").
-d SecurityDomainName
(Optional) This parameter must be set to null. If you specified a value for the SecurityDomainName when you created the configuration manager, you must specify -d "".
-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.
Start of change-l 2 or 0End of change
Start of change(Optional) This parameter sets the level of windows domain awareness for the configuration manager. The following values can be specified and your choice depends on your Windows user ID configuration:
2
Domain awareness is enabled. The Configuration Manager tries to resolve any domain information contained in the user ID attempting to access the Configuration Manager. Refer to Considering security for the workbench for more information on this option.
0
Domain awareness is not enabled. The Configuration Manager ignores domain information and resolves user IDs on the local system only.
End of change

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 -d WBRK_DOMAIN
mqsichangeconfigmgr -s ""
Related concepts
Configuration Manager