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