Analyze WebSphere for MQ Data

Using the Product in a WebSphere for MQ Environment › Analyze WebSphere for MQ Data

Analyze WebSphere for MQ Data

To analyze WebSphere for MQ data, no setup is required. If WebSphere for MQ is running, CA MAT discovers it and begins collecting statistical data. Begin your monitoring session from the DelayView or DataView panel. You can also begin your monitoring session from TranView to DelayView Detail to Queue Manager Activity.

CA MAT -------------------------- DelayView --------------- Row 5 to 17 of 17 COMMAND ===> SCROLL ===> HALF Primary commands: DETail on/off Module: * Profile: ASFDFD ADDHelp Csect: * Options: NORMAL Offset: * Detail: ON Line commands: A - Address S - Distribution LC Major category Minor category Actv% Wait% Totl% Visual ____________________ ____________________ ______ ______ ______ __________ ------------------------------------------------------------------------------ __ MQSeries Delay MQSeries Delay 0.00 5.50 5.50 > __ Other Delays Unknown wait type 0.00 2.12 2.12 __ Voluntary Wait Stimer SVC 1.41 0.00 1.41 __ Program Load Delay Load SVC 0.00 1.14 1.14 __ System Active Storage management 0.96 0.00 0.96 __ System Active Regmain SVC 0.73 0.00 0.73 __ System Active Getmain 120 SVC 0.73 0.00 0.73 __ System Active PC-Time service 0.35 0.00 0.35 __ Resource Conflict Enq SVC 0.23 0.00 0.23 __ Abend Proc Delays Sdump SVC 0.08 0.00 0.08 __ Resource Conflict Global Serialization 0.08 0.00 0.08 __ System Active System trace 0.08 0.00 0.08 __ System Active Stae SVC 0.03 0.00 0.03

Follow these steps:

Select MQSeries Delay and press Enter.

The Queue Manager Activity panel displays.

This panel shows the transaction field only if it is from the DelayView Detail screen.

CA MAT ------------- Queue Manager Activity ----------------- Row 1 to 1 of 1 COMMAND ===> SCROLL ===> HALF Transaction: MVGT Profile: ASFDFD Options: NORMAL Line commands: S - Queue Activity C - Code Detail I - Queue Manager Information Queue Queue LC Manager Description Actv% Wait% Totl% Visual _______ ________________________________ ______ ______ ______ __________ >----------------------------------------------------------------------------- __ CSQ8 CSQ8, IBM WebSphere MQ for z/OS 0.00 5.50 5.50 =========> ********************************* End of Table *******************************

The Queue Manager Activity panel displays information about WebSphere for MQ calls that are detected by CA MAT. Each row indicates the active and wait time for a specific Queue Manager. A description for each field in the Queue Manager Activity panel follows.

Queue Manager

Four-character subsystem name of the Queue Manager.

Queue Description

Text description of the function or purpose of the Queue Manager.

If the description is truncated, scroll the panel to the right to display the full description.

Enter the I line command beside the Queue Manager’s name to display additional information about a specific Queue Manager.
The Queue Manager Information panel displays.
```
CA MAT ------------ Queue Manager Information ------------ Row 1 to 18 of 18  
COMMAND ===>                                                  SCROLL ===> HALF 
                                                                               
Queue Manager  . . . . . . CSQ8                              Profile: ASFDFD   
                                                             Options: NORMAL   
                                                                               
Queue Manager Identifier . CSQ8.B909215A58FB9560                               
Description  . . . . . . . CSQ8, IBM WebSphere MQ for z/OS - V5.3              
                                                                               
Command Level  . . . . . . 5.3.0           Platform Type . . MQPL_MVS          
Expiry Interval  . . . . . OFF             Platform Name . . SJSE              
Trigger Interval . . . . . 999999999       User ID . . . . .                   
Queue Sharing Group  . . . QSH3            Syncpoint . . . . MQSP_AVAILABLE    
                                                                               
Maximum Handles  . . . . . 256             Max Priority  . . 9                 
Maximum Message Length . . 104857600       Max Uncommitted . 10000             
                                                                               
Queue Names ------------------------------------------------------------------

                                                                               
Command Input  . . . . . . SYSTEM.COMMAND.INPUT                                
Dead Letter  . . . . . . . CSQ8.DEAD.QUEUE                                     
Default XMIT . . . . . . . CSQ8.DEFXMIT.QUEUE                                  
Repository . . . . . . . .                                                    
```
The Queue Manager Information panel provides information about the selected Queue Manager. A description for each field in the Queue Manager Information panel follows.

