Monitoring WebSphere MQ
Monitoring WebSphere MQ
Figures
Tables
About this book
Who this book is for
What we need to know to understand this book
Terms used in this book
How this book is organized
Summary of changes
Changes for this edition (SC34-6593-00)
Book purpose
Constants
Header, COPY, and INCLUDE files
New event types
Message monitoring
Accounting and statistics messages
Real-time monitoring
Structure datatypes
Object attributes
Introduction
An introduction to monitoring WebSphere MQ
Monitoring WebSphere MQ
Approaches to monitoring WebSphere MQ
Event monitoring
Message monitoring
Accounting and statistics messages
Real-time monitoring
Event monitoring
An introduction to instrumentation events
What instrumentation events are
Event notification through event queues
Conditions that cause events
Types of event
Queue manager events
Channel and bridge events
Performance events
Configuration events
Command events
Logger events
Event message data summary
Controlling events
Controlling queue manager events
Controlling channel and bridge events
Controlling performance events
Controlling configuration events
Controlling command events
Controlling logger events
Event queues
When an event queue is unavailable
Using triggered event queues
Format of event messages
Using event monitoring in a WebSphere MQ network
Understanding performance events
What performance events are
Performance event statistics
Understanding queue service interval events
What queue service interval events are
Understanding the service timer
Queue service interval events algorithm
Enabling queue service interval events
Queue service interval events examples
Example 1 (queue service interval events)
What queue service interval events tell you
Example 2 (queue service interval events)
Example 3 (queue service interval events)
Understanding queue depth events
What queue depth events are
Enabling queue depth events
Queue depth events examples
Example 1 (queue depth events)
Example 2 (queue depth events)
Understanding configuration events
What configuration events are
When configuration events are generated
When configuration events are not generated
How configuration events are used
The Refresh Object configuration event
When the configuration event queue is not available
Effects of CMDSCOPE
Understanding command events
What command events are
When command events are generated
When command events are not generated
How command events are used
When the command event queue is not available
Effects of CMDSCOPE
Understanding logger events
What logger events are
When logger events are generated
When logger events are not generated
How logger events are used
When the logger event queue is not available
Event message reference
Event message format
Message descriptor (MQMD) in event messages
Message data in event messages
Event message MQMD (message descriptor)
Event message MQCFH (PCF header)
Event message descriptions
Alias Base Queue Type Error
Event data
Bridge Started
Event data
Bridge Stopped
Event data
Change object
Event data
Channel Activated
Event data
Channel Auto-definition Error
Event data
Channel Auto-definition OK
Event data
Channel Conversion Error
Event data
Channel Not Activated
Event data
Channel SSL Error
Event data
Channel Started
Event data
Channel Stopped
Event data
Channel Stopped By User
Event data
Command
Event data
Create object
Event data
Default Transmission Queue Type Error
Event data
Default Transmission Queue Usage Error
Event data
Delete object
Event data
Get Inhibited
Event data
Logger
Event data
Not Authorized (type 1)
Event data
Not Authorized (type 2)
Event data
Not Authorized (type 3)
Event data
Not Authorized (type 4)
Event data
Put Inhibited
Event data
Queue Depth High
Event data
Queue Depth Low
Event data
Queue Full
Event data
Queue Manager Active
Event data
Queue Manager Not Active
Event data
Queue Service Interval High
Event data
Queue Service Interval OK
Event data
Queue Type Error
Event data
Refresh object
Event data
Remote Queue Name Error
Event data
Transmission Queue Type Error
Event data
Transmission Queue Usage Error
Event data
Unknown Alias Base Queue
Event data
Unknown Default Transmission Queue
Event data
Unknown Object Name
Event data
Unknown Remote Queue Manager
Event data
Unknown Transmission Queue
Event data
Example of using instrumentation events
Message monitoring
An introduction to message monitoring
Activities and operations
How activities are used
How to determine a message route
Comparing activity recording and trace-route messaging
The WebSphere MQ display route application
Approaches to message monitoring
Message route completeness
How activity information is stored
Activity recording
An introduction to activity recording
What activity reports are used for
Activity report format
Controlling activity recording
Requesting activity reports for a message
Controlling queue managers for activity recording
Enabling applications for activity recording
Using a common queue for activity reports
Using activity reports
Retrieving further activity reports
Circumstances where activity information is not acquired
Trace-route messaging
An introduction to trace-route messaging
What trace-route messaging is used for
How activity information is recorded
How recorded activity information is acquired
Controlling trace-route messaging
Controlling queue managers for trace-route messaging
Enabling applications for trace-route messaging
Configuring and generating a trace-route message
Mimicking a message
Using the WebSphere MQ display route application
Manual generation
Using a common queue for trace-route reply messages
Acquiring and using recorded information
Trace-route reply messages
Trace-route messages
Activity reports
Circumstances where activity information is not acquired
Recording additional information
Examples of recording additional information
WebSphere MQ display route application
An introduction to the WebSphere MQ display route application
Using the WebSphere MQ display route application
Generating trace-route messages
Displaying activity information
Displaying additional information
Examples of using the WebSphere MQ display route application
Example 1 - Requesting activity reports
Example 2 - Requesting a trace-route reply message
Example 3 - Delivering activity reports to the system queue
Example 4 - Diagnosing a channel problem
Activity report reference
Activity report format
Activity report MQMD (message descriptor)
Activity report MQEPH (Embedded PCF header)
Activity report MQCFH (PCF header)
Activity report message data
Operation-specific activity report message data
Trace-route message reference
Trace-route message format
Trace-route message data format
Example of a trace-route message
Trace-route message MQMD (message descriptor)
Trace-route message MQEPH (Embedded PCF header)
Trace-route message MQCFH (PCF header)
Trace-route message data
Trace-route reply message reference
Trace-route reply message format
Trace-route reply message MQMD (message descriptor)
Trace-route reply message MQCFH (PCF header)
Trace-route reply message data
Accounting and statistics messages
Accounting and statistics messages
An introduction to accounting and statistics messages
Accounting messages
Accounting messages types
Controlling accounting messages
Format of accounting messages
Statistics messages
Statistics message types
Controlling statistics messaging
Format of statistics messages
Displaying accounting and statistics information
amqsmon (Display formatted monitoring information)
Accounting and statistics message reference
Accounting and statistics message format
Accounting and statistics message MQMD (message descriptor)
Message data in accounting and statistics messages
Accounting and statistics message MQCFH (PCF header)
Accounting and statistics message data
MQI accounting message data
Accounting message data
Queue accounting message data
Accounting message data
MQI statistics message data
Statistics message data
Queue statistics message data
Statistics message data
Channel statistics message data
Statistics message data
Reference notes
Real-time monitoring
An introduction to real-time monitoring
Real-time monitoring
Controlling real-time monitoring
Examples of controlling real-time monitoring
Displaying queue and channel monitoring data
Examples of displaying monitoring levels
Monitoring Indicator Values
Monitoring queues
Does your application have the queue open?
Are the messages on the queue available?
Is your application getting messages off the queue?
Can the application process messages fast enough?
What about when the current depth is not increasing?
Monitoring channels
Is the channel running?
If the channel has stopped
If the channel is inactive
If the channel is in retry state
If the channel in another state
Is the channel moving messages?
Does a batch take a long time to complete?
Is the network slow?
Is the channel using message retry?
Can the channel process messages fast enough?
Are there exits processing?
Is the network slow?
Is the channel using compression?
Cluster channels
The Windows performance monitor
Appendixes
Appendix A. Structure datatypes
MQCFBS - Byte string parameter
C language declaration (MQCFBS)
COBOL language declaration (MQCFBS)
PL/I language declaration (MQCFBS) (z/OS only)
RPG/ILE language declaration (MQCFBS) (i5/OS only)
System/390 assembler-language declaration (MQCFBS) (z/OS only)
MQCFGR - Group parameter
C language declaration (MQCFGR)
COBOL language declaration (MQCFGR)
PL/I language declaration (MQCFGR) (z/OS and Windows only)
RPG/ILE declaration (MQCFGR) (i5/OS only)
System/390 assembler-language declaration (MQCFGR) (z/OS only)
Visual Basic language declaration (MQCFGR) (Windows only)
MQCFH - PCF header
Language declarations
MQCFIL - Integer list parameter
C language declaration (MQCFIL)
COBOL language declaration (MQCFIL)
PL/I language declaration (MQCFIL)
RPG/ILE declaration (MQCFIL) (i5/OS only)
System/390 assembler-language declaration (MQCFIL)
Visual Basic language declaration (MQCFIL)
MQCFIL64 - 64-bit integer list parameter
C language declaration (MQCFIL64)
COBOL language declaration (MQCFIL64)
PL/I language declaration (MQCFIL64)
RPG/ILE language declaration (MQCFIL64) (i5/OS only)
System/390 assembler-language declaration (MQCFIL64) (z/OS only)
MQCFIN - Integer parameter
C language declaration (MQCFIN)
COBOL language declaration (MQCFIN)
PL/I language declaration (MQCFIN)
RPG/ILE declaration (MQCFIN) (i5/OS only)
System/390 assembler-language declaration (MQCFIN)
Visual Basic language declaration (MQCFIN)
MQCFIN64 - 64-bit integer parameter
C language declaration (MQCFIN64)
COBOL language declaration (MQCFIN64)
PL/I language declaration (MQCFIN64)
RPG/ILE language declaration (MQCFIN64) (i5/OS only)
System/390 assembler-language declaration (MQCFIN64) (z/OS only)
MQCFSL - String list parameter
COBOL language declaration (MQCFSL)
PL/I language declaration (MQCFSL)
RPG/ILE declaration (MQCFSL) (i5/OS only)
System/390 assembler-language declaration (MQCFSL) (z/OS only)
Visual Basic language declaration (MQCFSL) (Windows systems only)
MQCFST - String parameter
C language declaration (MQCFST)
COBOL language declaration (MQCFST)
PL/I language declaration (MQCFST)
RPG/ILE declaration (MQCFST) (i5/OS only)
System/390 assembler-language declaration (MQCFST)
Visual Basic language declaration (MQCFST)
MQEPH - Embedded PCF header
Language declarations
Appendix B. Event data for object attributes
Authentication information attributes
CF structure attributes
Channel attributes
Namelist attributes
Process attributes
Queue attributes
Queue manager attributes
Storage class attributes
Trademarks
Index