mqsicreateusernameserver command

Supported platforms

Purpose

The mqsicreateusernameserver command:
  • Creates a WebSphere MQ queue manager, except on z/OS, if one does not already exist.
    1. If a WebSphere MQ queue manager is created as a result of using the mqsicreateusernameserver command, the default DLQ provided by WebSphere MQ (SYSTEM.DEAD.LETTER.QUEUE) is automatically enabled. The security settings are the same as those of other broker-specific WebSphere MQ queues.

      If you choose to create the queue manager separately, set up a dead letter queue (DLQ). The DLQ is referenced by WebSphere Message 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).

    2. 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.

  • Starts the WebSphere MQ queue manager, if this is not already running.

    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.)

  • Creates the User Name Server-specific WebSphere MQ queues, if these do not already exist.
  • On Windows, installs a service under which the User Name Server runs.
  • Creates a record for the component in the broker registry.
On z/OS, this command:
  • Creates a WebSphere MQ queue manager, if one does not already exist.
  • Creates the User Name Server-specific WebSphere MQ queues, if these do not already exist.
  • Creates a record for the component in the broker registry.
Start of changeSelect the appropriate link for details of this command on the platform, or platforms, that your enterprise uses: End of change
Related concepts
User Name Server