Queue Manager

Four-character subsystem name of the Queue Manager.

Queue Manager Identifier

Unique internally-generated identifier of the Queue Manager.

Description

Queue Manager description.

Command Level

Level of system control commands supported by the Queue Manager.

Expiry Interval

Interval between scans for expired messages. This value can be either a time interval in seconds (1 to 99,999,999) or OFF

Trigger Interval

Time interval (in milliseconds) that is used to restrict the number of trigger messages.

Queue Sharing Group

Name of the queue-sharing group to which the Queue Manager belongs.

Platform Type

Operating system on which the Queue Manager is running.

Platform Name

Name of the operating system.

User ID

User identification of the intra-group queuing agent.

Syncpoint

Indicates whether the Queue Manager supports units of work and syncpointing with the MQGET, MQPUT, and MQPUT1 calls.

Maximum Handles

Maximum number of open handles that any one task can use concurrently.

Maximum Message Length

Maximum message length in bytes

Maximum Priority

Maximum message priority supported by the Queue Manager.

Maximum Uncommitted Messages

Maximum number of uncommitted messages that can exist within a unit of work.

Command Input

Name of the command input queue defined on the Queue Manager. Users can send commands to this queue.

Dead Letter

Name of a queue defined on the Queue Manager. Messages are sent to this queue if they cannot be routed to their correct destination.

Default XMIT

Name of the transmission queue that transmits messages to remote Queue Managers if no other transmission queue is identified.

Repository

Name of a cluster for which this Queue Manager provides a repository-manager service.

If the Queue Manager provides this service for more than one cluster, Repository Namelist specifies the name of a namelist object that identifies the clusters.

Repository Namelist

Name of a namelist object that contains the names of clusters for which this Queue Manager provides a repository-manager service.

Type C on the COMMAND line.

The CodeView Detail panel displays.

CA MAT ------------------- CodeView Detail ------------------ Row 1 to 1 of 1 COMMAND ===> SCROLL ===> HALF Queue Manager: CSQ8 Request Type: N/A Profile: ASFDFD Queue Name: N/A Options: NORMAL Mode: CSECT Primary commands: MOde Pseudo/Module/Csect/4GL, PSEudo, REGister, ADDHelp Line commands: A - Associate C - Callerid D - Delays N - Long Name I - Info L - Listing S - Distribution H - Histogram NH - Normalized Histogram LC Module Csect Description L C Actv% Wait% Totl% Visual ________ ________ _________________________ _ _ _____ _____ _____ _________ >----------------------------------------------------------------------------- __ CSQBSRV CSQAPRH MQSeries A Y 0.00 5.50 5.50 ========>

Go back to the Queue Manager Activity panel and use the S line command to display the Queue Activity panel.
```
CA MAT --------------------- Queue Activity ----------------- Row 1 to 3 of 3 
COMMAND ===>                                                  SCROLL ===> HALF 
                                                                               
 Queue Manager: CSQ8                                         Profile: ASFDFD   
  Transaction:  MVGT                                         Options: NORMAL   
                                                                               
 Line commands: I - Queue Information  C - Code Detail                         
                                                                               
                                   Queue   Number of
LC Queue Name                      Request Requests  Actv%  Wait%  Totl% Visual
   _______________________________ _______ _________ ______ ______ _____ ______   
>---------------------------------------------------------------------------

__ CAMAT.JRF.QUEUE1                 MQGET          2  0.00  3.13   3.13  ====>
__ CAMAT.JRF.QUEUE1                 MQPUT          8  0.00  2.35   2.35  ===> 
__ CAMAT.JRF.QUEUE1                 MQPUT          6 10.77  0.00  10.77  ===> 
```
The Queue Activity panel shows the detected activity of each queue within a Queue Manager. Each row shows wait and CPU activity for each queue that is used by the application within the selected Queue Manager. This panel shows the transaction field only if it is from TranView to DelayView Detail to Queue Manager Activity to Queue Activity panel.

