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 mqsideleteconfigmgr command does not delete this queue (unless the queue manager is deleted).
If you run this command again in this situation, and specify the -n parameter, the parameter is ignored because the new database still exists.
If you have installed VisualAge for Java, and selected the WebSphere MQ Connector as part of that installation, ensure that the CLASSPATH entry for VisualAge for Java appears after the CLASSPATH entries for WebSphere MQ for the Windows platform that you are using (server or Java client). This requirement ensures that the Configuration Manager accesses the correct WebSphere MQ classes (not the VisualAge classes) when it is started by the mqsistart command. If the Configuration Manager detects an error in this area, it writes message BIP1004 to the Windows System Event log.
On Linux, UNIX systems and z/OS, this parameter must be the first specified. It is case-sensitive on Linux, UNIX systems and z/OS.
The default name on Windows, if this parameter is not specified, is 'ConfigMgr'.
This parameter can be specified in any valid username syntax for the platform.
The ServiceUserID specified must be a member (either direct or indirect) of the local group mqbrkrs, and must be authorized to access the home directory (where WebSphere Message Broker has been installed), and the working directory (if specified by the -w flag).
The security requirements for the ServiceUserID are
detailed in Security requirements for Windows platforms for Windows, Security requirements for Linux and UNIX platforms for UNIX platforms,
and Security requirements for z/OS for z/OS.
If you use the unqualified
form for the service user ID (username), on
Windows
the operating system searches for the user ID throughout its
domain, starting with the local system. This search might take some time to
complete.
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.
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, 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 update is done whether or not the queue manager is created by this command.
This database must already exist. You do not need to create an ODBC connection for this database, because access is provided by JDBC.
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.
This command changes security privileges for the ServiceUserID; the user ID used to invoke this command must be a member of the Windows Administrators group on this local system.
On UNIX systems, the user ID used to
invoke this command must be a member of the mqbrkrs group.
On
z/OS systems, the user ID used to invoke this command must be a member of
a group that has READ and WRITE access to the component directory.
Access authority is granted for the WebSphere Message Broker group mqbrkrs to all these queues. If the DLQ is enabled, it also has the same authority.
Notices |
Trademarks |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
an23000_ |