Documentation tool for WebSphere

1

• 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

2

• 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

3

• 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

4
How does it work?
Queue Manager
MQDocument (configuration extraction)
MQDocument (configuration xml format)

MQDocument (xsl stylesheet)
Produces browser viewable configuration
information.
5
OR
Queue Manager
MQDocument (configuration extraction)
Using any XSLT
MQDocument (configuration xml format)

MQDocument (xsl stylesheet)
Produces HTML, which can be edited with (for
example) MS Word
6
OR
and another or the same Queue manager
(after applying
some changes)
Queue Manager
Queue Manager
MQDocument (configuration extraction)
MQDocument (configuration extraction)
MQDocument (configuration xml format)
MQDocument (configuration xml format)
MQDocument (difference analyser)
Produces a difference report for any two
configuration files (for details see screenshot
later in this presentation)
7
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.z
ip (these files do not include the source XML
and XSL files!)
Next some screen shots
8
MQDocument class and options
9
MQDocument execution with minimum options
10
Lets make some changes on QMGRA, Take another
(updated) snapshot and see what changed
11
MQDocument execution with named output file
SAMPLE.SNAPSHOT.XML.BAK
12
MQDocument Difference Analyser with options and
execution sample
13

• 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

14
Documentation tool for WebSphere MQ
For more information or request a 30 days free
trial version, contact
mqdocument_at_mqsystems.com Thank
you. Michael Dag
www.mqsystems.com