A description for each field in the Queue Manager Information panel follows.
Queue Name

Name of the message queue. Message queues are used to store messages sent by programs.

Local queues are owned by the local Queue Manager, and remote queues belong to a different Queue Manager.

Queue Request
Function of the API call that was executed:
- MQCONN: Connect to a Queue Manager.
- MQOPEN: Open a message queue for output.
- MQPUT: Put a message in a queue.
- MQCLOSE: Close a queue.
- MQDISC: Disconnect from a Queue Manager.
- MQPUT1: Equivalent to MQOPEN + MQPUT + MQCLOSE.
- MQINQ: Inquire about the properties of an object.
- MQSET: Set properties of an object.
- MQCONNX: Set standard or fastpath bindings.
- MQBEGIN: Begin a unit of work.
- MQCMIT: Commit a unit of work.
- MQBACK: Back out.
- CMT_PREP: IBM® internal function call. Prepare for two phase commit.
- END_THRD: IBM internal function call.
Queue Description

Text description of the function or purpose of the queue.

If the description is truncated, scroll the panel to the right to display the full description.

Number of Requests

Indicates the number of times the 'Queue Name' Queue is accessed by the ‘Queue Request’ MQ Commands MQGET, MQPUT, and MQPUT1 during this monitor run. This field is available only if TUNSSP00 MQICEPT=YES is specified or MODIFY command is used to Install an intercept to a MQ queue manager.

API Type

Application Program Interface type used by the queue to communicate with the Queue Manager

MQI Message Queue Interface

AMI Application Messaging Interface.

AMI Function

Object interface function performed by the AMI call.

Min Msg Length

Indicates the length of the shortest message processed by the 'Queue Name' Queue during this monitor run. This field is available only if TUNSSP00 MQICEPT=YES is specified or MODIFY command is used to Install an intercept to a MQ queue manager.

Max Msg Length

Indicates the length of the longest message processed by the 'Queue Name' Queue during this monitor run. This field is available only if TUNSSP00 MQICEPT=YES is specified or MODIFY command is used to Install an intercept to a MQ queue manager.

Avg Msg Length

Indicates the average length of all messages processed by the 'Queue Name' Queue during this monitor run. This field is available only if TUNSSP00 MQICEPT=YES is specified or MODIFY command is used to Install an intercept to a MQ queue manager.
Type the I line command to display the Queue Information panel.
```
CA MAT -------------------- Queue Information ------------ Row 1 to 21 of 21  
COMMAND ===>                                                  SCROLL ===> HALF 
                                                                               
 Queue Name . CAMAT.JRF.QUEUE1                             Profile: ASFDFD   
Description . CAMAT TESTING                                Options: NORMAL   
                                                                               
Queue Manager . . . . . CSQ8            MQ Release . . . . . 7.0.0             
Request Type  . . . . . MQGET           Min Buffer Length  . 80                
API Type  . . . . . . . MQI             Max Buffer Length  . 250               
Environment . . . . . .                 Avg Buffer Length  . 168               
Language  . . . . . . . not available   Max Message Length . 9999              
Storage Class     . . . DEFAULT         Max Queue Depth  . . 999999999         
                                                                               
Queue Parameters -------------------------------------------------------------

Queue Type  . . . . . . MQQT_LOCAL                                             
Object Type . . . . . . MQOT_Q                                                 
Queue Definition Type . MQQDT_PREDEFINED                                       
Message Persistence . . MQPER_NOT_PERSISTENT                                   
Inhibit Gets  . . . . . MQQA_GET_INHIBITED                                     
Inhibit Puts  . . . . . MQQA_PUT_INHIBITED                                     
Options . . . . . . . . MQGMO_SYNCPOINT                                        
                        MQGMO_NO_WAIT                                          
                        MQGMO_ACCEPT_TRUNCATED_MSG                             
                                                                               
Trigger Information ----------------------------------------------------------

Trigger Control . . . . MQTC_OFF        Trigger Depth  . . . 1                 
Trigger Type  . . . . . MQTT_FIRST                                             
Trigger Data  . . . . .                                           
```
The Queue Information panel displays information about the selected message queue. Message queues are used to store messages that are sent by programs. Local queues are owned by the local Queue Manager, and remote queues belong to a different Queue Manager.A description for each field in the Queue Information panel follows.
Queue Name

