mqsisetdbparms command

Supported platforms

  • Windows
  • Linux and UNIX systems
  • z/OS

Purpose

Use the mqsisetdbparms command to associate a specific userid and password with each data source name (DSN) used in the following nodes:
  • Compute
  • Database
  • Filter
  • DataInsert
  • DataDelete
  • DataUpdate
  • Mapping
  • Warehouse
Where the same DSN is used in multiple nodes (referring to the same database instance), the same user Id and password combination is used.

The user ID/password pair is created in the DSN folder under the broker's registry folder.

This command does not run if the broker is running. The broker must be stopped before you run this command.

Note: The mqsisetdbparms command does not apply to the broker databases.

The mqsisetdbparms command allows you to create, alter, or delete the user Id and password pairs.

You cannot use this command to override the broker data source name.

Syntax

Create

Alter

Delete

Parameters

brokername
(Required) The name of the broker for which settings are to be created, altered, or deleted.
-n DataSourceName
(Required) The data source for which the user Id and password pair are to be modified.
-u DataSourceUserId
(Required for Create; Optional for Alter) The user Id to be associated with this data source.
-p DataSourcePassword
(Required for Create and Alter) The password to be associated with this data source.

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

-d
(Required for Delete) Delete the user Id and password pair for this data source from the registry.

Authorization

On Windows systems the user ID used to invoke this command must have Administrator authority on the local system.

On UNIX systems, the user ID used to invoke this command must be a member of the mqbrkrs group.

On z/OS, the user ID used to invoke this command must be a member of a group which has READ and WRITE access to the component directory.

Note: Ensure that the registry is appropriately secured to prevent unauthorized access. mqsisetdbparms is not required for correct operation of the broker. However, if the broker administrator does not assign specific user IDs and passwords to specific data sources, the broker user ID (and password, on Windows and UNIX systems) is used. The password is not stored in clear text in the file system.

Examples

mqsisetdbparms WBRK_BROKER -n MQBroker1 -u MQUserId -p password
mqsisetdbparms WBRK_BROKER -n MQBroker1 -d

On z/OS, put these commands in the JCL member BIPSDBP in the customization data set <hlq>.SBIPPROC, and submit the job.