Transcript Documentation tool for WebSphere® MQ Do you have challenges like… • keeping documentation of your Queue managers up to date • finding changes.

Documentation tool for WebSphere® MQ
Do you have challenges like…
• keeping documentation of your Queue managers up to date
• finding changes in your MQ configuration between now and say 'a week ago'
when all was fine...
• providing read-only access to Queue manager and WebSphere MQ object settings
• providing security setting audit reports about your Queue managers and MQ object
settings
• need to recreate object settings from several MQSC scripts you have used in the
past?
Then MQDocument can help you too, keep reading…
Documentation tool for WebSphere® MQ
• runs natively on Windows, Linux, AIX, Solaris, HP-UX and iOS (in QSH mode)
• collects WebSphere MQ configuration information and
• Access Control Information
• does not require command server, re-uses runmqsc and amqoamd
• can be run as a WebSphere MQ Service (including a scheduling)
• can use MS03 SAVEQMGR or MAKEDEF (for z/OS) output
or any MQSC script you have written in the past… as input
• can run in Client mode using MO72 MQSC Client to access other platforms like
• system z (z/OS)
• system i (iOS natively if no QSH mode is available)
• or any other platform supported by MO72 MQSC Client
• can analyse differences between any two configurations
Documentation tool for WebSphere® MQ
• adds browser based configuration viewing
• uses open standards like XML and XSL, so you can easily change the look and
feel to match your (corporate) needs
• using any XSLT engine you can produce HTML, which can be edited with (for
example) MS Word, making it easy to incorporate the generated configuration tables
into your documentation
• allows you to audit your WebSphere® MQ environment, by making the information
available in non-technical formats (unlike MQSC and dspmqaut)
• allows you to merge files from different Queue managers, creating a single
configuration document
How does it work?
Queue Manager
MQDocument
(configuration
extraction)
MQDocument
(configuration
xml format)
XML
+
MQDocument
(xsl stylesheet)
XSL
Produces browser viewable
configuration information.
OR
Queue Manager
MQDocument
(configuration
extraction)
Using any XSLT
MQDocument
(configuration
xml format)
XML
+
MQDocument
(xsl stylesheet)
XSL
Produces HTML, which
can be edited with (for example)
MS Word
OR
and another or the same Queue manager
(after applying some changes)
Queue Manager
Queue Manager
MQDocument
MQDocument
(configuration
extraction)
(configuration
extraction)
MQDocument
(configuration
xml format)
XML
MQDocument
(difference analyser)
Produces a difference report
for any two configuration files
(for details see screenshot
later in this presentation)
MQDocument
(configuration
xml format)
XML
To view the full sample in HTML format,
download SAMPLE.qmgr.html.zip
To view the full sample in MS Word .DOC format,
download SAMPLE.qmgr.msword.zip
(these files do not include the source XML and XSL files!)
Next…
some screen shots
MQDocument class and options
MQDocument execution with minimum options
Let’s make some changes on QMGRA,
Take another (updated) snapshot
and see what changed…
MQDocument execution with named output file
SAMPLE.SNAPSHOT.XML.BAK
MQDocument Difference Analyser with options and execution sample
Documentation tool for WebSphere® MQ
• MQDocument is available in a number of license types, suitable for
• Independent contractors traveling from site to site
• Corporate MQ Administrators
• Enterprise – Named Site / Location
• Enterprise – Named Company
• Enterprise Level System Integrators
• Pricing starts at 99 EUR / 89 GBP / 149 USD
(for Independent Contractors License)
• includes free e-mail (defect) support
• includes free 1.x release updates
Documentation tool for WebSphere® MQ
For more information or request a 30 days free trial version, contact:
[email protected]
Thank you.
Michael Dag
www.mqsystems.com