mqsichangedbimgr command

Supported platforms

  • Windows

Purpose

The mqsichangedbimgr command updates the Windows service that runs the Derby Network Server, with a new user password, a new user ID, or both.

Syntax

Windows platforms

Parameters

-a ServicePassword
(Required) The new password for the ServiceUserID. To complete a password change successfully, you must:
  • Stop all the broker components using the mqsistop command.
  • Change the password using the appropriate Windows facilities.
  • Use the appropriate mqsichange commands to update all the components that reference this same ServiceUserID and password.
  • Restart all the broker components using the mqsistart command.
-i ServiceUserID
(Optional) The user ID under which the default database runs. This can be specified in any valid username syntax. On Windows systems, these are:
  • 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. On Windows systems, it can be a direct or indirect member of the group. The ServiceUserID must also be authorized to access the home directory (where WebSphere Message Broker has been installed). The security requirements for the ServiceUserID are detailed in Security requirements for Windows platforms.

Authorization

The user ID used to invoke this command must have Administrator authority on the local system and be part of the mqbrkrs group.

Responses

This command returns the following responses:

  • BIP8071 Successful command completion.
  • BIP9810 The IBM MQSeries Brokers DatabaseInstanceMgr service was not found.

Examples

The following example changes the password used for the IBM MQSeries Brokers DatabaseInstanceMgr service:
mqsichangedbimgr -a wbrkpw1