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

Queue Manager

MQDocument(configuration

extraction)

XMLMQDocument(configuration xml format)

XSLMQDocument(xsl stylesheet)

+

Produces browser viewableconfiguration information.

How does it work?

Queue Manager

MQDocument(configuration

extraction)

XMLMQDocument(configuration xml format)

XSLMQDocument(xsl stylesheet)

+

Produces HTML, which can be edited with (for example)

MS Word

Using any XSLT

OR

Queue Manager

MQDocument(configuration

extraction)

XMLMQDocument(configuration xml format)

Produces a difference report for any two configuration files

(for details see screenshot later in this presentation)

OR

Queue Manager

MQDocument(configuration

extraction)

XMLMQDocument(configuration xml format)

MQDocument(difference analyser)

and another or the same Queue manager (after applying some changes)

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:

mqdocument@mqsystems.com

Thank you.

Michael Dag www.mqsystems.com