Introduction of Websphere MQ

Hello everybody, im writing this article since im working for a banking company that uses this middleware software to transfer messages between servers, this messages can be transactions or maybe DB info that needs to be gathered from a Database server and displayed on an application isolated from that database.

IBM's Websphere MQ is a middle-ware application that allows two applications to pass messages back and forth without having to integrate with each-other directly. Websphere MQ is a fairly popular application in the enterprise especially for those running many java based programs.
Today's article is a copy of my personal Websphere MQ cheat sheet. This cheat sheet is geared more from a System Administrators prospective and doesn't touch much on creating or altering queues or channels, but should provide a good head start for those who need to just get something restarted.
This cheat sheet is split into two parts, the first being the Linux command line based commands and the second being the MQ CLI based commands.
Where the command starts with REPLACE will require replacing the information with information from your system


all the below commands should be ran with the MQM user to have the appropiate priviledges, also if you need more information regarding any command please use the IBM's Documentation.

Linux Command Line Commands

Create a Queue Manager
$ crtmqm REPLACE_QMGR_NAME

Delete a Queue Manager
$ dltmqm REPLACE_QMGR_NAME

Start Queue Manager
$ strmqm REPLACE_QMGR_NAME

Stopping Queue Manager
Wait for queue manager to shutdown
$ endmqm -w REPLACE_QMGR_NAME

End Immediately
$ endmqm -i REPLACE_QMGR_NAME

Start Queue Manager (Init Script)
$ service ibm.com-WebSphere_MQ start

Stopping Queue Manager (Init Script)
$ service ibm.com-WebSphere_MQ stop

Start MQ Listener
$ echo "start LISTENER(SYSTEM.DEFAULT.LISTENER.TCP)" | runmqsc
REPLACE_QMGR_NAME

Stop MQ Listener
$ echo "stop LISTENER(SYSTEM.DEFAULT.LISTENER.TCP)" | runmqsc REPLACE_QMGR_NAME

Display Queue Managers & Status
$ dspmq

Set MQ Privileges
Set MQ Privileges By User
$ setmqaut -m REPLACE_QMGR_NAME -t qmgr -p REPLACE_USER REPLACE_PLUS_OR_MINUS_PRIVILEGE

Set MQ Privileges By Groups
$ setmqaut -m REPLACE_QMGR_NAME -t qmgr -g REPLACE_GROUP REPLACE_PLUS_OR_MINUS_PRIVILEGE

Display MQ Privileges
Display MQ Privileges By Users
$ dspmqaut -m REPLACE_QMGR_NAME -t qmgr -p REPLACE_USER
Display MQ Privileges By Groups
$ dspmqaut -m REPLACE_QMGR_NAME -t qmgr -g REPLACE_GROUP

Lookup MQ Error Numbers
$ mqrc REPLACE_ERROR_NUM
MQ Sample Scripts

Pop (GET) Messages off a queue
$ amqsget REPLACE_Q_NAME REPLACE_QMGR_NAME

Browse Messages in a queue
$ amqsbcg REPLACE_Q_NAME REPLACE_QMGR_NAME

Open a Queue for writing
$ amqsput REPLACE_Q_NAME REPLACE_QMGR_NAME

Open Websphere MQ CLI
$ runmqsc REPLACE_QMGR_NAME

Websphere MQ CLI Commands
Start MQ Listener
start LISTENER(SYSTEM.DEFAULT.LISTENER.TCP)

Stop MQ Listener
stop LISTENER(SYSTEM.DEFAULT.LISTENER.TCP)

Disable Channel Authentication
alter qmgr chlauth(disabled)

Display Queues
All Queues
display queue(*)

Specific Queues
display queue(REPLACE_Q_NAME)

Short hand
dis q(REPLACE_Q_NAME)

Display Local Queues only
All Queues
display qlocal(*)

Specific Queue
display qlocal(REPLACE_Q_NAME)
Short hand
dis ql(REPLACE_Q_NAME)

Display Alias Queues only
All Queues
display qalias(*)
Specific Queue
display qalias(REPLACE_Q_NAME)
Short hand
dis qa(REPLACE_Q_NAME)

Display Cluster Queues only
All Queues
display qcluster(*)
Specific Queue
display qcluster(REPLACE_Q_NAME)
Short hand
dis qc(REPLACE_Q_NAME)

Display Channels
All Channels
display channel(*)
Specific Channel
display channel(REPLACE_CHANNEL_NAME)
Short hand
dis channel(REPLACE_CHANNEL_NAME)

Display Channel Status
All Channels
display chstatus(*)
Specific Channel
display chstatus(REPLACE_CHANNEL_NAME)
Short hand
dis chstatus(REPLACE_CHANNEL_NAME)

Display Local Queue Manager Information
display qmgr

Display Cluster Queue Manager Information
display clusqmgr(REPLACE_CLUSQMGR_NAME)

Show number of INPUT and OUTPUT threads open
display qstatus(REPLACE_Q_NAME) IPPROCS OPPROCS

Find Process ID of Processes Accessing Queue
display qstatus(REPLACE_Q_NAME) TYPE(HANDLE) ALL

Refresh Cluster Queue Manager
refresh cluster(REPLACE_CLUSQMGR_NAME)

Start Channel
start channel(REPLACE_CHANNEL_NAME)