Name of local or remote Queue Manager.

Description

Description associated with the message queue.

Queue Manager

Run-time program that manages queues and messages for applications provides the Message Queuing Interface (MQI) for communication with applications application programs invoke functions of the Queue Manager by issuing API calls.

Request Type
Specifies the function of the API call which was executed:
- MQCONN: Connect to a Queue Manager.
- MQOPEN: Open a message queue for output.
- MQPUT: Put a message in a queue.
- MQCLOSE: Close a queue.
- MQDISC: Disconnect from a Queue Manager.
- MQPUT1: Equivalent to MQOPEN + MQPUT + MQCLOSE.
- MQINQ: Inquire properties of an object.
- MQSET: Set properties of an object.
- MQCONNX: Set standard or fastpath bindings.
- MQBEGIN: Begin a unit of work.
- MQCMIT: Commit a unit of work.
- MQBACK: Back out.
- CMT_PREP: IBM internal function call. Prepare for two phase commit.
- END_THRD: IBM internal function call.
API Type
Displays the Application Program Interface type that is used by the queue to communicate with the Queue Manager:
- MQI Message Queue Interface
- AMI Application Messaging Interface
Environment

Displays the environment in which WebSphere for MQ is running.

Language

Displays the specific language.

MQ Release

Displays the release level of WebSphere for MQ.

Min Buffer Length

Indicates the length of the shortest buffer used by the Queue Name’ Queue during this monitor run. This field is available only if TUNSSP00 MQICEPT=YES is specified or MODIFY command is used to Install an intercept to a MQ queue manager.

Max Buffer Length

Indicates the length of the longest buffer used by the ‘Queue Name’ Queue during this monitor run. This field is available only if TUNSSP00 MQICEPT=YES is specified or MODIFY command is used to Install an intercept to a MQ queue manager.

Avg Buffer Length

Indicates the average length of all buffers used by the ‘Queue Name’ Queue during this monitor run. This field is available only if TUNSSP00 MQICEPT=YES is specified or MODIFY command is used to Install an intercept to a MQ queue manager.

Max Message Length

Indicates the length of the longest physical message that can be handled by the Queue Manager.

Max Queue Depth

Indicates the maximum number of messages allowed in the queue.

Queue Type
Provides the specific purpose of the queue:
- MQQT_LOCAL is a queue owned by the Queue Manager to which the application program is connected. It is used to store messages for programs that use the same Queue Manager.
- MQQT_REMOTE is queue owned by a different Queue Manager (the local definition of a remote queue). A remote queue is not a real queue - it is a structure that contains some of the characteristics of a queue that is hosted by a different Queue Manager.
- MQQT_ALIAS are alias queues that are not real queues but definitions. They are used to assign different names to the same physical queue. These aliases allow multiple programs to work with the same queue, accessing it under different names and attributes.
- MQQT_CLUSTER is a local queue that is known throughout a cluster of Queue Managers. Any Queue Manager that belongs to the cluster can send messages to it without the need of a remote definition, or having to define channels to the Queue Manager that owns it.
- MQQT_MODEL is not a real queue. A model queue is a collection of attributes that are used when a dynamic queue is created.
Object Type
Displays the type of object being named in ObjectName. Possible values are as follows:
- MQOT_Q is Queue.
- MQOT_NAMELIST is Namelist.
- MQOT_STORAGE_CLASS is Storage clas.s
- MQOT_Q_MGR is Queue Manager.
- MQOT_CHANNEL is Channel.
- MQOT_AUTH_INFO is Namelist containing the names of authentication-information objects.
- MQOT_CF_STRUC is Coupling-facility structure.
- Queue Definition Type
- indicates how the queue was defined:
- MQQDT_PREDEFINED is a permanent queue created by the system administrator; only the system administrator can delete it.
- MQQDT_PERMANENT_DYNAMIC is a permanent queue that was created by an application issuing an MQOPEN call.
- MQQDT_TEMPORARY_DYNAMIC is a temporary queue that was created by an application issuing an MQOPEN call.
- MQQDT_SHARED_DYNAMIC is a shared queue that was created by an application issuing an MQOPEN call.
Message Persistence
Indicates whether the message survives system failures and Queue Manager restarts:
- MQPER_PERSISTENT The message survives system failures and Queue Manager restarts.
- MQPER_NOT_PERSISTENT The message does not normally survive system failures or Queue Manager restarts. This situation applies even if an intact copy of the message is found during restart.
- MQPER_PERSISTENCE_AS_Q_DEF If the queue is a cluster queue, the persistence of the message is taken from the Persistence attribute defined at the destination Queue Manager that owns the particular instance of the queue on which the message is placed. If the queue is not a cluster queue, the persistence of the message is taken from the Persistence attribute defined at the local Queue Manager, even if the destination Queue Manager is remote.
Inhibit Get
Controls whether GET operations for this queue are allowed:
- MQQA_GET_INHIBITED GET operations are inhibited.
- MQQA_GET_ALLOWED GET operations are allowed.
Inhibit Puts
Controls whether PUT operations for this queue are allowed:
- MQQA_PUT_INHIBITED PUT operations are inhibited.
- MQQA_PUT_ALLOWED PUT operations are allowed.
Trigger Control
Controls whether trigger messages are written to an initiation queue, in order to cause an application to be started to service the queue:
- MQTC_OFF - Trigger messages are not required. No trigger messages are to be written for this queue.
- MQTC_ON - Trigger messages are to be written for this queue when the appropriate trigger events occur.
Trigger Type
Controls the conditions under which trigger messages are written as a result of messages arriving on this queue:
- MQTT_NONE - No trigger messages are written as a result of messages on this queue.
- MQTT_FIRST - A trigger message is written whenever the number of messages of trigger priority or greater on the queue changes from 0 to 1.
- MQTT_EVERY - A trigger message is written for every message.
- MQTT_DEPTH - A trigger message is written whenever the number of messages of trigger priority or greater on the queue equals or exceeds the defined trigger depth.
Trigger Data

