If you choose to create the queue manager separately, set up a dead letter queue (DLQ). The DLQ is referenced by WebSphere Business Integration Event Broker when errors occur processing messages in message flows.
If a message in either a user-defined message flow or in the publish/subscribe model cannot be processed, it is routed to this DLQ as a last resort. If you would prefer the message to be backed out onto the input queue, effectively halting the message flow until the problem is resolved, disable the DLQ.
The mqsideleteusernameserver command does not delete this queue (unless the queue manager is deleted).
If you are using a WebSphere MQ queue manager that has been created independently of the mqsicreateusernameserver command, you can define clusters. This simplifies your configuration.
If the queue manager is created by this command, it is not started as a Windows service; it stops if you log off. To avoid this happening, either remain logged on, or change the start up status of the queue manager service. (If you lock your workstation, the WebSphere MQ queue manager does not stop.)
On z/OS the functionality of this command is not the same as that on the Windows platforms or UNIX platforms because no WebSphere MQ related definitions are performed.
On z/OS, this command must run in a C locale. Any messages produced are in English, regardless of the user's current locale.
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 Event Broker has been installed).
The security requirements for the ServiceUserID are detailed in Security requirements for Windows platforms for Windows platforms and in Security requirements for UNIX platforms for UNIX platforms.
On Windows platforms and UNIX platforms, if the queue manager does not already exist, it is created by this command. It is not created as the default queue manager: if you want it to be the default queue manager on this system, you must create the queue manager before you issue this command.
The queue manager attribute MAXMSGL (maximum length of messages that can be put to queues) is updated to 100 MB. This is done whether or not the queue manager is created by this command.
Two samples, password.dat and pwgroup.dat, are provided in the examples/auth directory under the product home directory.
Access authority is granted for the WebSphere Business Integration Event Broker group mqbrkrs to all these queues.
mqsicreateusernameserver -i wbrkuid -a wbrkpw -q WBRK_QM -r 1000
Related concepts
User Name Server
Related tasks
Creating a User Name Server
Related reference
Syntax preference
mqsichangeusernameserver command
mqsideleteusernameserver command
Notices |
Trademarks |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
an07200_ |