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 MQ 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\config
createQueues.bat queueManager
On UNIX® and Linux® platforms,
enter:cd install_root/ProcessChoreographer/config
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 config subdirectory
of the ProcessChoreographer 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\config
createQueues.bat queueManager
On Linux and UNIX platforms,
enter:cd install_root/ProcessChoreographer/config
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.