Displays the free-format data that the Queue Manager inserts into the trigger message when a message arriving on this queue causes a trigger message to be written to the initiation queue.

Trigger Depth

Displays the number of messages of trigger priority or greater that must be on the queue before a trigger message is written.

AMI Application

Specifies the application which initiated the AMI call.

AMI Function

Specifies the object interface function performed by the AMI call.

AMI Policy Name

Specifies the name of the AMI policy in use . Policy controls how AMI functions operate.

AMI Service Name

Specifies the name of the pre-defined Service, which defines numerous default AMI parameters.

Type C to display the CodeView Detail panel for the selected queue.

CA MAT ------------------- CodeView Detail ------------------ Row 1 to 1 of 1 COMMAND ===> SCROLL ===> HALF Queue Manager: CSQ8 Request Type: MQGET Profile: ASFDFD Queue Name: CAMAT.JRF.QUEUE1 Options: NORMAL Mode: CSECT Primary commands: MOde Pseudo/Module/Csect/4GL, PSEudo, REGister, ADDHelp Line commands: A - Associate C - Callerid D - Delays N - Long Name I - Info L - Listing S - Distribution H - Histogram NH - Normalized Histogram LC Module Csect Description L C Actv% Wait% Totl% Visual ________ ________ _________________________ _ _ _____ _____ _____ _________ >----------------------------------------------------------------------------- __ CSQBSRV CSQAPRH MQSeries A Y 0.00 3.13 3.13 =========>

Type C again to display the Callerid Detail panel.

CA MAT ------------------- Callerid Detail ------------------ Row 1 to 1 of 1 COMMAND ===> SCROLL ===> HALF Queue Manager: CSQ8 Request Type: MQGET Profile: ASFDFD Queue Name: CAMAT.JRF.QUEUE1 Module: CSQBSRV Csect: CSQAPRH Primary commands: REGister, ADDHelp Line commands: L - Listing A - Associate I - Module/Csect Information LC Module Csect Offset Stmt Csect Description Pct Visual ________ ________ ________ _____ _________________________ _____ __________ >----------------------------------------------------------------------------- __ CSQ4BAP1 CSQ4BAP1 00000810 2245 MQSeries 3.13 =========>

This field is available only if TUNSSP00 MQICEPT=YES is specified or MODIFY command is used to Install an intercept to a MQ queue manager.