This describes how to create the WebSphere® MQ queue manager and queues.
Before you begin
WebSphere MQ must already be installed.
Why and when to perform this task
If you are using WebSphere MQ as an external Java™ Message
Service (JMS) provider, you must create the queue manager and queues.
Steps for this task
- Optional: If you are creating a production system,
plan which disk drives the queue manager will use. The default
locations for both the persistent queue data and the WebSphere MQ logs is
the WebSphere MQ installation directory. Using the default locations has a
negative impact on the performance of the queue manager. Before creating the
queue manager, change the path to the log file to refer to another disk drive.
- If you are not creating a WebSphere cluster setup, perform the
following actions:
- Make sure that your user ID has the authority to create WebSphere MQ
queues.
- Create the queue manager and queues: On Windows® platforms,
enter:
cd install_root\ProcessChoreographer
createQueues.bat queueManager
On UNIX® and Linux® platforms,
enter:cd install_root/ProcessChoreographer
createQueues.sh queueManager
where queueManager is
the name of an existing queue manager, or the name to give to a new queue
manager. If the named queue manager already exists, it is used to create the
queues. If the queue manager does not exist, it is created and started before
the default queues are created.
- If you are creating a WebSphere cluster setup that uses
a WebSphere MQ
cluster, only perform Creating clustered
queue managers and queues.
- If you are creating a WebSphere cluster setup that uses
a central queue manager, perform the following actions:
- Copy the create queues script file from the ProcessChoreographer subdirectory
of the install_root directory on the server that hosts WebSphere Process
Server machine to the server that hosts the central queue manager:
- If your central queue manager is on a Windows workstation, copy the file: createQueues.bat
- If your central queue manager is on a UNIX or Linux server, copy the file: createQueues.sh
- On the server that hosts the queue manager, make sure that WebSphere MQ
is installed, and that your user ID has the authority to create WebSphere MQ
queues.
- Create the queue manager and queues: On Windows platforms,
enter:
cd install_root\ProcessChoreographer
createQueues.bat queueManager
On UNIX and Linux platforms,
enter:cd install_root/ProcessChoreographer
createQueues.sh queueManager
where queueManager is
the name to give the new queue manager.
- Add a listener for the new queue manager by entering the command:
runmqlsr -t tcp -p port -m queueManager
Where port is
the port on which the listener listens.
Result
The queue manager and queues exist.
What to do next
Continue configuring
in the
parent topic at step
3.