mqsichangedbimgr command

Supported platforms

  • Windows

Purpose

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

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.
  • Change the password using the appropriate operating system facilities.
  • Use the mqsichange… commands to update all the broker components that reference this same ServiceUserID and password.
  • Restart all the broker components.
-i ServiceUserID
(Optional) The user ID under which the default database runs. This can be specified in any valid username syntax. On Windows platforms, these are:
  • domain\username
  • \\server\username
  • .\username
  • username

If you use the unqualified form for this user ID (username) on Windows platforms, 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 platforms, it can be a direct or indirect member of the group. The ServiceUserID must also be authorized to access the home directory (where WebSphere Business Integration Message Broker has been installed). The security requirements for the ServiceUserID are detailed in Security requirements for Windows platforms 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