WMQ Administration
Topics
Introduction
MQSC commands
MQSC commands for queue managers
MQSC commands for Listeners
MQSC commands for Local queues
MQSC commands for Alias queues
Administration using MQ Explorer
Introduction
MQ Administration tasks include creating, alerting , viewing,
starting and stopping process, clusters and queue manager
objects.
Administrations tasks can be executed using MQ explorer ( GUI)
or command prompt.
MQSC commands
MQSC stands for MQSC scripting.
MQSC commands are used to manage queue manager
objects, including queue manager itself, queues, process
definitions, channels, client connection channels,
listeners, services, namelists, cluster and authentication
information objects.
MQSC commands are supplied to queue manager using
command prompt 'runmqsc'
runmqsc
MQSC commands
Runmqsc command can be invoked in three ways.
Verify command
Verify the mqsc commands. But does not run them.
runmqsc -v <queue manager name >
Runmqsc directly
Runs mqsc commands directly on a local queue manger
runmqsc <queue manager name>
Runmqsc indirectly
Runs mqsc commands on a remote queue manger.
runmqsc -w 30 <remote queue manager>
MQSC commands
Runmqsc (Contd)
Following commands are used in runmqsc prompt to administer queue
manager objects.
DEFINE :- To add a new queue manager object.
ALTER :- To modify attribute of a queue manager and queue manager
object.
DISPLAY:- To list the attribute values for a queue manager object.
DELETE :- To remove an existing queue manager object.
To exit from command prompt, 'end' command can be used.
MQSC commands for queue manager
Displaying queue manager attributes
To display queue manager properties on runmqsc prompt, use
following commands.
DISPLAY QMGR
DISPLAY QMGR ALL
To display a specific queue manager attribute, name the attribute.
DISPLAY QMGR QMNAME
This will display name of queue manger.
Modifying the queue manager attribute
To modify attributes of queue manager specified on runmqsc
prompt, use command alter qmgr with the attribute name.
ALTER QMGR DEADQ(<Queue name>)
MQSC commands for Listeners
Listeners are used to specify the ports associated with queue
manager.
Listeners are used to receive connections from remote queue
managers and clients.
Listeners can be defined using DEFINE LISTENER command in
runmqsc
DEFINE LISTENER(<listener name>) +
TRPTYPE(TCP) PORT(<port number>)
eg:- DEFINE LISTENER(LISTENER01) TRPTYPE(TCP) +
PORT (1415)
By default port 1414 will be associated with a queue manager.
MQSC commands for Listeners
Listener can be started using START LISTENER command in
runmqsc prompt.
START LISTENER(<Listener name>)
Listener can be stopped using STOP LISTENER command in
runmqsc prompt.
STOP LISTENER(<Listener name>)
To check status of listener , DISPLAY LSSTATUS command can
be used.
DISPLAY LSSTATUS(<Listener name>)
MQSC commands for local queues
Copying a local queue.
Properties of another queue can be copied by using like attribute in the DEFINE
QLOCAL statement.
Syntax:
DEFINE QLOCAL(<new local queue > ) +
LIKE(<name of a existing local queue>)
Eg:DEFINE QLOCAL(NEWQUEUE) +
LIKE(EXISITINGQUEUE) +
MAXMSGL(1024)
MQSC commands for local queues
List queue attributes
MQSC command DISPLAY QLOCAL with queue name is used to list
the properties of an existing queue.
Properties can selectively displayed by individually specifying them
Syntax:
DISPLAY QLOCAL(<local queue name>)
DISPLAY QLOCAL(<local queue name> ) MAXDEPTH
To list all the local queues defined on queue manager.
DISPLAY QLOCAL(*)
MQSC commands for local queues
Modifying queue attributes
MQSC command ALTER QLOCAL with queue name is used to modify
the properties of an existing local queue.
Also properties to be modified also is required to be specified with
new values.
Eg:ALTER QLOCAL(<local queue name>) +
MAXDEPTH(1024) DESCR('new description')
MQSC commands for local queues
Clearing local queue
MQSC command CLEAR QLOCAL with queue name is used to clear
off all the messages from a local queue.
Before issuing CLEAR QLOCAL statement, it should be confirmed
that no process are connected to queue.
Eg:CLEAR QLOCAL(<local queue name>)
Deletion of a local queue
MQSC command DELETE QLOCAL is used to delete a existing local
queue.
Eg:DELETE QLOCAL(<queue name>)
MQSC commands for Alias queues
An alias queue provides a way of referring to another queue
indirectly.
Creation of alias queue
MQSC command DEFINE QALIAS is used to define a new alias queue
Name of the alias queue name and name of target object which it
should point are mandatory arguments.
DEFINE QALIAS(<queue name>) + TARGQ(<Target object
name>)
Target objects can be a local queue, remote queue or a topic.
List properties of alias queue
Mqsc command DISPLAY QALIAS is used to list the properties of
alias queue.
Eg:-
DISPLAY QALIAS(<alias queue name>
MQSC commands for Alias queues
Modify alias queue
Mqsc command ALTER QALIAS can be used to modify properties of
alias queue.
Eg:ALTER QALIAS(<queue name>) +
GET(DISABLED)
Delete alias queue
Mqsc command DELETE QALIAS can be used to delete a alias queue
eg:-
DELETE QALIAS(<Alias queue name>)
Administration using WMQ explorer
With WMQ explorer we can do following:
Create and delete a queue manager (on your local machine
only).
Start and stop a queue manager (on your local machine
only).
Define, display, and alter the definitions of WebSphere MQ
objects such as queues and channels.
Browse the messages on a queue.
Start and stop a channel.
View status information about a channel, listener, queue, or
service objects.
View queue managers in a cluster.
Check to see which applications, users, or channels have a
particular queue open.
Administration using WMQ explorer
Create a new queue manager cluster using the Create New Cluster
wizard.
Add a queue manager to a cluster using the Add Queue Manager to
Cluster wizard.
Manage the authentication information object, used with Secure Sockets
Layer (SSL) channel security.
Create and delete channel initiators, trigger monitors, and listeners.
Start or stop the command servers, channel initiators, trigger monitors,
and listeners.
Set specific services to start up automatically when a queue manager is
started.
Modify the properties of queue managers.
Change the local default queue manager.
Invoke the ikeyman GUI to manage secure sockets layer (SSL)
certificates, associate certificates with queue managers, and configure
and setup certificate stores (on your local machine only).
Administration using WMQ explorer
Modify the parameters for any service, such as the TCP port number for
a listener, or a channel initiator queue name.
Start or stop the service trace.
Questions??
19
Thank you
20
