Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                

WM 2071 Xstud

Download as pdf or txt
Download as pdf or txt
You are on page 1of 124
At a glance
Powered by AI
The document discusses IBM MQ student exercises and covers topics such as configuring and monitoring queue managers, queues, and channels.

The document provides exercises for students to learn how to administer IBM MQ. It covers topics such as creating and configuring queue managers and queues, implementing triggers, restoring queues, and monitoring performance.

IBM MQ provides accounting, statistics, and online monitoring capabilities. It can collect data on channels, queues and other objects to monitor performance metrics like message rates and sizes.

V9.

cover

IBM Training Front cover


Student Exercises

IBM MQ V8 System Administration (using Windows for labs)


Course code WM207 ERC 1.0

WebSphere Education
Student Exercises

Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business
Machines Corp., registered in many jurisdictions worldwide.
The following are trademarks of International Business Machines Corporation, registered in many
jurisdictions worldwide:
AIX® CICS® FFST™
First Failure Support HACMP™ iSeries®
Technology™
PartnerWorld® QMF™ System i®
System z® Tivoli® WebSphere®
z/OS®
Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.
Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other
countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Java™ and all Java-based trademarks and logos are trademarks or registered trademarks of
Oracle and/or its affiliates.
VMware and the VMware "boxes" logo and design, Virtual SMP and VMotion are registered
trademarks or trademarks (the "Marks") of VMware, Inc. in the United States and/or other
jurisdictions.
Other product and service names might be trademarks of IBM or other companies.

June 2014 edition


The information contained in this document has not been submitted to any formal IBM test and is distributed on an “as is” basis without
any warranty either express or implied. The use of this information or the implementation of any of these techniques is a customer
responsibility and depends on the customer’s ability to evaluate and integrate them into the customer’s operational environment. While
each item may have been reviewed by IBM for accuracy in a specific situation, there is no guarantee that the same or similar results will
result elsewhere. Customers attempting to adapt these techniques to their own environments do so at their own risk.

© Copyright International Business Machines Corporation 2014.


This document may not be reproduced in whole or in part without the prior written permission of IBM.
US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
V9.0
Student Exercises

TOC Contents
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

Exercises description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

Exercise 1. Using commands to create queue managers and queues . . . . . . . . . . . . . . . . 1-1

Exercise 2. Using IBM MQ Explorer to create queue managers and queues . . . . . . . . . . . 2-1

Exercise 3. Using IBM MQ sample programs to test the configuration . . . . . . . . . . . . . . . . 3-1

Exercise 4. Implementing a trigger monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

Exercise 5. Using a media image to restore a queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1

Exercise 6. Running an IBM MQ trace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

Exercise 7. Connecting queue managers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1

Exercise 8. Controlling access to IBM MQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1

Exercise 9. Connecting an IBM MQ client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-1

Exercise 10. Backing up and restoring IBM MQ object definitions . . . . . . . . . . . . . . . . . . 10-1

Exercise 11. Monitoring and configuring IBM MQ for performance . . . . . . . . . . . . . . . . . . 11-1

© Copyright IBM Corp. 2014 Contents iii


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

iv IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

TMK
Trademarks
The reader should recognize that the following terms, which appear in the content of this training
document, are official trademarks of IBM or other companies:
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business
Machines Corp., registered in many jurisdictions worldwide.
The following are trademarks of International Business Machines Corporation, registered in many
jurisdictions worldwide:
AIX® CICS® FFST™
First Failure Support HACMP™ iSeries®
Technology™
PartnerWorld® QMF™ System i®
System z® Tivoli® WebSphere®
z/OS®
Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.
Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other
countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Java™ and all Java-based trademarks and logos are trademarks or registered trademarks of
Oracle and/or its affiliates.
VMware and the VMware "boxes" logo and design, Virtual SMP and VMotion are registered
trademarks or trademarks (the "Marks") of VMware, Inc. in the United States and/or other
jurisdictions.
Other product and service names might be trademarks of IBM or other companies.

© Copyright IBM Corp. 2014 Trademarks v


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

vi IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

pref

© Copyright IBM Corp. 2014 vii


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

viii IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

pref
Exercises description
This course includes the following exercises:
• Exercise 1, Using commands to create queue managers and queues
• Exercise 2, Using IBM MQ Explorer to create queue managers and
queues
• Exercise 3, Using IBM MQ sample programs to test the configuration
• Exercise 4, Implementing a trigger monitor
• Exercise 5, Using a media image to restore a queue
• Exercise 6, Running an IBM MQ trace
• Exercise 7, Connecting queue managers
• Exercise 8, Controlling access to IBM MQ
• Exercise 9, Connecting an IBM MQ client
• Exercise 10, Back up and restore IBM MQ object definitions
• Exercise 11, Monitoring and configuring IBM MQ for performance
In the exercise instructions, you can check off the line before each step as
you complete it to track your progress.
Most exercises include required sections that should always be completed. It
might be necessary to complete these sections before you can start the next
exercise. Some exercises might also include optional sections that you might
want to complete if you have sufficient time and want an extra challenge.
Exercise data that is required for the lab files is in C:\labfiles on Windows
and /usr/labfiles on Linux. There is a separate subdirectory for each lab.
For example, on Windows, the data directory for Exercise 11 is in the
C:\labfiles\Lab11\Data directory. On Linux, the data directory for Exercise
11 is in the /usr/labfiles/Lab11/data directory.
Exercise solutions for lab exercises with a defined solution are provided in a
Solution subdirectory in the lab files directory. For example, on Windows,
the solution script and report for Exercise 1 is in the
C:\labfiles\Lab01\Solution directory. On Linux, the solution for Exercise
1 is in the /usr/labfiles/Lab01/Solution directory.

Linux

If you are using the Linux VMware image, you might receive a message that one or more of the
system resources are set at an unusually low level. In the lab environment, you can ignore these
messages. In a real IBM MQ implementation, you must reconfigure the Linux kernel so that the
system resources are sufficient for your architecture.

© Copyright IBM Corp. 2014 Exercises description ix


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

x IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty
Exercise 1. Using commands to create queue
managers and queues

What this exercise is about


In this exercise, you create a queue manager, start it, and then create
queues. You also create and run an IBM MQ script command file.

What you should be able to do


At the end of this exercise, you should be able to:
• Use IBM MQ commands to create a local queue manager, local queues,
and alias queues
• Use IBM MQ commands to display and alter queue manager and queue
attributes
• Create and run an IBM MQ command file

Introduction
In this exercise, you create and start a queue manager. You then create local
queues and alter queue and queue manager attributes.
You also create a script file of IBM MQ commands and run the command file
from a command.
Finally, you create alias queues and alter the queue attributes.
If you need more help, detailed steps are provided in the “Exercise
Instructions with Hints” section in this exercise.

Requirements
• IBM MQ is installed on the system
• A text editor

© Copyright IBM Corp. 2014 Exercise 1. Using commands to create queue managers and queues 1-1
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Exercise instructions

Step 1: Create and start a queue manager


__ 1. Log on to the VMware image or system with the user name and password that the instructor
provides.
__ 2. Create a queue manager that is named QMC01 as the default queue manager. Use this
queue manager for all steps in this exercise.

Linux

If you are using a Linux lab environment, create the queue manager with user-based authorizations
enabled by adding the -oa user option to the create queue manager command. This queue
manager (QMC01) is used in a security exercise later in this course (Exercise 8) that assumes that
user-based authorizations is enabled on the Linux queue manager. This option and topic are
described in more detail in Unit 10.

__ 3. Start the queue manager.

Step 2: Use the IBM MQ commands interactively


__ 1. Use the control command runmqsc for the following tasks. Enter all the IBM MQ commands
interactively and display the results at the terminal.
__ a. Display all the attributes of the queue manager.
__ b. List the names of all the queues whose names begin with the characters: SYSTEM
__ c. Create a local queue that is named QL.A and replace its default text description.
__ d. Display all the attributes of the queue.
__ e. Change the maximum number of messages that are allowed on the queue to 1000.
__ f. Again, display the queue attributes. Was the modification successful and is the queue
description unchanged?
__ g. Define a second local queue that is named QL.B with a text description.
__ h. Display all the attributes of the local queue QL.B.
__ i. Change the maximum number of messages that are allowed on the QL.B queue to 2000
by using the DEFINE with REPLACE command instead of the ALTER command.
__ j. Display the queue attributes of QL.B. Was the creation of the queue successful and is
there a queue description?
__ 2. Exit the runmqsc mode.

1-2 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty Step 3: Use the IBM MQ commands in a command file


__ 1. Using a text editor such as Notepad on Windows or gedit on Linux, prepare an IBM MQ
command file with the same commands that you entered interactively in Step 2. Name the
file exer1.txt.
__ 2. Process the command file and direct the results to the file that is named report.txt.
__ 3. Open the report.txt file in the text editor and verify that commands completed
successfully.

Step 4: Work with alias queues


__ 1. Create an alias queue that is named QA.A that resolves to your local queue QL.A.
__ 2. Inhibit PUT requests on the alias queue QA.A.
__ 3. Change the local queue QL.B to inhibit PUT requests on your local queue QL.B.
__ 4. Create an alias queue that is name QA.B that resolves to your local queue QL.B.
__ 5. Exit the runmqsc mode.
End of exercise

© Copyright IBM Corp. 2014 Exercise 1. Using commands to create queue managers and queues 1-3
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Exercise instructions with hints

Step 1: Create and start a queue manager


__ 1. Log on to the VMware image or system with the user name and password that the instructor
provides.
__ 2. Open a command window.
__ 3. Create a queue manager that is named QMC01 as the default queue manager. Use this
queue manager for all steps in this exercise.
Type: crtmqm -q QMC01
Note: The queue manager name is case-sensitive.

Linux

If you are using a Linux lab environment, create the queue manager with user-based authorizations
enabled by adding the -oa user option to the create queue manager command. Type:
crtmqm -oa user -q QMC01
This queue manager (QMC01) is used in a security exercise later in this course (Exercise 8) that
assumes that user-based authorizations is enabled on the Linux queue manager. This option and
topic are described in more detail in Unit 10.

__ 4. Start the queue manager. Type: strmqm QMC01

Step 2: Use the IBM MQ control commands interactively


Enter all the IBM MQ commands interactively and display the results at the terminal.
__ 1. Use the control command runmqsc to start MQSC mode and complete the following tasks.
Type: runmqsc QMC01
You see message that the MQSC for the queue manager QMCC01 is starting. You are in
MQSC mode until you enter END. There is no command prompt in MQSC mode.
__ a. Display all the attributes of the queue manager.
Type: DISPLAY QMGR
Note: QMGR is a literal string and is not replaced with your queue manager name.
__ b. List the names of all the queues whose names begin with the characters SYSTEM.
Type: DISPLAY Q(SYSTEM*)
__ c. Create a local queue that is named QL.A. Its definitions include a text description.
Type: DEFINE QL(QL.A) REPLACE DESCR('QL.A TEXT')

1-4 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty __ d. Display all the attributes of the queue and verify that the text entered in the previous step
is the value for the DESC attribute.
Type: DISPLAY QL(QL.A)
__ e. Change the maximum number of messages that are allowed on the queue from 5000
messages to 1000 messages.
Type: ALTER QL(QL.A) MAXDEPTH(1000)
__ f. Display the queue attributes.
Type: DISPLAY QL(QL.A)
Was the modification successful and is the queue description unchanged?
__ g. Define a second local queue that is named QL.B with a text description.
Type: DEFINE QL(QL.B) REPLACE DESCR('QL.B Text')
__ h. Display all the attributes of the queue.
Type: DISPLAY QL(QL.B)
__ i. Change the maximum number of messages that are allowed on the queue to 2000 by
using the commands DEFINE with REPLACE instead of the ALTER command.
Type: DEFINE QL(QL.B) REPLACE MAXDEPTH(2000)
__ j. Display the queue attributes of QL.B.
Type: DISPLAY QL(QL.B)
Was the creation of the queue successful and is there a queue description?
__ 2. Exit the runmqsc mode.
Type: END

Step 3: Use the IBM MQ control commands in a command file


__ 1. Using a text editor such as Notepad on Windows or gedit on Linux, prepare an IBM MQ
command file with the same commands you entered interactively in Step 2. Name the file
exer1.mqsc and save it in your lab files directory.
In the text file, enter the following commands and then save the file.
DIS QMGR
DIS Q(SYSTEM*)
DEF QL(QL.A) REPLACE DESCR('QL.A Text')
DIS QL(QL.A)
ALTER QL(QL.A) MAXDEPTH(1000)
DIS QL(QL.A)
DEF QL(QL.B) REPLACE DESCR('QL.B Text')
DEF QL(QL.B) REPLACE +
MAXDEPTH(2000)
DIS QL(QL.B)

© Copyright IBM Corp. 2014 Exercise 1. Using commands to create queue managers and queues 1-5
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 2. Process the command file and direct the results to a file that is named report.txt.
__ a. In the command window, change directories to your lab files directory that contains the
MQSC file that you created in step 1.
__ b. Run the command file and redirect the output to report.txt.
Type: runmqsc QMC01 < exer1.mqsc > report.txt
__ 3. Using a text editor, open the file that is named report.txt and verify that each command
completed successfully.

Step 4: Work with alias queues


__ 1. Create an alias queue that is named QA.A, which resolves to your local queue QL.A.
Type: runmqsc QMC01
Type: DEF QA(QA.A) TARGET(QL.A)
__ 2. Inhibit PUT requests on the alias queue.
Type: ALTER QA(QA.A) PUT(DISABLED)
__ 3. Change QL.B to inhibit PUTalter requests on your local queue QL.B.
Type: ALTER QL(QL.B) PUT(DISABLED)
__ 4. Create an alias queue that is named QA.B, which resolves to the local queue QL.B.
Type: DEF QA(QA.B) TARGET(QL.B)
__ 5. Exit runmqsc mode.
Type: END
End of exercise

1-6 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty Exercise review and wrap-up


You should now be able to:
• Create and start a queue manager
• Use control commands and MQSC command files to create and modify local queues
• Display attributes of IBM MQ objects
• Change queue attributes and create alias queues

© Copyright IBM Corp. 2014 Exercise 1. Using commands to create queue managers and queues 1-7
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

1-8 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty
Exercise 2. Using IBM MQ Explorer to create
queue managers and queues

What this exercise is about


In this exercise, you use the IBM MQ Explorer to create a queue manager,
start it, and then create queues. You also use create queue manager sets to
simplify the management of many queue managers.

What you should be able to do


At the end of this exercise, you should be able to:
• Use IBM MQ Explorer to create a local queue manager, local queues,
and alias queues
• Use IBM MQ Explorer commands to display and modify queue manager
and queue properties
• Use IBM MQ Explorer to create a queue manager set

Introduction
In this exercise, you use IBM MQ Explorer to create a queue manager. Then,
you create local queues and modify queue properties. Finally, you create
queue manager sets to simplify the management of multiple queue
managers.
If you need more help, detailed steps are provided in the “Exercise
Instructions with Hints” section in this exercise.

Requirements
• IBM MQ and IBM MQ Explorer are installed on the system
• Successful completion of Exercise 1
• A text editor

© Copyright IBM Corp. 2014 Exercise 2. Using IBM MQ Explorer to create queue managers and 2-1
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Exercise instructions

Step 1: Create and a queue manager


__ 1. Start IBM MQ Explorer.
__ 2. Create a queue manager that is named QMC02 that uses a dead-letter queue that is named
QMC02.DLQ and listens on port 1416. Use this queue manager for all steps in this exercise.

Step 2: Create and modify local queues


__ 1. Display the SYSTEM queues for QMC02.
__ 2. Create a local queue that is named QMC02.DLQ.
__ 3. Change the maximum number of uncommitted messages that are allowed on the queue
QMC02.DLQ to 1000.
__ 4. Create another local queue that is named QL.B.
__ 5. Change the default persistence on the local queue QL.B to Persistent.
__ 6. Create an alias queue that is named QA.B that resolves to your local queue QL.B.
__ 7. Inhibit PUT requests on the QA.B alias queue.

Step 3: Create queue manager sets


__ 1. Change the description of the QMC02 queue manager to Production.
__ 2. Create a queue manager set that is named Production and automatically add any queue
managers that have the Description property set to Production.
End of exercise

2-2 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty Exercise instructions with hints

Step 1: Create and a queue manager


__ 1. Start IBM MQ Explorer.

Windows

From the Windows Start menu, click All Programs > IBM WebSphere MQ > WebSphere MQ
(Installation 1).

Linux

In a terminal window, type: strmqcfg

__ 2. Create a queue manager that is named QMC02 that uses a dead-letter queue that is named
QMC02.DLQ and listens on port 1416. Use this queue manager for all the remaining steps
in this exercise.
__ a. Right-click Queue Managers in the MQ Explorer Navigator and then click New > Queue
Manager.
__ b. For the Queue Manager name, enter QMC02. For the Dead-letter queue, enter
QMC02.DLQ. Click Next.
__ c. Accept the default values for logging. Click Next.
__ d. Accept the default values for the configuration options. Click Next.
__ e. On the listener options page, enter 1416 for the Listen on port number. Click Finish.

Step 2: Create and modify local queues


__ 1. Display the SYSTEM queues for QMC02.
__ a. Expand Queue Managers > QMC02 in the Navigator.
__ b. Click Queues under QMC02 in the Navigator.
__ c. In the Queues content view, click the Show System Objects icon.

© Copyright IBM Corp. 2014 Exercise 2. Using IBM MQ Explorer to create queue managers and 2-3
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 2. Create a local queue that is named QMC02.DLQ.


__ a. Right-click Queues under QMC02 in the Navigator and then click New > Local Queue.
__ b. For the queue Name, enter QMC02.DLQ and then click Finish.
__ c. Click OK in the confirmation window.
__ 3. Change the maximum number of uncommitted messages that are allowed on the queue
QMC02.DLQ to 1000.
__ a. In the Queues content view for QMC02, right-click QMC02.DLQ and then click
Properties.
__ b. Click Extended.
__ c. Change the Max queue depth property value to 1000.
__ d. Click Apply and then click OK.

2-4 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty

__ 4. Create another local queue that is named QL.B.


__ a. Right-click Queues under QMC02 in the Navigator and then click New > Local Queue.
__ b. For the queue Name, enter QL.B and then click Finish.
__ c. Click OK in the confirmation window.
__ d. Verify that queue is now listed in the Queues content view.
__ 5. Change the default persistence on the local queue QL.B to Persistent.
__ a. In the Queues content view for QMC02, right-click QL.B and then click Properties.
__ b. On the General page, change the Default persistence property to Persistent.
__ c. Click Apply and then click OK.
__ 6. Create an alias queue that is named QA.B that resolves to your local queue QL.B.
__ a. Right-click Queues under QMC02 in the Navigator and then click New > Alias Queue.
__ b. For the queue Name, enter QA.B and then click Next.
__ c. On the General page, enter QL.B for the Base object property and then click Finish.
__ d. Click OK in the confirmation window.

© Copyright IBM Corp. 2014 Exercise 2. Using IBM MQ Explorer to create queue managers and 2-5
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 7. Inhibit PUT requests on the QA.B alias queue.


__ a. In the Queues content view for QMC02, right-click QA.B and then click Properties.
__ b. On the General page, change the Put messages property to Inhibited.
__ c. Click Apply and then click OK.
__ d. Verify that the Put messages column now contains Inhibited for the queue QA.B.

Step 3: Create queue manager sets


__ 1. Change the description of the QMC02 queue manager to Production.
__ a. In the Navigator, right-click QMC02 and then click Properties.
__ b. On the General properties page, enter Production in the Description field
__ c. Click Apply and then click OK.
__ 2. Create a queue manager set that is named Production and automatically add any queue
managers that have the Description property set to Production.
__ a. Right-click Queue Managers in the Navigator, and then click Sets > New Set.
__ b. For the set Name, enter Production and select Automatic for the set type. Click Next.
__ c. Click Manage Filters to define a new filter that references the queue manager
Description property.
__ d. Click Add in the Manage Filters window.

2-6 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty __ e. In the Add Filter window, enter Production for the Filter Name.
__ f. The first part of the filter currently evaluates all queue managers. This filter should
evaluate all queue managers, so no changes are required to the first filter evaluation.
__ g. You need to add an AND clause to the filter that tests for the text Production in the
queue manager Description property. Select the AND check box, and then click Select.

__ h. In the Select Attribute window, scroll down, select the Description attribute, and then
click OK.
__ i. Complete the AND statement in the filter definition by setting the evaluation option to
equal to and entering Production.

© Copyright IBM Corp. 2014 Exercise 2. Using IBM MQ Explorer to create queue managers and 2-7
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ j. Click OK.
__ k. Click OK in the Manage Filters window.
__ l. In the New Set window, select Production from the list of available filters and then click
Add to move it to the Selected filters pane.

2-8 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty __ m. Click Finish.


__ n. Verify that the Queue Managers folder in the Navigator now contains two sets (All and
Production) and that the queue manager QMC02 is a member of the Production set.
End of exercise

© Copyright IBM Corp. 2014 Exercise 2. Using IBM MQ Explorer to create queue managers and 2-9
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Exercise review and wrap-up


You should now be able to use IBM MQ Explorer to:
• Create a queue manager and modify queue manager properties
• Create local and alias queues and modify queue properties
• Create a queue manager set that uses a custom filter to automatically assign it to the set

2-10 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty
Exercise 3. Using IBM MQ sample programs to
test the configuration

What this exercise is about


In this exercise, you use the IBM MQ sample programs to put, get, and
browse queues by using MQI calls. You also use MQ Explorer and MQ
commands to verify the actions of the sample programs.

What you should be able to do


At the end of this exercise, you should be able to:
• Use IBM MQ sample programs to put messages onto a queue, browse
messages on a queue, and get messages from a queue
• Use IBM MQ Explorer and IBM MQ commands to display queue contents

Introduction
In this exercise, you test the queue manager QMC01 and queues that you
defined in Exercise 1 by using the MQ sample programs and MQ Explorer to
put, get, and browse messages.

Linux

The sample programs are in the samp/bin subdirectory. To run the sample programs, you must
modify the search path in the active window.
To modify your search path, type:
export PATH=$PATH:/opt/mqm/samp/bin/

Windows

The sample programs are in C:\Program Files\IBM\WebSphere MQ\Tools\c\Smaples\Bin64.


The PATH statement is already set. You can start the sample programs from any directory.

The IBM MQ sample programs are run in a command window. The amqsput,
amqsget, and amqsbcg sample programs that are used in this exercise accept
two parameters. The first parameter is required and is the name of a queue.
The second parameter is optional and is the name of a queue manager. If the

© Copyright IBM Corp. 2014 Exercise 3. Using IBM MQ sample programs to test the configuration 3-1
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

second parameter is omitted, the default queue manager is assumed. Both


parameters are case-sensitive.
A brief description of each program is provided.
• The amqsput program connects to the queue manager and opens the
queue. It reads lines of text from the standard input device, generates a
message from each line of text, and puts the messages on the named
queue. After reading a null line or the EOF character from the standard
input device, it closes the queue, and disconnects from the queue
manager. 
The command to start the program is amqsput QName QmgrName, for
example, amqsput Q1 QMC01.
• The amqsget program connects to the queue manager, opens the queue
for input, and gets all the messages from the queue. It writes the text
within the message to the standard output device, waits 15 seconds (60
seconds if there is no message at the start) in case any more messages
are put on the queue. The program then closes the queue and
disconnects from the queue manager. 
The command to start the program is amqsget QName QmgrName, for
example amqsget Q2 QMC01
• The amqsbcg program connects to the queue manager and opens the
queue for browsing. It browses all the messages on the queue and writes
their contents, in both hexadecimal and character format, to the standard
output device. It also returns, in a readable format, the fields in the
message descriptor for each message. It then closes the queue and
disconnects from the queue manager.
The command to start the program is amqsbcg QName QmgrName, for
example amqsbcg Q3 QMC01.
The sample programs require a set of test queues. You can either use your
own queues or run the IBM MQ sample MQSC file amqscos0.tst to create a
set of queues.
To create the IBM MQ sample queues on Windows, type:
runmqsc QManagerName < "C:\Program Files\IBM\WebSphere
MQ\tools\mqsc\samples\amqscos0.tst"
To create the IBM MQ sample queues on Linux, type:
runmqsc QManagerName < /opt/mqm/samp/amqscos0.tst
If you need more help, detailed steps are provided in the “Exercise
Instructions with Hints” section in this exercise.

Requirements
• IBM MQ and IBM MQ Explorer
• Successful completion of Exercise 1

3-2 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty • The sample programs amqsput, amqsbcg, and amqsget


• A text editor

© Copyright IBM Corp. 2014 Exercise 3. Using IBM MQ sample programs to test the configuration 3-3
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Exercise instructions

Step 1: Verify that QMC01 is the default queue manager


__ 1. Open the IBM MQ Explorer if it is not already open.
__ 2. Right-click IBM WebSphere MQ, and then select Properties. The properties for MQ are
displayed.
__ 3. If QMC01 is defined as the default queue manager, click Cancel.
If QMC01 is not the default queue manager, enter QMC01 in the Default queue manager
name field. Click Apply and then click OK.

Step 2: Put, get, and browse messages


__ 1. Create the IBM MQ sample queues.
__ 2. Use a sample program to put two messages on the local queue QL.A.
__ 3. Use MQ Explorer to display the queue contents and browse the messages.
__ 4. Use a sample program to browse the messages on the queue QL.A. Direct the command
results to a file (or pipe to a paging program like more) and view the results.
__ 5. Use a sample program to get the messages from the queue and empty the queue.
__ 6. Use the amqsput sample program to put some messages on QL.A.
__ 7. Show the current depth (CURDEPTH) of QL.A.
__ 8. Define a new local queue that is named QL.X with the attributes of the alias queue QA.A.
Did you get an error? Try to define a new local queue again, but use the attributes of QL.A.
__ 9. Use a sample program or MQ Explorer to put some messages on QL.X.
__ 10. Clear the messages from the local queue QL.A.
__ 11. Clear the messages from the local queue QA.A.
Were you successful? Give the reason why.
__ 12. Delete the local queue QL.X.
Was it successfully deleted? If not, modify the command.

Step 3: Work with alias queues


__ 1. Using MQ Explorer or MQSC, determine whether the PUT messages attribute is enabled
(inhibited) or disabled (allowed) for the alias queue QA.A.
__ 2. If the PUT requests on the alias queue QA.A are allowed, change the queue PUT attribute
to inhibit them.
__ 3. If the PUT requests on the local queue QL.B are allowed, change the queue PUT attribute to
inhibit them.
__ 4. Use a sample program to try to put messages on QL.A, QL.B, QA.A, and QA.B.

3-4 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty __ 5. Change the local queue QL.B to allow PUT requests.


__ 6. Change the alias queue QA.A to allow PUT requests.
__ 7. Use MQ Explorer to clear any messages on the local queues QL.A and QL.B.
End of exercise

© Copyright IBM Corp. 2014 Exercise 3. Using IBM MQ sample programs to test the configuration 3-5
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Exercise instructions with hints

Step 1: Verify that QMC01 is the default queue manager


__ 1. Open the MQ Explorer if it is not already open.
__ 2. Right-click IBM WebSphere MQ, and then select Properties. The properties for MQ are
displayed.
__ 3. If QMC01 is defined as the default queue manager, click Cancel.
If QMC01 is not the default queue manager, enter QMC01 in the Default queue manager
name field. Click Apply and then click OK.

Step 2: Put, get, and browse messages


__ 1. Create the IBM MQ sample queues.
Use one of the following commands that is based on your lab environment:

Windows

runmqsc QMC01 < "C:\Program Files\IBM\Websphere MQ\tools\mqsc\samples\


amqscos0.tst”

Linux

runmqsc QMC01 < /opt/mqm/samp/amqscos0.tst

The sample program should run to completion and you should see the message that “All
valid MQSC commands were processed.”
__ 2. Use a sample program to put two messages on the local queue QL.A.
__ a. Type: amqsput QL.A
The program responds with:
Sample AMQSPUT0 start
target queue is QL.A
__ b. Enter some data and then press Enter. Each line of data that is entered becomes the
data portion of a new MQ message.
__ c. To end the sample program, press Enter on a blank line.

3-6 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty
Troubleshooting

If the program does not run successfully, an MQ reason code is returned.


To interpret the reason code, use the control command mqrc at the C: or $ prompt followed by the
four-digit reason code. For example, type: mqrc 2085

__ 3. Use MQ Explorer to display the queue contents and browse the messages.
__ a. Select the Queue folder under QMC01 in the navigator to display the Queues content
view.
__ b. Right-click QL.A in the Queue contents view for QMC01 and click Browse messages.
The Message Browser list contains one message for every message that you entered
with the amqsput sample program.
__ c. Double-click a message from the list of messages to display its properties.
__ d. Click the Data properties tab to view the message data.
__ e. Click Close to close the Properties window.
__ f. Click Close to close the message browser window.

__ 4. Use a sample program to browse the messages on the queue QL.A. Direct the command
results to a file (or pipe to a UNIX paging program such as more) and view the results.
Type: amqsbcg QL.A > out.txt
If the program does not run successfully, can you determine the reason for the failure?
__ 5. Use a sample program to get the messages from the queue and empty the queue.
Type: amqsget QL.A

© Copyright IBM Corp. 2014 Exercise 3. Using IBM MQ sample programs to test the configuration 3-7
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

The amqsget sample program can take a few seconds to run. It is finished when you see the
message:
no more message
Sample AMQGET0 end
If the program does not run successfully, can you determine the reason for the failure?
__ 6. Use the amqsput sample program to put some more messages on queues QL.A.
__ 7. Show the current depth (CURDEPTH) of QL.A and verify that the messages are on the
queue.
__ a. Open another command window.
__ b. Type: runmqsc QMC01
__ c. Type: DIS Q(Q*) CURDEPTH
__ 8. Define a new local queue that is named QL.X with the attributes of the alias queue QA.A.
In the window with MQSC running, type: DEF QL(QL.X) LIKE(QA.A)
Did you get an error?
Try to define a new local queue again, but use the attributes of the local queue QL.A.
In the MQSC window, type: DEF QL(QL.X) LIKE(QL.A)
__ 9. Use a sample program or MQ Explorer to put some messages on QL.X.
To use the sample program, type amqsput QL.X and then enter some text.
To use MQ Explorer, right-click QL.X in the Queues content view and then click Put Test
Message.
__ 10. Clear the messages from the local queue QL.A.
In the window that is running MQSC, type: CLEAR QL(QL.A)
__ 11. Clear the messages from the local queue QA.A.
In the MQSC window, type: CLEAR QA(QA.A)
Were you successful? Give the reason why.
__ 12. Delete the local queue QL.X.
In the MQSC window, type: DELETE QL(QL.X)
Was it successfully deleted? If not, modify the command clear to purge the queue and then
delete it. Type: DELETE QL(QL.X) PURGE

Step 3: Work with alias queues


__ 1. Using MQ Explorer or MQSC, determine whether the PUT messages attribute is enabled
(inhibited) or disabled (allowed) for the alias queue QA.A.
To use MQ Explorer, click the Queues folder under QMC01 in the Navigator to display the
Queues content view. The Put messages column shows the current state of the PUT
attribute.

3-8 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty 
To use MQSC, type: DIS QA(QA.A)
__ 2. If the PUT requests on the alias queue QA.A are allowed, change the queue PUT attribute
to inhibit them.
In window that is running MQSC, type: ALTER QA(QA.A) PUT(DISABLED)
__ 3. If the PUT requests on the local queue QL.B are allowed, change the queue PUT attribute to
inhibit them.
In window that is running MQSC, type: ALTER QL(QL.B) PUT(DISABLED)
__ 4. Use a sample program to try to put messages on both the alias and local queues.
Run the sample program in the command window.
For QL.A, type: amqsput QL.A
For QA.A, type: amqsput QA.A
For QL.B, type: amqsput QL.B
For QA.B, type: amqsput QA.B
The PUT request for QL.A succeeds but the other requests fail with reason code 2051
because PUT is inhibited. QA.B fails because it is an alias queue for QL.B, which has PUT
inhibited.
__ 5. Change the local queue QL.B to allow PUT requests.
In the MQSC window, type: ALTER QL(QL.B) PUT(ENABLED)
__ 6. Change the alias queue QA.A to allow PUT requests.
In the MQSC window, type: ALTER QA(QA.A) PUT(ENABLED)
__ 7. Use MQ Explorer to clear any messages on the local queues QL.A and QL.B.
__ a. In the Queues content view, right-click QL.A and then click Clear Messages.
__ b. Select Clear will be used using CLEAR command and then click CLEAR.
__ c. Click OK in the verification window.
__ d. Verify that the Current queue depth column value for QL.A is zero.
__ e. If there are any messages on QL.B, repeat steps a - d to clear QL.B.

Note

You must use MQGET instead of CLEAR to empty a queue if:


• Uncommitted messages are on the queue and they were put on the queue under sync
point.
• An application currently has the queue open.

End of exercise

© Copyright IBM Corp. 2014 Exercise 3. Using IBM MQ sample programs to test the configuration 3-9
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Exercise review and wrap-up


You should now be able to:
• Use MQ sample programs to put messages onto a queue, browse messages on a
queue, and get messages from a queue
• Use MQ Explorer and MQSC to display queue contents
• Use MQSC to change a queue to inhibit or allow PUTs
• Use MQ Explorer and MQSC clear and delete queues

3-10 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty
Exercise 4. Implementing a trigger monitor

What this exercise is about


In this exercise, you modify queue parameters to implement triggering. You
define a process object that identifies the MQ “echo” sample program. The
sample program is triggered when a message arrives on a queue. You use
the “request” sample program to send messages to the queue and retrieve
the responses.

What you should be able to do


At the end of this exercise, you should be able to:
• Apply triggering parameters to queues
• Start a trigger monitor
• Test triggering by using IBM MQ sample programs

Introduction
In this exercise, you implement a trigger monitor. You use a sample program
to put request messages on a queue that is enabled for triggering. The
trigger monitor starts the other sample programs and builds the reply
messages.
• amqsreq is run in a command window. The first parameter is the name of
the request queue, the second the queue manager name and the third is
the reply-to queue name.
The command to start the program is amqsreq Qname QmgrName
replyto_qname, for example amqsreq Q1 QMC01 RTQ1.
The program reads lines of text from the standard input device, converts
them to request messages, and then MQPUTs the messages on the
named queue.
When a blank line is entered, the program begins to MQGET the
messages from the reply-to queue and displays those messages on the
standard output device.
• A trigger monitor starts the amqsech program. The program connects to
the queue manager that is named in the structure that is passed to it by
the trigger monitor and then opens the queue that is also named in the
structure. This queue is called the request queue in the description that
follows.
The amqsech program gets a message from the request queue and
creates a message with the same application data as the original

© Copyright IBM Corp. 2014 Exercise 4. Implementing a trigger monitor 4-1


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

message. It puts the new message on the reply-to queue named in the
message descriptor of the original message. The program then gets each
of the remaining messages on the request queue in turn and generates a
reply in the same way. When the request queue is empty, the program
closes the queue and disconnects from the queue manager.
• A trigger monitor starts the amqsinq program. The program connects to
the queue manager, opens the request queue, gets a message from the
queue, and interprets the application data as the name of a queue. The
amqsinq program opens the queue, calls MQINQ to inquire on the values
of three of its attributes, constructs a reply message with the attribute
values, and puts the message on the reply-to queue. The program then
gets each of the remaining messages on the request queue in turn and
generates a reply in the same way. When the request queue is empty, the
program closes the queue and disconnects from the queue manager.
If you need more help, detailed steps are provided in the “Exercise
Instructions with Hints” section in this exercise.

Requirements
• IBM MQ and MQ Explorer
• The sample programs amqsreq, amqsech, and amqsinq
• A text editor
• Successful completion of Exercise 1 and Exercise 3

4-2 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty Exercise instructions

Step 1: Configure the queue manager for triggering


__ 1. Prepare an MQSC command file trig.mqsc to create the following objects on the default
queue manager QMC01.
Use the REPLACE parameter on all relevant MQ commands so that the command file can
be run again if necessary.
__ a. Create an initiation queue that is named QL.INITQ.
__ b. Alter the local queue that is named QL.A to enable triggering. The arrival of the first
message on QL.A triggers the appropriate application. Make sure that the PUT and GET
operations are enabled and clear any messages that might be on the queue from a
previous lab.
__ c. Create a process to identify the application to start. Define the process so that amqsech
is started synchronously with the trigger monitor. Name the process PR.ECHO.
__ d. Create a model queue that is named QM.REPLY. The sample program amqsreq opens
this queue to create a temporary dynamic reply-to queue.
__ 2. Use a runmqsc command to process the command file against QMC01.
Check the results to confirm that all the objects were successfully created. If unsuccessful,
edit and rerun the command file until all the objects are created.
__ 3. Use the runmqtrm command to start the trigger monitor. Specify your queue manager and
the name of the initiation queue.

Step 2: Test triggering


__ 1. Run the amqsreq sample program to put some request messages on the local queue that is
enabled for triggering.
__ 2. Type a message, press Enter.
__ 3. Press Enter again to end the sample program.
__ 4. Observe the trigger monitor that starts the amqsech sample program and the replies that the
amqsreq sample program receives.
__ 5. If triggering did not work, investigate the possible causes.

Step 3: Test triggering with the amqsinq sample program


__ 1. Create a second process object so the trigger monitor starts amqsinq instead of amqsech.
__ 2. Alter the queue QL.A to reference the new process.
__ 3. Run amqsreq again.
Type: amqsreq QL.A QMC## QM.REPLY

© Copyright IBM Corp. 2014 Exercise 4. Implementing a trigger monitor 4-3


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Remember that amqsinq now expects the application data in each message to contain the
name of a queue. For example, you can use the names of the following queues:
SYSTEM.ADMIN.COMMAND.QUEUE
QM.REPLY
SYSTEM.SAMPLE.REPLY
QL.A
__ 4. Verity that the trigger monitor starts amqsinq in the trigger monitor window. In the window
where you entered the request, verify that amqsreq receives the request. The replies consist
of an Inquire on attributes of the named queues
__ 5. Alter the process object so the trigger monitor starts amqsinq as a separate asynchronous
process. 
Run amqsreq again following the directions in Step 4 and verify that the triggered application
opens in a separate window (on Windows) or a background process (on Linux).
__ 6. Stop the trigger monitor (close the trigger monitor window).
__ 7. Clear all the messages on QL.A.
End of exercise

4-4 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty Exercise instructions with hints

Step 1: Configure the queue manager for triggering


__ 1. Prepare an MQSC command file that is named trig.mqsc to create all the following objects
on the default queue manager QMC01.
Use the REPLACE parameter on all relevant MQSC commands so that the command file
can be run again if necessary.
__ a. Create an initiation queue that is named QL.INITQ.
Type: DEFINE QLOCAL(QL.INITQ) REPLACE
__ b. Alter the local queue that is named QL.A to enable triggering. The arrival of the first
message on QL.A triggers the appropriate application. Make sure that the PUT and GET
operations are enabled and clear any messages that might be on the queue from a
previous lab.
Type:
DEFINE QL(QL.A) REPLACE +
TRIGGER TRIGTYPE(FIRST) +
PROCESS(PR.ECHO) INITQ(QL.INITQ)
__ c. Define a process to identify the application to start. Define the process so that amqsech
is started synchronously with the trigger monitor. Name the process PR.ECHO.
Use one of the following commands that are based on your system type:

Windows

DEFINE PROCESS(PR.ECHO) REPLACE + 


APPLICID(‘amqsech')

Linux

DEFINE PROCESS(PR.ECHO) REPLACE + 


APPLICID(‘/opt/mqm/samp/bin/amqsech')

__ d. Define a model queue that is named QM.REPLY. The sample program amqsreq opens
this queue to create a temporary dynamic reply-to queue.
Type: DEFINE QMODEL(QM.REPLY) REPLACE
__ 2. Use runmqsc to process the command file. Open the report in a text editor and verify that all
the objects are successfully created. If unsuccessful, edit and rerun the command file until
all the objects are created.
Type: runmqsc QMC01 < trig.mqsc > trigreport.txt

© Copyright IBM Corp. 2014 Exercise 4. Implementing a trigger monitor 4-5


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 3. Use the runmqtrm control command to start the trigger monitor. Specify your queue
manager and the name of the initiation queue.
Type: runmqtrm -q QL.INITQ -m QMC01
You should see that the trigger monitor program is running and waiting for a message. Do
not close this window.

Step 2: Test triggering


__ 1. Open a new command window and run amqsreq to put some request messages on the local
queue that is enabled for triggering.
Type: amqsreq QL.A QMC01 QM.REPLY

Linux

On Linux, you must modify the search path in the active window. Type:
export PATH=$PATH:/opt/mqm/samp/bin/
You must enter this command in every new command window that you use to run the sample
programs.

__ 2. Type a message, press Enter.


For example, type: Hello this is a message from me
__ 3. Press Enter again to end the sample program.
__ 4. Verify that the amqsreq program started and that you received a response message in the
command window.
The response message is similar to the following message:
response <Hello this is a message from me>
The program continues to run a few seconds and the following message is displayed:
no more replies
Sample QMQSREQ0 end
__ 5. In the trigger monitor window, verify that the amqsech program started and received the
message.
If triggering failed, investigate the possible causes. Was one of the conditions for a trigger
event not satisfied?

Step 3: Test triggering with amqsinq


__ 1. In MQSC, create a second process object on QMC01 so that the trigger monitor starts
amqsinq instead of amqsech.

4-6 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty
Windows

DEFINE PROCESS(PR.INQ) REPLACE +


APPLICID(‘amqsinq')

Linux

DEFINE PROCESS(PR.INQ) REPLACE +


APPLICID(‘/opt/mqm/samp/bin/amqsinq')

__ 2. Alter the queue QL.A to reference the new process.


In MQSC, type: ALTER QL(QL.A) PROCESS(PR.INQ)
__ 3. Run amqsreq again. Remember that amqsinq now expects the application data in each
message to contain the name of a queue. For example, you can use the names of the
following queues:
SYSTEM.ADMIN.COMMAND.QUEUE
QM.REPLY
SYSTEM.SAMPLE.REPLY
QL.A
Type: amqsreq QL.A QMC01 QM.REPLY
Type a valid queue name.
Press Enter again to end the sample program.
__ 4. Verity that the trigger monitor starts amqsinq in the trigger monitor window. In the window
where you entered the request, verify that amqsreq receives the request. The replies consist
of an Inquire on attributes of the named queues.
Your results should appear similar to the following example:
C:\> amqsreq AL.A QMC01 QM.REPLY
Sample AMQSREQ0 start
server queue is QL.A
replies to AMQ.537CB40C021B0220
QL.A

response <QL.A has 0 messages, used by 1 jobs>


no more replies
Sample AMQSREQ0 end

The trigger monitor window should show that amqsinq is the process that started.

© Copyright IBM Corp. 2014 Exercise 4. Implementing a trigger monitor 4-7


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 5. Alter the process object so the trigger monitor starts amqsinq as a separate asynchronous
process.
Type the following commands according to your system type in MQSC for QMC01:

Linux

On UNIX systems, ENVRDATA can be set to the ampersand character to make an application that
is started run in the background. Type:
ALTER PROCESS(PR.INQ) ENVRDATA(‘&')

Windows

ALTER PROCESS(PR.INQ) APPLICID(‘start amqsinq')


<o:p\

__ 6. Run amqsreq again following the directions in Step 4 and verify that the triggered application
opens in a separate window (on Windows) or a background process (on Linux).
__ 7. Stop the trigger monitor (close the trigger monitor window).
__ 8. Use MQSC or MQ Explorer to clear all the messages on QL.A if any exist.
End of exercise

4-8 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty Exercise review and wrap-up


Having completed this exercise, you should be able to:
• Apply triggering parameters to queues
• Start a trigger monitor
• Test triggering by using IBM MQ sample programs

© Copyright IBM Corp. 2014 Exercise 4. Implementing a trigger monitor 4-9


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

4-10 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty
Exercise 5. Using a media image to restore a
queue

What this exercise is about


In this exercise, you capture a media image of a queue, deliberately damage
the queue, and then restore it.

What you should be able to do


At the end of this exercise, you should be able to:
• Capture an object media image
• Re-create an IBM MQ object from an object media image

Introduction
This exercise demonstrates the survival of persistent messages across a
queue manager restart. It also demonstrates how a damaged queue can be
recovered from its media image.
In this exercise, you create a queue manager with a linear log. To
demonstrate media recovery, you then damage a queue. The act of
deliberately damaging a queue should not be done in practice. It is done in
this exercise to simulate a disk failure.
You can use the amqsbcg sample program or MQ Explorer to browse queues.
If you need more help, detailed steps are provided in the “Exercise
Instructions with Hints” section in this exercise.

Requirements
• IBM MQ and MQ Explorer installed on the local system
• Successful completion of Exercise 1 and Exercise 3

© Copyright IBM Corp. 2014 Exercise 5. Using a media image to restore a queue 5-1
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Exercise instructions

Step 1: Queue manager restart


__ 1. To avoid any conflicts or problems, stop the other queue managers.
__ 2. Create a queue manager that is named QML01.
__ 3. Start the QML01 queue manager.
__ 4. Prepare an MQSC command file that is named recover.mqsc that creates the following
objects on QML01.
__ a. Create two local queues that are named QL.A and QL.B.
Set the default persistence of each queue to YES.
__ b. Create two alias queues that are named QA.A and QA.B. QA.A resolves to the local
queue QL.A and QA.B to the queue QL.B.
Set the default persistence of each alias queue to NO.
__ 5. Use runmqsc to process the command file on QML01. Make sure that you specify your
queue manager name.
__ 6. Use the amqsput sample program to put a mixture of persistent and non-persistent
messages on the local queues QL.A and QL.B and alias queues QA.A and QA.B.
When amqsput is started, the value of the DefPersistence attribute of the queue that is first
(explicitly) opened determines whether the message it puts on the queue is persistent or
non-persistent. In respect to the definitions made before amqsput, create persistent
messages on the local queue and non-persistent messages on the alias queue.

Linux

Before you run the MQ sample program on Linux, set the EXPORT in the command window:
export PATH=$PATH:/opt/mqm/samp/bin/

__ 7. Use the MQ Explorer or the sample program amqsbcg to browse the messages on the local
queue QL.A.
Verify that there is a mixture of persistent and non-persistent messages on the queue.
__ 8. Stop and then restart the queue manager QML01.
__ 9. Browse the messages on queue QL.A again.
Check that only the persistent messages are still on the local queue QL.A and that the
restart did not remove them.

Step 2: Media recovery


__ 1. Run rcdmqimg against the queue QL.B to write an image of an object, or group of objects, to
the log for use in media recovery.

5-2 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty __ 2. Locate the file that implements the local queue QL.B within the file system and damage the
queue by deleting the file. This file is called 'q'. The location of the file is specific to the
operating system.
__ 3. Use the MQSC command DISPLAY QUEUE to display the attributes of local queue QL.B.
This action still works because the queue manager does not have to access the queue file
to provide the requested information.
__ 4. Use amqsput to put some messages to local queue QL.B. It might take 10 or more
messages (because of buffering) but the queue manager eventually detects that the queue
is damaged and reports the damage by returning MQRC 2101
(MQRC_OBJECT_DAMAGED).
__ 5. Use the MQSC command DISPLAY QUEUE to display the attributes of local queue QL.B.
The queue manager reports an error now as it recognizes that the queue is damaged.
__ 6. Use the re-create object (rcrmqobj) command to recover local queue QL.B from its media
image.
__ 7. Check that you can now display the attributes of the queue.
__ 8. Browse the local queue QL.B again to check whether the messages are recovered
successfully. What about the non-persistent messages?
__ 9. Clear the messages from the QL.B.
__ 10. Stop and delete the queue manager QML01.
End of exercise

© Copyright IBM Corp. 2014 Exercise 5. Using a media image to restore a queue 5-3
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Exercise instructions with hints

Step 1: Queue manager restart


__ 1. To avoid any conflicts or problems, stop the other queue managers.
Type:
endmqm -i QMC01
endmqm -i QMC02
__ 2. Create a queue manager that is named QML01 with linear logging.
Type: crtmqm -ll QML01
__ 3. Start the queue manager.
Type: strmqm QML01
__ 4. Use a text editor to create an MQSC command file that is named recover.mqsc that
defines the following objects:
__ a. Two local queues that are named QL.A and QL.B. Set the default persistence of each
queue to YES (persistent).
In the command file, type:
DEF QL(QL.A) DEFPSIST(YES) REPLACE
DEF QL(QL.B) DEFPSIST(YES) REPLACE
__ b. Two alias queues that are named QA.A and QA.B.
QA.A resolves to the local queue QL.A and QA.B resolves to the local queue QL.B. Set
the default persistence of each alias queue to NO (not persistent).
In the command file, type:
DEF QA(QA.A) TARGET(QL.A) DEFPSIST(NO) REPLACE
DEF QA(QA.B) TARGET(QL.B) DEFPSIST(NO) REPLACE
__ 5. Use MQSC to process the command file and redirect the output to a report file.
Make sure that you specify the queue manager name in the runmqsc command. Also, you
must specify the path for the recover.mqsc file if the current directory does not contain the
recover.mqsc file.
Type: runmqsc QML01 < recover.mqsc > recoverreport.txt
Review the report file to verify that all commands in the file ran successful.
__ 6. Use the amqsput sample program to put persistent and non-persistent messages on the
local queues QL.A and QL.B and alias queues QA.A and QA.B.

5-4 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty
Linux

Before you run the MQ sample program on Linux, set the EXPORT in the terminal window:
export PATH=$PATH:/opt/mqm/samp/bin/

When the amqsput sample program starts, the value of the DefPersistence attribute of the
queue determines whether the message that is put on the queue is persistent or
non-persistent. Because of the queue definitions you made is step 4, the amqsput sample
program puts persistent messages on the local queues and non-persistent messages on the
alias queues.
Type:
amqsput QL.A QML01
amqsput QA.A QML01
amqsput QL.B QML01
amqsput QA.B QML01
__ 7. Use the MQ Explorer or the sample program amqsbcg to browse the messages on the local
queue QL.A and QL.B and verify that there is a mixture of persistent and non-persistent
messages on it.
To use the sample program, type: amqsbcg QL.A QML01
The sample program returns a record for each message that is on the queue.
- If the message is persistent, the Persistence attribute is 1.
- If the message is not persistent, the Persistence attribute is 0.
To use MQ Explorer, right-click the queue in the Queues content view and then click
Browse Messages. There is a row for each message on the queue. Scroll to the right until
you see the Persistence column and verify that the queue contains both persistent and
non-persistent messages.

Linux

To start MQ Explorer, type: strmqcfg

__ 8. Stop and then restart the queue manager QML01.


Type:
endmqm -i QML01
strmqm QML01
__ 9. Use MQ Explorer or the browse sample program amqsbcg to browse the messages on QL.A
and QL.B again. Check that only the persistent messages on the local queue survived the
restart.

© Copyright IBM Corp. 2014 Exercise 5. Using a media image to restore a queue 5-5
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Step 2: Media recovery


__ 1. Run rcdmqimg against the queue QL.B to write an image of the queue to the log for use in
media recovery.
Type: rcdmqimg -m QML01 -t ql QL.B
__ 2. Locate the file that implements local queue QL.B within the file system. Damage the queue
by deleting the file. The file location is specific to the operating system.

Linux

rm /var/mqm/qmgrs/QML01/queues/QL\!B

Windows

erase “C:\ProgramData\IBM\MQ\qmgrs\QML01\queues\QL!B”
/q

__ 3. Use the DISPLAY QUEUE command in runmqsc to display the attributes of local queue QL.B.
This command still works because it does not yet recognize that the queue is damaged.
Type:
runmqsc QML01
DIS Q(QL.B)
END
__ 4. Use amqsput to put some messages to local queue QL.B. It might take 10 or more
messages (because of buffering) but the queue manager eventually detects that the queue
is damaged and reports the damage by returning MQRC 2101
(MQRC_OBJECT_DAMAGED).
Type: amqsput QL.B QML01
__ 5. Use the DISPLAY QUEUE command in runmqsc to display the attributes of local queue QL.B.
Type:
runmqsc QML01
DIS Q(QL.B)
end
The queue manager now recognizes that a queue is damaged and reports that the MQ
object QL.B is not found.
__ 6. Use the re-create object (rcrmqobj) command to recover local queue QL.B from its media
image.
Type: rcrmqobj -m QML01 -t ql QL.B
You should see a message that indicates that the local queue QL.B was re-created.

5-6 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty __ 7. In runmqsc, check that you can now display the attributes of the queue. Type:
runmqsc QML01
DIS Q(QL.B)
end
__ 8. Use MQ Explorer or the sample program to browse the local queue QL.B to check whether
the messages are recovered successfully.
To use the sample program to browse the queue, type: amqsbcg QL.B QML01
To browse the messages by using MQ Explorer, right-click the QL.B queue in the Queues
content view and then click Browse Messages.
What about the non-persistent messages?
__ 9. Clear the messages from QL.A and QL.B by using a sample program or MQ Explorer.
To clear the messages by using a sample program, type: amqsget QL.B QML01
To clear the messages by using MQ Explorer, right-click the queue in the Queues content
view, click Clear Messages, and then click Clear.
__ 10. Stop and delete the queue manager QML01. It might take 1 or 2 minutes for the queue
manager to be deleted.
Type:
endmqm -i QML01
dltmqm QML01
End of exercise

© Copyright IBM Corp. 2014 Exercise 5. Using a media image to restore a queue 5-7
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Exercise review and wrap-up


Having completed this exercise, you should be able to:
• Create a queue manager with linear logging
• Put persistent and non-persistent messages on local queues
• Stop and restart a queue manager to verify that persistent messages are maintained
during a queue manager restart
• Record a media image
• Recover a damaged local queue from its media image

5-8 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty
Exercise 6. Running an IBM MQ trace

What this exercise is about


In this exercise, you configure and run a trace of message activity on a
specific local queue. Sample programs are used to send and receive
messages from the queue and then the trace results are in the file system
and interpreted. MQ Explorer can also be used to control the trace function.

What you should be able to do


At the end of this exercise, you should be able to:
• Set up an IBM MQ trace
• Analyze the output from a trace

Introduction
The trace function in MQ is used for problem determination or as a program
development aid. Service personnel might request that a scenario is
re-created and traced for solving error or unexpected results. The commands
that are used for controlling trace are:
• strmqtrc to enable tracing. The command has optional parameters that
specify the level of tracing. In this exercise, you use the -m parameter and
the queue manager name to specify the name of the queue manager.
• endmqtrc to end a trace. In this exercise, you use the -m parameter and
queue manager name to specify the name of the queue manager.
• dspmqtrc to format a trace file (UNIX only).

Requirements
• IBM MQ and IBM MQ Explorer.
• The exercise assumes that you defined the queue manager and queues
in Exercise 1 and that you are familiar with the sample programs that
were introduced in Exercise 3.
• The exercise requires sample programs amqsput and amqsget.
On Windows, sample programs can be run from any location within the
file system hierarchy.
On Linux, you must either reference the path when running the sample
program or export the path to the sample directory by entering the
following command:

© Copyright IBM Corp. 2014 Exercise 6. Running an IBM MQ trace 6-1


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

export PATH=$PATH:/opt/mqm/samp/bin/

6-2 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty Exercise instructions

Step 1: Start an MQ trace


__ 1. Start queue manager QMC01 if it is not already running.
__ 2. Using a command or MQ Explorer, start an MQ trace on the MQ amqsput and amqsget
sample programs.

Windows

To start an MQ trace from a command prompt, type:


strmqtrc –m QMC01 -p amqsput.exe,amqsget.exe

Windows

To start an MQ trace from a command prompt, type:


strmqtrc –m QMC01 -p amqsput,amqsget

To use MQ Explorer to start an MQ trace:


1. In the MQ Explorer Navigator view, right-click the IBM WebSphere MQ tree node, and
then click Trace. The Trace dialog box is displayed.
2. Click Start.

Note

When you use MQ Explorer to start a trace, you do not have the option of selecting specific
components to trace. The strmqtrc command allows you to identify specific components.

Step 2: Use the sample programs to put and get messages from a queue
__ 1. Use the amqsput sample program to write some sample messages to the local queue QL.A
on queue manager QMC01.
__ a. From a command prompt, type: amqsput QL.A QMC01
__ b. Enter some messages.
__ c. Press Enter on a blank line to exit the sample program.
__ 2. Use the amqsget sample program to get the messages from the local queue QL.A on queue
manager QMC01.

© Copyright IBM Corp. 2014 Exercise 6. Running an IBM MQ trace 6-3


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

From a command prompt, type the following command:


amqsget QL.A QMC01
__ 3. Stop the MQ trace.
To stop the MQ trace in command window, type:
endmqtrc –m QMC01
To stop the MQ trace in MQ Explorer:
1. In the MQ Explorer Navigator view, right-click the IBM WebSphere MQ, and then click
Trace. The Trace dialog box is displayed.
2. Click Stop.

Step 3: Locate and examine the trace files

Windows

The default trace directory is C:\ProgramData\IBM\MQ\trace


A trace file is created for each process. The trace files are readable without formatting and are
called AMQpppp.0.TRC where pppp is the process identifier (PID) that created the file.
__ 1. Go to the directory C:\ProgramData\IBM\MQ\trace
__ 2. View the trace output files with Notepad and examine the PUT and GET operations.

Linux

Files that are associated with trace are created in a fixed location in the file tree that is
/var/mqm/trace. These files must be formatted before they can be read.
__ 1. Go to the directory /var/mqm/trace
__ 2. From a command line, format the trace files:
Type: dspmqtrc *.TRC
The trace formatter program converts binary files that are named AMQppppp.TRC, where
ppppp is the process identifier (PID) that created the file into readable files that are named
AMQppppp.FMT.
__ 3. View the formatted trace files and examine the PUT and GET operations.

6-4 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty Sample excerpt of a Windows trace file for amqsput:


Process : C:\Program Files\IBM\WebSphere MQ\bin64\amqsput.exe (64-bit)
Host : Host1
Operating System : Windows Server 2008 R2 Standard Edition, Build 7601: SP1
Product Long Name : WebSphere MQ for Windows (x64 platform)
Version : 8.0.0.0 Level : p000-L140331.1
O/S Registered : 1
Data Path : C:\ProgramData\IBM\MQ
Installation Path : C:\Program Files\IBM\WebSphere MQ
Installation Name : Installation1 (1)
License Type :
UTC Date : 2014/05/22: Time : 15:01:37.682
LCL Date : 2014/05/22: Time : 08:01:37.682 Pacific Standard Time
QueueManager : QMC01

Counter TimeStamp PID.TID Ident Data


============================================================

00000001 10:40:39.316675 3296.1 : !! - Thread stack (from mqe.dll)


00000002 10:40:39.331417 3296.1 : !! - -> MQCONN
00000003 10:40:39.331866 3296.1 : !! - -> zswGetEntryPointsByName
00000004 10:40:39.331879 3296.1 : !! - -> MQCONN
00000005 10:40:39.336683 3296.1 : !! - -> trmzstMQCONNX
00000006 10:40:39.336692 3296.1 : !! - -> zstMQCONN
00000007 10:40:39.336698 3296.1 : !! - -> zstMQConnect
00000008 10:40:39.336703 3296.1 : !! - -> zstInitCS
00000009 10:40:39.337129 3296.1 : !! - -> xcsInitialize

© Copyright IBM Corp. 2014 Exercise 6. Running an IBM MQ trace 6-5


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Sample excerpt of a Windows trace file for amqsget:


Process : C:\Program Files (x86)\IBM\WebSphere MQ\bin\amqsget.exe (32-bit)
Host : Host1
Operating System : Windows 7 Professional x64 Edition, Build 7601: SP1
Product Long Name : WebSphere MQ for Windows
Version : 8.0.0.0 Level : p750-001-130308
Installation Path : C:\Program Files (x86)\IBM\WebSphere MQ
Installation Name : Installation1 (1)
UTC Date : 2014/05/07: Time : 14:40:53.613
LCL Date : 2014/05/07: Time : 10:40:53.613 Eastern Standard Time
QueueManager : QMC01

Counter TimeStamp PID.TID Ident Data


============================================================

00000507 10:40:53.624193 9396.1 : !! - Thread stack (from mqe.dll)


00000508 10:40:53.624212 9396.1 : !! - -> MQCONN
00000509 10:40:53.624220 9396.1 : !! - -> zswGetEntryPointsByName
0000050A 10:40:53.624226 9396.1 : !! - -> MQCONN
0000050B 10:40:53.624232 9396.1 : !! - -> trmzstMQCONNX
0000050C 10:40:53.624239 9396.1 : !! - -> zstMQCONN
0000050D 10:40:53.624244 9396.1 : !! - -> zstMQConnect
0000050E 10:40:53.624248 9396.1 : !! - -> zstInitCS
0000050F 10:40:53.624254 9396.1 : !! - -> xcsInitialize

End of exercise

6-6 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty Exercise review and wrap-up


Having completed this exercise, you should be able to:
• Set up an IBM MQ trace
• Analyze the output from a trace

© Copyright IBM Corp. 2014 Exercise 6. Running an IBM MQ trace 6-7


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

6-8 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty
Exercise 7. Connecting queue managers

What this exercise is about


In this exercise, you create channels between two queue managers with one
of the queue managers that acts as a remote queue manager. You use the
IBM MQ sample programs to send and receive messages between the
queue managers.

What you should be able to do


At the end of this exercise, you should be able to:
• Design a networked IBM MQ architecture that consists of two or more
interconnected queue managers
• Use IBM MQ commands to create the channels and supporting objects to
implement distributed queuing
• Use the IBM MQ sample programs to test the client connection to IBM
MQ

Introduction
In this exercise, you must configure two queue managers. One of queue
managers (QMC01) is a local queue manager and the other queue manager
(QMR01) simulates a remote queue manager on a different system.
In this exercise, you configure two message channels between the queue
managers so that messages can flow in each direction. The local queue
manager is QMC01 that you created in Exercise 1. You create the simulated
remote queue manager QMR01 in this exercise. The following figure
summarizes the configuration requirements.

© Copyright IBM Corp. 2014 Exercise 7. Connecting queue managers 7-1


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

In IBM MQ V8, channel authentication and connection authentication are


enabled by default for all new queue managers. By default, channel
authentication and connection authentication prevent remote connections to
the queue manager from MQ Explorer. There is a step in this exercise to
disable channel authentication and connection authentication on the queue
manager to allow connections to remote queue managers from MQ Explorer.
The exercise uses TCP/IP as the communications protocol.
If you need more help, detailed steps are provided in the “Exercise
Instructions with Hints” section in this exercise.

Requirements
• IBM MQ and IBM MQ Explorer
• Successful completion of Exercise 1 and Exercise 3
• The IBM MQ sample programs amqsput, amqsget, amqsreq, and amqsech
• A text editor

7-2 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty Exercise instructions

Step 1: Create a remote queue manager


__ 1. Start the queue manager QMC01 if it is not already running.
__ 2. Using MQ Explorer, create a queue manager that is named QMR01. Use port number 9000
for the listener port number.
__ 3. In MQSC, disable the use of channel authentication and connection authentication on
QMR01.
__ a. To disable channel authentication, type:
ALTER QMGR CHLAUTH(DISABLED)
__ b. To disable client connection authentication, type:
ALTER QMGR CONNAUTH(' ')

Note

There is a space character between the single quotation mark characters in the CONNAUTH attribute
of the ALTER QMGR command.

__ c. Refresh the security cache for the queue manager. Type:


REFRESH SECURITY

Important

The steps to disable channel and connection authentication are not standard practice.
Authentication is disabled in this exercise because security is not covered in this unit.

__ 4. In MQ Explorer, create a server connection channel (type SVRCONN) on the remote queue
manager QMR01.
__ 5. Connect to the remote queue manager QMR01 in MQ Explorer.
The remote queue manager should now be visible in the MQ Explorer Navigator as QMR01
on ‘localhost(9000)’.

Step 2: Define the channels and listener on the local queue manager
__ 1. Prepare an MQSC command file that is named ConnectLocal.mqsc to define the MQ
objects that are required for a connection between your local queue manager and the
remote queue manager.
__ a. Define a message channel (type = sender).

© Copyright IBM Corp. 2014 Exercise 7. Connecting queue managers 7-3


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

- Channel name = QMC01.QMR01 (where QMC01 is your local queue manager


name and QMR01 is the remote queue manager name)
- Protocol = TCP/IP
- Network address = localhost(9000) (where localhost is the host name and 9000 is
remote queue manager listener port)
- Transmission queue name = QMR01 (the same as the name of the remote queue
manager)
__ b. Define a receiver channel. The attributes must match the sender channel of the remote
queue manager.
__ c. Create a transmission queue with the same name as the remote queue manager
QMR01.
__ d. Define a dead-letter queue that is named DLQ.
__ e. Change the queue manager to use the queue that is named DLQ as its dead-letter
queue.
__ 2. Use runmqsc to run the script file ConnectLocal.mqsc against the local queue manager
QMC01. Redirect the output to a text file that is named LocalReport.txt.
__ 3. Use MQ Explorer to verify that QMC01 now has two channels:
• A sender channel that is named QMC01.QMR01
• A receiver channel that is named QMR01.QMC01

Also, verify that QMC01 now has a transmission queue that is named QMR01.
__ 4. Create and start a listener on 9001 for the local queue manager QMC01 in runmqsc.
Use the CONTROL(QMGR) option in the DEFINE LISTENER command to associate the
listener service with the queue manager. The listener service automatically starts when the
queue manager starts and stops when the queue manager stops.
Alternatively, you can start the MQ listener on 9001. From a command window, type:
runmqlsr -t TCP -p 9001 -m QMC01
If you use the runmqlsr command, you must use the endmqlsr command to manually stop
the service.

7-4 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty
Linux

If you want to start the MQ listener in the background type:


nohup runmqlsr -m QMC01 -t tcp -p 9001 2>&1 &
You can verify that the listener is running by typing the following command in a terminal window:
ps -ef | grep runmqlsr

__ 5. To eliminate any security errors and security configuration in this exercise, disable the use of
channel authentication and connection authentication on QMC01 and refresh the security
cache.

Step 3: Define the channels on the remote queue manager


__ 1. Prepare an MQSC command file that is named ConnectRemote.mqsc to define the MQ
objects that are required for a connection between your local queue manager and the
remote queue manager.
__ a. Define a sender channel that matches the receiver channel on QMC01.
- Channel name = QMR01.QMC01
- Protocol = TCP/IP
- Network address = localhost(9001)
- Transmission queue name = QMC01
__ b. Define a receiver channel. The attributes must match the sender channel QMC01.
__ c. Create a transmission queue with the same name as QMC01.
__ d. Define a dead-letter queue that is named DLQ.
__ e. Change the queue manager to use the queue that is named DLQ as its dead-letter
queue.
__ 2. Use runmqsc to run the script file ConnectRemote.mqsc against the remote queue manager
QMR01. Redirect the output to a text file that is named RemoteReport.txt.
__ 3. Use MQ Explorer to verify that QMR01 now has two channels:
• A receiver channel that is named QMC01.QMR01
• A sender channel that is named QMR01.QMC01
Also, verify that QMR01 now has a transmission queue that is named QMC01.

Step 4: Test and start the connection


__ 1. To test the channel definitions, open another command window and use the MQSC PING
command to ping the message channel from the QMC01 (the sender).
__ 2. In MQSC for QMC01, use the START CHANNEL command to start the channel and verify
that it is working.

© Copyright IBM Corp. 2014 Exercise 7. Connecting queue managers 7-5


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Step 5: Test queues in a distributed environment


__ 1. In MQSC, define the application queues on QMC01.
__ a. Delete and redefine the local queue QL.A.
__ b. Create a remote queue definition that points to the local queue QL.A on QMR01. Use
the name QRMT01. Include the name of the transmission queue.
__ 2. On QMR01, create a local queue that is named QL.A.
__ 3. Use the sample program amqsput to send messages from the local queue manager QMC01
to the queue QL.A on the remote queue manager QMR01.
__ 4. Verify that the messages you sent in Step 3 are on queue QL.A on QMR01.
__ 5. If the messages do not arrive, investigate the possible causes. Check the following items:
__ a. Is the local transmission queue empty?
__ b. Is the channel running?
__ c. Is the dead-letter queue of remote queue manager empty?
__ d. Inspect the error logs in both queue managers.
End of exercise

Optional exercise instructions


In this optional part of the exercise, you set up and test remote triggering. This optional exercise
assumes that you also completed Exercise 4, “Implementing a trigger monitor”.
__ 1. In this exercise, you configured sender and receiver channels on both ends of the
connection.
Configure a remote queue on QMR01 so that you can send a message to QL.A on QMC01.
__ 2. Start the channel between QMR01 and QMC01.
__ 3. Verify that you can send a message from QMR01 to QMC01.
__ 4. Use the sample program amqsreq to send request messages to the queue QL.A on the
remote queue manager QMR01. Enable the target queue for triggering so that the sample
program amqsech is started automatically and generates reply messages that amqsreq
receives.
__ a. Activate the trigger function for QL.A on QMC01 to handle request messages sent to
QL.A by QMR01.
__ b. Restart the trigger monitor on queue manager QMC01.
__ c. Put request messages on QL.A in the remote queue manager QMR01.
__ d. Check for a reply of each request message.
__ e. Close the trigger monitor window to stop the trigger monitor.
End of exercise

7-6 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty Exercise instructions with hints

Step 1: Create a remote queue manager


__ 1. Start the queue manager QMC01 if it is not already running.
__ 2. Using MQ Explorer, create a queue manager that is named QMR01. Use port number 9000
for the listener port number.
__ 3. In MQSC, disable the use of channel authentication and connection authentication on
QMR01.
__ a. In a command window, type: runmqsc QMR01
__ b. Display the queue manager properties. Type: DIS QMGR
__ c. Verify that the CHLAUTH attribute is set to ENABLE and that the CONNAUTH attribute is
set to SYSTEM.DEFAULT.AUTHINFO.IDPWOS.
__ d. Disable channel authentication. Type:
ALTER QMGR CHLAUTH(DISABLED)
__ e. Verify that the CHLAUTH attribute is now set to DISABLED.
__ f. For this exercise, disable client connection authentication. Type:
ALTER QMGR CONNAUTH(' ')

Note

There is a space character between the single quotation mark characters in the CONNAUTH attribute
of the ALTER QMGR command.

__ g. Refresh the security cache for the queue manager. Type:


REFRESH SECURITY
__ h. End the MQSC session. Type: END

Important

The steps to disable channel and connection authentication are not standard practice.
Authentication is disabled in this exercise because security is not covered in this unit.

__ 4. In MQ Explorer, create a server connection channel (type SVRCONN) on the remote queue
manager QMR01.
__ a. Verify that the queue manager is connected to MQ Explorer.
__ b. Right-click the queue manager QMR01 in the Navigator and then click Remote
Administration.

© Copyright IBM Corp. 2014 Exercise 7. Connecting queue managers 7-7


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ c. In the Remote Administration window, click Create to create the


SYSTEM.ADMIN.SVRCONN channel.
Click OK on the confirmation window and then click Close.
__ d. Click the Listeners folder under QMR01 in the MQ Explorer navigator.
Verify that the listener that is named LISTENER.TCP is in the list, that the status is
Running, and that the listener is running on port 9000.

__ 5. Connect to the remote queue manager QMR01 in MQ Explorer.


__ a. Right-click Queue Managers in the navigator and then click Add Remote Queue
Manager.
__ b. In the Add Queue Manager window, type: QMR01
__ c. Select Connect directly and then click Next.
__ d. For the Host name or IP address, type: localhost
__ e. For the Port number, type: 9000
__ f. Click Finish.
The remote queue manager should now be visible in the MQ Explorer Navigator as
QMR01 on ‘localhost(9000)’.

Step 2: Define the channels and listener on the local queue manager
__ 1. Prepare an MQSC command file that is named ConnectLocal.mqsc to define the MQ
objects that are required for a connection between your local queue manager and the
remote queue manager.
__ a. Define a message channel (type = sender).
- Channel name = QMC01.QMR01 (where QMC01 is your local queue manager
name and QMR01 is the remote queue manager name)
- Protocol = TCP/IP
- Network address = localhost(9000) (where localhost is the host name and 9000 is
remote queue manager listener port)
- Transmission queue name = QMR01 (the same as the name of the remote queue
manager)

7-8 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty Type:
DEF CHL(QMC01.QMR01) CHLTYPE(SDR) REPLACE +
TRPTYPE(TCP) CONNAME('localhost(9000)') +
XMITQ(QMR01)
__ b. Define a receiver channel. The attributes must match the sender channel of the remote
queue manager. Type:
DEF CHL(QMR01.QMC01) CHLTYPE(RCVR) REPLACE +
TRPTYPE(TCP)
__ c. Create a transmission queue with the same name as the remote queue manager
QMR01. Type:
DEF QL(QMR01) REPLACE +
USAGE(XMITQ)
__ d. Define a dead-letter queue that is named DLQ. Type:
DEF QL(DLQ) REPLACE
__ e. Change the queue manager to use the queue that is named DLQ as its dead-letter
queue. Type:
ALTER QMGR DEADQ(DLQ)
__ 2. Use runmqsc to run the script file ConnectLocal.mqsc against the local queue manager
QMC01. Redirect the output to a text file that is named LocalReport.txt.
Type: runmqsc QMC01 < ConnectLocal.mqsc > LocalReport.txt
__ 3. Use MQ Explorer to verify that QMC01 now has two channels:
• A sender channel that is named QMC01.QMR01
• A receiver channel that is named QMR01.QMC01

Also, verify that QMC01 now has a transmission queue that is named QMR01.
__ 4. Create and start a listener on 9001 for the local queue manager QMC01 in runmqsc.
Use the CONTROL(QMGR) option in the DEFINE LISTENER command to associate the
listener service with the queue manager. The listener service automatically starts when the
queue manager starts and stops when the queue manager stops.

© Copyright IBM Corp. 2014 Exercise 7. Connecting queue managers 7-9


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

In MQSC for QMC01, type:


DEF LISTENER(LISTENER.TCP) TRPTYPE(TCP) PORT(9001) CONTROL(QMGR)
START LISTENER(LISTENER.TCP)
Alternatively, you can start the MQ listener on 9001. From a command window, type:
runmqlsr -t TCP -p 9001 -m QMC01
If you use the runmqlsr command, you must use the endmqlsr command to manually stop
the service.

Linux

If you want to start the MQ listener in the background type:


nohup runmqlsr -m QMC01 -t tcp -p 9001 2>&1 &
You can verify that the listener is running by typing the following command in a terminal window:
ps -ef | grep runmqlsr

__ 5. To eliminate any security errors and security configuration in this exercise, disable the use of
channel authentication and connection authentication on QMC01.
In MQSC for QMC01, type:
ALTER QMGR CHLAUTH(DISABLED)
ALTER AUTHINFO(SYSTEM.DEFAULT.AUTHINFO.IDPWOS) +
AUTHTYPE(IDPWOS) CHCKCLNT(NONE)
REFRESH SECURITY

Step 3: Define the channels on the remote queue manager


__ 1. Prepare an MQSC command file that is named ConnectRemote.mqsc to define the MQ
objects that are required for a connection between your local queue manager and the
remote queue manager.
__ a. Define a sender channel that matches the receiver channel on QMC01.
- Channel name = QMR01.QMC01
- Protocol = TCP/IP
- Network address = localhost(9001)
- Transmission queue name = QMC01
Type:
DEF CHL(QMR01.QMC01) CHLTYPE(SDR) REPLACE +
TRPTYPE(TCP) CONNAME('localhost(9001)') +
XMITQ(QMC01)
__ b. Define a receiver channel. The attributes must match the sender channel QMC01. Type:
DEF CHL(QMC01.QMR01) CHLTYPE(RCVR) REPLACE +
TRPTYPE(TCP)

7-10 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty __ c. Create a transmission queue with the same name as QMC01. Type:
DEF QL(QMC01) REPLACE USAGE(XMITQ)
__ d. Define a dead-letter queue that is named DLQ. Type:
DEF QL(DLQ) REPLACE
__ e. Change the queue manager to use the queue that is named DLQ as its dead-letter
queue. Type:
ALTER QMGR DEADQ(DLQ)
__ 2. Use runmqsc to run the script file ConnectRemote.mqsc against the remote queue manager
QMR01. Redirect the output to a text file that is named RemoteReport.txt.
Type: runmqsc QMR01 < ConnectRemote.mqsc > RemoteReport.txt
__ 3. Use the report and MQ Explorer to verify that QMR01 now has two channels:
• A receiver channel that is named QMC01.QMR01
• A sender channel that is named QMR01.QMC01
Also, verify that QMR01 now has a transmission queue that is named QMC01.

Step 4: Test and start the connection


__ 1. To test the channel definitions, open another command window and use the runmqsc
command to ping the message channel from the QMC01 (the sender). Type:
runmqsc QMC01
PING CHL(QMC01.QMR01)
Check for successful completion.
__ 2. In MQSC for QMC01, use the START CHANNEL command to start the channel and verify
that it is working.
Type: START CHL(QMC01.QMR01)

Step 5: Test queues in a distributed environment


__ 1. In MQSC, define the application queues on QMC01.
__ a. Delete and redefine the local queue QL.A. Type:
DEF QL(QL.A) REPLACE
__ b. Create a remote queue definition that points to the local queue QL.A on QMR01. Use
the name QRMT01. Include the name of the transmission queue.
Enter the following command:
DEF QR(QRMT01) REPLACE +
RNAME(QL.A) RQMNAME(QMR01) +
XMITQ(QMR01)
__ 2. On QMR01, create a local queue that is named QL.A.

© Copyright IBM Corp. 2014 Exercise 7. Connecting queue managers 7-11


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 3. Use the sample program amqsput to send messages from the local queue manager QMC01
to the queue QL.A on the remote queue manager QMR01.
In a command window, type:
amqsput QRMT01 QMC01
__ 4. Use MQ Explorer to verify that the messages you sent in Step 3 are on queue QL.A on
QMR01.
You can also check the CURDEPTH attribute of the target queue.
__ 5. If the messages do not arrive, investigate the possible causes. Check the following items:
__ a. Is the local transmission queue empty?
__ b. Is the channel running?
__ c. Is the dead-letter queue of remote queue manager empty?
__ d. Inspect the error logs in both queue managers.
End of exercise

Optional exercise instructions with hints


In this optional part of the exercise, you set up and test remote triggering. This optional exercise
assumes that you also completed Exercise 4, “Implementing a trigger monitor”.
__ 1. In this exercise, you configured sender and receiver channels on both ends of the
connection.
Configure a remote queue on QMR01 so that you can send a message to QL.A on QMC01.
In MQSC for QMR01, enter the following command:
DEF QR(QRMT01) REPLACE +
RNAME(QL.A) RQMNAME(QMC01) XMITQ(QMC01)
__ 2. In MQSC for QMR01, use the START CHANNEL command to start the channel and verify
that it is working.
Type: START CHL(QMR01.QMC01)
__ 3. Verify that you can send a message from QMR01 to QMC01. In a command window, type:
amqsput QRMT01 QMR01
__ 4. Use the sample program amqsreq to send request messages to the queue QL.A on the
remote queue manager QMR01. Enable the target queue for triggering so that the sample
program amqsech is started automatically and generates reply messages that amqsreq
receives.
__ a. Activate the trigger function for QL.A on QMC01 to handle request messages sent to
QL.A by QMR01. Enter the following MQSC commands on QMC01:
ALTER QL(QL.A) TRIGGER +
TRIGTYPE(FIRST) INITQ(QL.INITQ) +
PROCESS(PR.ECHO)

7-12 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty __ b. Define a reply queue on QMR01. The sample program amqsreq opens this queue to
create a temporary dynamic reply-to queue.
In MQSC for QMR01, type: DEFINE QMODEL(QM.REPLY) REPLACE
__ c. Restart the trigger monitor on queue manager QMC01. In a command window, type:
runmqtrm -q QL.INITQ -m QMC01
__ d. Put request messages on QL.A in the remote queue manager QMR01. Open a new
command window and type:
amqsreq QRMT01 QMR01 QM.REPLY
Enter a message and then press Enter twice.
__ e. Check for a reply of each request message.
__ f. Close the trigger monitor window to stop the trigger monitor.
End of exercise

© Copyright IBM Corp. 2014 Exercise 7. Connecting queue managers 7-13


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Exercise review and wrap-up


Having completed this exercise, you should be able to:
• Create the objects that are required for distributed queuing
• Configure and refresh the started MQ listener
• Start message channels manually
• Use sample applications to test the message flow

7-14 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty
Exercise 8. Controlling access to IBM MQ

What this exercise is about


In this exercise, you use the Object Authority Manager (OAM) commands to
set access control on a queue, and then use the IBM MQ sample programs
to see the effect of attempting to breach security.

What you should be able to do


At the end of this exercise, you should be able to:
• Use the setmqaut command to define access control on a queue
• Use the dspmqaut command to display the access control on a queue
• Use IBM MQ Explorer to manage authority records
• Test security by using IBM MQ sample programs

Introduction
In this exercise you use a non-privileged user ID of ‘oamlab’ to access MQ
objects, experience access failures, examine related diagnostic messages,
and apply the correct rules. You use the MQ Explorer and the setmqaut
command to apply OAM rules.
If you need more help, detailed steps are provided in the “Exercise
Instructions with Hints” section in this exercise.

Linux

On Linux and UNIX systems, all authorities are set at the group-level. In Exercise 1, you created the
queue manager so that you can set authorities at the user-level authority by entering the -oa user
option on the create queue manager command.

Requirements
• IBM MQ and IBM MQ Explorer.
• A text editor.
• MS0P “WebSphere MQ Events and Statistics plug-in” SupportPac to
examine MQ security events in MQ Explorer.

© Copyright IBM Corp. 2014 Exercise 8. Controlling access to IBM MQ 8-1


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

• In general, the IBM MQ Explorer can be used in these labs. Ensure that
the SYSTEM.ADMIN.SVRCONN channel is defined and your listener is
running.
• The queue manager and queues that are created in Exercise 1.
• A user that does not belong to the ‘mqm’ group or the ‘users’ group (on
Linux).

8-2 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty Exercise instructions

Step 1: Authorizing a non-privileged user


The first exercise is to log in as a user that does not have object authority and make sure it cannot
access a queue. The non-privileged user receives a 2035 error when an attempt is made to access
the queue from a sample application.
The user ID that is not in the “mqm” group is referred to in the exercise as the non-privileged user
ID. In this exercise, the non-privileged user ID is oamlab.
Administration user IDs are the user IDs you use to log on to the image. The administration user IDs
are Administrator on Windows and root on Linux.
__ 1. As the administration user, start queue manager QMC01 if it is not already running.
__ 2. As the administration user, verify that queue QL.A is not PUT inhibited.
__ 3. As the administration user, enable authority events on your queue manager. This method is
one way to monitor authority violations.

If MQ Explorer is not available, type:


echo “alter qmgr authorev(enabled)” | runmqsc QMC01

__ 4. Start a session (window) as a non-privileged user and follow the steps according to your lab
operating system.

Linux

On Linux, the non-privileged user ID of oamlab is defined. Open a new terminal window and set the
user to oamlab:
su -l oamlab
The password is: Web1sphere
Set the path to run the sample programs by entering:
export PATH=$PATH:/opt/mqm/samp/bin/

Windows

On Windows, the non-privileged user ID oamlab is defined. To start a command window as


oamlab, enter the following command from a Windows command prompt:
runas /user:oamlab cmd

© Copyright IBM Corp. 2014 Exercise 8. Controlling access to IBM MQ 8-3


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

The password is: Web1sphere

__ 5. As the non-privileged (oamlab) user, use a sample program to attempt to put a message to
queue QL.A on your queue manager QMC01.
You receive an error message with a reason code 2035 (MQRC_NOT_AUTHORIZED).
__ 6. As the administration user, use the MS0P “Events and Statistics” SupportPac to find a
record of the violation.
A security violation message is also written to the MQ error logs.

Windows

For Windows queue managers, a security violation message is written to the


C:\ProgramData\IBM\MQ\qmgrs\QMC01\errors directory.

Linux

For Linux queue managers, a security violation message is written to the


/var/mqm/MQ/qmgrs/QMC01/errors directory.

Error message example:


5/23/2014 07:14:41 - Process(12.34) User(MUSR_MQADMIN) Program(amqzlaa0.exe)
Host(WS2008R2X64) Installation(Installation1)
VRMF(8.0.0.0) QMgr(QMC01)

AMQ8077: Entity 'oamlab@wetraining' has insufficient authority to access


object'QMC01'.

EXPLANATION: The specified entity is not authorized to access the required


object. The following requested permissions are unauthorized: connect

ACTION: Ensure that the correct level of authority has been set for this
entity against the required object, or ensure that the entity is a member of
a privileged group.
__ 7. As the administration user, use MQ Explorer or the setmqaut command to add connection
authority for the user “oamlab” to your queue manager.
Use the dspmqaut command to verify that the user has connect authority.
__ 8. As the administrator, give the user “oamlab” general API access (put, get, browse, inquire,
and set) to QL.A on your queue manager.

8-4 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty __ 9. In the command window that is running as “oamlab”, use the amqsbcg sample program on
QL.A to browse the queue and verify that the access is now allowed.
__ 10. In the command window that is running as “oamlab”, put a message on QL.A. This user
should now be able to put messages to QL.A.

Step 2: Using generic profiles


__ 1. As the administration user, use MQ Explorer or the setmqaut command to remove the
specific profile that allows user “oamlab” from accessing QL.A.
__ 2. As the administration user, create a new generic profile that is called QL.*.TEST that allows
the user “oamlab” to access (browse, put, get, set, and inquire) queues.
__ 3. As the administration user, define a queue that is called QL.A.TEST in QMC01.
__ 4. As the non-privileged user, try to access QL.A. You should get the error 2035.
__ 5. As the non-privileged user “oamlab”, try to put a message to QL.A.TEST.
__ 6. As the administration user, use MQ Explorer or the dmpmqaut command to inspect the
profiles that apply to QL.A.TEST.
__ 7. How many times did you enter the MQSC command REFRESH SECURITY in this exercise?
__ 8. Close the command window that is running as “oamlab”.
End of exercise

© Copyright IBM Corp. 2014 Exercise 8. Controlling access to IBM MQ 8-5


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Exercise instructions with hints

Step 1: Authorizing non-privileged user


The first exercise is to log in as a user that does not have object authority and make sure it cannot
access a queue. The non-privileged user receives a 2035 error when an attempt is made to access
the queue from a sample application.
User IDs not in the “mqm” group are referred to in the exercise as the non-privileged user ID.
Administration user IDs are Administration on Windows and root on Linux.
__ 1. As the administration user, start queue manager QMC01 if it is not already running.
__ 2. As the administration user, verify that queue QL.A is not PUT inhibited.
__ 3. As the administration user, enable authority events on your queue manager. This method is
one way to monitor authority violations.
__ a. Using MQ Explorer, right-click QMC01 in the navigator and click Properties.
__ b. On the Events tab, select Enabled for Authority Events.
__ c. Click Apply and then click OK.

If MQ Explorer is not available, type:


echo “alter qmgr authorev(enabled)” | runmqsc QMC01

__ 4. Start a session (window) as a non-privileged user and follow the steps according to your lab
operating system.

Linux

On Linux, a user ID of oamlab is defined. Open a new terminal window and set the user to oamlab:
su -l oamlab
The password is: Web1sphere
Set the path to run the sample programs by entering:
export PATH=$PATH:/opt/mqm/samp/bin/

Windows

On Windows, the non-privileged user ID is called oamlab. To start a command window as oamlab,
enter the following command from a Windows command prompt:
runas /user:oamlab cmd

8-6 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty The password is: Web1sphere

__ 5. In the non-privileged (oamlab) user command window, use a sample program to attempt to
put a message to queue QL.A on your queue manager QMC01. Type:
amqsput QL.A QMC01
You receive an error message with a reason code 2035 (MQRC_NOT_AUTHORIZED)
__ 6. As the administration user, use the MS0P “Events and Statistics“ SupportPac to find a
record of the violation.
To view the Queue Manager Events in the MQ Explorer:
__ a. Right-click QMC01in the MQ Explorer navigator, click Event Messages > Format
Events.
__ b. Click OK on the WebSphere MQ Events and Statistics window.
__ c. In the Events and Statistics tab, find the last event that shows the access violation.
.

A security violation message is also written to the MQ error logs.

Windows

For Windows queue managers, a security violation message is written to the


C:\ProgramData\IBM\MQ\qmgrs\QMC01\errors directory.

© Copyright IBM Corp. 2014 Exercise 8. Controlling access to IBM MQ 8-7


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Linux

For Linux queue managers, a security violation message is written to the


/var/mqm/MQ/qmgrs/QMC01/errors directory.

Error message example:


5/23/2014 07:14:41 - Process(12.34) User(MUSR_MQADMIN) Program(amqzlaa0.exe)
Host(WS2008R2X64) Installation(Installation1)
VRMF(8.0.0.0) QMgr(QMC01)

AMQ8077: Entity 'oamlab@wetraining' has insufficient authority to access


object'QMC01'.

EXPLANATION: The specified entity is not authorized to access the required


object. The following requested permissions are unauthorized: connect

ACTION: Ensure that the correct level of authority has been set for this
entity against the required object, or ensure that the entity is a member of
a privileged group.
__ 7. As the administration user, use MQ Explorer or the setmqaut command to add connection
authority for the user “oamlab” to your queue manager. If you use the setmqaut
command, use the dspmqaut command to verify that the user has connect authority.

To use the setmqaut command to add connection authority for the user “oamlab”, type:

setmqaut -m QMC01 –t qmgr -p oamlab +connect


To use the dspmqaut command to verify that the user has connect authority, type:
dspmqaut -m QMC01 –t qmgr -p oamlab
To use MQ Explorer to add connection authority for the user “oamlab”:
__ a. Right-click the queue manager in the navigator and then click Object Authorities >
Manage Queue Manager Authority Records.
__ b. On the Users tab, click New. Set the Entity name to oamlab.
__ c. Select Connect under the MQI section. Click OK.
__ d. Click OK on the confirmation window.
__ e. Verify that the user has Connect authority, and then click Close.

8-8 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty

__ 8. As the administrator, give the user “oamlab” general API access (put, get, browse, inquire,
and set) to QL.A on your queue manager.
To use the setmqaut command, type:
setmqaut -m QMC01 -t q -n QL.A -p oamlab +put +get +browse +inq +set
To use MQ Explorer:
__ a. Right-click the Queues folder under QMC01 in the navigator and then click Object
Authorities > Manage Authority Records.
__ b. Expand Specific Profiles. Select QL.A.
__ c. On the Users tab, click New and then type oamlab as the Entity Name.
__ d. Select Browse, Get, Inquire, Put, and Set authority under the MQI section. Click OK.
__ e. Click OK on the confirmation window.
__ f. Verity that the user has Browse, Get, Inquire, Put, and Set authorities, and then click
Close.

__ 9. In the command window that is running as “oamlab”, use the amqsbcg sample program on
QL.A to browse the queue and verify that the access is now allowed.
Type: amqsbcg QL.A QMC01

© Copyright IBM Corp. 2014 Exercise 8. Controlling access to IBM MQ 8-9


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 10. In the command window that is running as “oamlab”, put a message on QL.A. This user
should now be able to put messages to QL.A.
Type: amqsput QL.A QMC01

Step 2: Using generic profiles


In this part of the exercise, you remove some authorities.

Linux

If you are completing this exercise on Linux, you should see that when you add or remove
authorities for a user (oamlab), you are adding or removing authority for the entire user group.

__ 1. As the administration user, use MQ Explorer or the setmqaut command to remove the
specific profile that allows user “oamlab” from accessing QL.A.
Type: setmqaut -m QMC01 -t q -n QL.A -p oamlab -remove
__ 2. As the administration user, create a new generic profile that is called QL.*.TEST that allows
the user “oamlab” to access (browse, put, get, set, and inquire) queues.
Type: setmqaut -m QMC01 -t q -n QL.*.TEST -p oamlab +allmqi
__ 3. As the administration user, define a queue that is called QL.A.TEST in QMC01.
Type: DEFINE ql(QL.A.TEST)
__ 4. As the non-privileged user, try to access QL.A. You should get the 2035 error.
Type: amqsput QL.A QMC01
__ 5. As the non-privileged user “oamlab”, try to put a message to QL.A.TEST.
Type: amqsput QL.A.TEST QMC01
__ 6. As the administration user, use MQ Explorer or the dmpmqaut command to inspect the
profiles that apply to QL.A.TEST.
To use MQ Explorer to inspect the profiles that apply to QL.A.TEST, complete the following
steps:
1. Right-click the queue QL.A.Test in the Queues content view and then click Object
Authorities > Find Accumulated Authorities.
2. Select User and then type oamlab for the Entity name.
3. Click Refresh.

8-10 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty

To use to the dmpmqaut command to inspect the profiles that apply to QL.A.TEST, type:
dmpmqaut -m QMC01 -t q -p oamlab -n QL.A.TEST
It returns a summary of the profile. For example,
profile: QL.*.TEST
object type: queue
entity: oamlab@WETRAINING
entity type: principal
authority: allmqi
__ 4. How many times did you enter the MQSC command REFRESH SECURITY in this exercise?
None.
__ 5. Close the command window that is running as the user “oamlab”.
End of exercise

© Copyright IBM Corp. 2014 Exercise 8. Controlling access to IBM MQ 8-11


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Exercise review and wrap-up


In the lab environment, you ran as “Administrator” on Windows or “root” on Linux so that you can
complete other operating system tasks. In a real environment, it is not necessary to have this level
of access to the operating system to manage MQ. In your environment, you typically log in with a
specific user name and password, such as “mqm” on Linux.
Having completed this exercise, you should be able to:
• Use the setmqaut command or MQ Explorer to create authority records for a queue
• Use the dspmqaut or MQ Explorer to display the authority records for a queue
• Use IBM MQ utilities and sample programs to test security

8-12 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty
Exercise 9. Connecting an IBM MQ client

What this exercise is about


In this exercise, you configure your system to act as a client connected to an
IBM MQ server system. You use two different methods (MQSERVER
environment variable and the client configuration file) to gain experience with
both methods. You encounter security issues and use the MCAUSER
parameter to overcome this problem.

What you should be able to do


At the end of this exercise, you should be able to:
• Create a server connection (SVRCONN) channel to support client
connections
• Use the MQSERVER environment variable to set up a client connection
• Use a client configuration file to specify information about client channels

Introduction
To put, browse, and get messages on your client system, use the sample
programs. A brief description of each of the programs you might use is
provided:
• amqsputc is started the same way as amqsput and has the same
parameter structure. But it connects as a WebSphere MQ client instead
of a direct connection to the WebSphere MQ server.
• amqsbcgc is started the same way as amqsbcg and has the same
parameter structure but it connects as a WebSphere MQ client.
• amqsgetc is started the same way as amqsget and has the same
parameter structure but it connects as a WebSphere MQ client.
To simplify running this exercise, use two console windows. Use one of the
console windows for running the sample programs. Use the other console
window for entering queue manager control and configuration commands.
If you need more help, detailed steps are provided in the “Exercise
Instructions with Hints” section in this exercise.

Requirements
• IBM MQ and IBM MQ Explorer.

© Copyright IBM Corp. 2014 Exercise 9. Connecting an IBM MQ client 9-1


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

• Access to WebSphere MQ sample programs.



On Windows, sample programs amqsputc, amqsbcg, amqsbcgc, and
amqsgetc can be run from any location within the file system hierarchy.

On Linux, you must either reference the path when you are running the
sample program or export the path to the sample directory in every
command window by entering: 
export PATH=$PATH:/opt/mqm/samp/bin/
• This exercise assumes the successful completion of Exercise 1, “Using
commands to create queue managers and queues” and Exercise 7,
“Connecting queue managers”.

9-2 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty Exercise instructions


In this exercise, your system provides two functions:
• Your queue manager QMC01 is the server for the WebSphere MQ clients.
• The client sample programs on your system connect by the WebSphere MQ client
function to the remote queue manager QMR01.

Important

Channel authentication must be disabled on QMC01 as instructed in Exercise 7.

Server queue manager setup


__ 1. Reuse the queue manager that is defined in the Exercise 7 (QMC01) as a server queue
manager.
On the server queue manager, define an SVRCONN channel to make your queue manager
connectable by WebSphere MQ Clients.
Use QMC01_CLNT as the channel name. The protocol is TCP.
To ensure that the user has the object authority on the target server, add the message
channel agent user identifier option MCAUSER.
If the queue manager is running on Windows, set MCAUSER to MUSR_MQADMIN.
Example: MCAUSER(MUSR_MQADMIN)
If the queue manager is on Linux, set MCAUSER to mqm.
Example: MCAUSER(‘mqm’)

Important

In this lab, you are using MUSR_MQADMIN or ‘mqm’ for the MCAUSER user name. In a real
implementation, you would create an administrative user ID for MQ and use that ID for the
MCAUSER. Never use MUSR_MQADMIN or ‘mqm’ in a real implementation.

__ 2. Verify that the server queue manager QMC01 listener is running.


If a listener is not running, start the WebSphere MQ listener on port 9001.

Client setup (method 1)


__ 1. Use the MQSERVER environment variable to provide a client-connection channel definition
to be able to connect to the server queue manager (QMC01).

© Copyright IBM Corp. 2014 Exercise 9. Connecting an IBM MQ client 9-3


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 2. Test the client connection.


__ a. Use amqsputc to put messages on the queue QL.A on the QMC01 queue manager.
__ b. Use amqsbcgc to browse the messages on the server queue. The value of
ReplyToQmgr in the MQMD shows you which server queue manager was connected
and created the message.
__ c. Use amqsgetc to get the messages from the server queue.
__ 3. Clear the MQSERVER environment variable.

Client setup (method 2)


__ 1. Edit the client configuration file (mqclient.ini).
__ a. Add a CHANNELS stanza.
__ b. Add the attribute that enables the client to reconnect automatically.
__ c. Add the attribute that identifies the server connection on QMC01.
__ 2. Test the client connection.
__ a. Use the amqsputc sample program to put a message to QL.A on the server manager
(QMC01) and ensure that the operation completed successfully.
__ b. Verify that the message is written QL.A on QMC01.
End of exercise

9-4 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty Exercise instructions with hints


In this exercise, your system provides two functions:
• Your queue manager QMC01 is the server for the WebSphere MQ clients.
• The client sample programs on your system connect the WebSphere MQ client function
to the remote queue manager QMR01.

Important

Channel authentication must be disabled on QMC01 as instructed in Exercise 7.

Server queue manager setup


__ 1. Reuse the queue manager that is defined in the Exercise 7 (QMC01) as a server queue
manager.
On the server queue manager QMC01, define an SVRCONN channel to make your queue
manager connectable by WebSphere MQ Clients.
Use QMC01_CLNT as the channel name. The protocol is TCP.
To ensure that the user has the object authority on the target server, add the message
channel agent user identifier option MCAUSER.
If the queue manager is running on Windows, set MCAUSER to MUSR_MQADMIN.
If the queue manager is on Linux, set MCAUSER to mqm.

Windows

To define the SVRCONN, type:


DEFINE CHL(QMC01_CLNT) CHLTYPE(SVRCONN) TRPTYPE(TCP) +
MCAUSER(MUSR_MQADMIN)

Linux

To define the SVRCONN, type:


DEFINE CHL(QMC01_CLNT) CHLTYPE(SVRCONN) TRPTYPE(TCP)+ 
MCAUSER(‘mqm’)

© Copyright IBM Corp. 2014 Exercise 9. Connecting an IBM MQ client 9-5


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Important

In this lab, you are using MUSR_MQADMIN or ‘mqm’ for the MCAUSER user name. In a real
implementation, you would create an administrative user ID for MQ and use that ID for the
MCAUSER. Never use MUSR_MQADMIN or ‘mqm’ in a real implementation.

__ 2. Verify that the server queue manager QMC01 listener is running.


If a listener is not running, start the WebSphere MQ listener on port 9001.

Client setup (method 1)


__ 1. Use the MQSERVER environment variable to provide a client-connection channel definition
to be able to connect to the server queue manager (QMC01).
Enter the following commands according to your system type.

Linux

export MQSERVER=QMC01_CLNT/TCP/’localhost(9001)’

Windows

SET MQSERVER=QMC01_CLNT/TCP/localhost(9001)

__ 2. Test the client connection.


__ a. Use amqsputc to put messages on the queue QL.A on the QMC01 queue manager.
Type: amqsputc QL.A QMC01
__ b. Use amqsbcgc to browse the messages on the server queue. The value of
ReplyToQmgr in the MQMD shows you which server queue manager was connected
and created the message.
__ c. Use amqsgetc to get the messages from the server queue.
Type: amqsgetc QL.A QMC01
__ 3. Clear the MQSERVER environment variable.

Linux

In a terminal window, type: unset MQSERVER

9-6 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty
Windows

From a command prompt, type: SET MQSERVER=

Client setup (method 2)


In this part of the exercise, you use the client configuration file (mqclient.ini) to specify
information about the client channels.
• On Windows, the client configuration file is in the C:\ProgramData\IBM\MQ directory.
• On Linux, the client configuration file is in the /var/mqm directory.
__ 4. Edit the client configuration file (mqclient.ini).
__ a. Add a CHANNELS stanza.
At the bottom of the file, type: CHANNELS:
__ b. Add the attribute that enables the client to reconnect automatically.
Under CHANNEL, press Tab and then type: DefRecon=YES
__ c. Add the attribute that identifies the server connection on QMC01.
Under the DefCon attribute, press Tab and then type:
ServerConnectionParms=QMC01_CLNT/TCP/localhost(9001)
Example:
#*******************************************************************#
#* Module name : mqclient.ini
#* Type : WebSphere MQ client configuration file
#* Function : Define the client configuration
#*******************************************************************#
ClientExitPath:
ExitsDefaultPath=/var/mqm/exits
ExitsDefaultPath64=/var/mqm/exits64
CHANNELS:
DefRecon=YES
ServerConnectionParms=QMC01_CLNT/TCP/localhost(9001)
__ d. Save and close the file.
__ 5. Test the client connection.
__ a. Use the amqsputc sample program to put a message to QL.A on the server manager
(QMC01) and ensure that the operation completed successfully.
Type: amqsputc QL.A QMC01
__ b. Verify that the message for QL.A is written on QMC01.
End of exercise

© Copyright IBM Corp. 2014 Exercise 9. Connecting an IBM MQ client 9-7


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Exercise review and wrap-up


In the absence of any security exits, the IBM MQ client uses a field in the channel descriptor to pass
the client logged-on user ID to the server where it is used for access control.
The problem with this approach is that spoofing, or pretending to be someone you are not is easy. If
you have administrative control of the client system, you can define a user ID, such as mqm or
MUSR_MQADMIN. You can then use that ID to connect to a remote queue manager with full access to
that queue manager. This approach is not satisfactory.
Having completed this exercise, you should be able to:
• Use an MQSC command to create a server connection (SVRCONN) channel to support
client connections
• Use the MQSERVER environment variable to set up a client connection
• Use the client configuration files to identify a server connection

9-8 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty
Exercise 10.Backing up and restoring IBM MQ
object definitions

What this exercise is about


In this exercise, you use the dmpmqcfg control command to unload a queue
manager's object definitions. You then create a queue manager and load the
same definitions, and use MQSC commands or IBM MQ Explorer to show
that the definitions are the same.

What you should be able to do


At the end of this exercise, you should be able to:
• Use IBM MQ commands to back up object definitions of a queue
manager
• Use IBM MQ commands to upload object definitions to another queue
manager

Introduction
The IBM MQ dmpmqcfg control command can be used to back up and restore
a queue manager’s configuration. As an option, you can use the –o
setmqaut parameter to create setmqaut commands that can be used to
re-create the queue manager security definitions.
If you need more help during this exercise, the “Exercise Instructions with
Hints” section provides detailed instructions and commands.

Requirements
• IBM MQ and IBM MQ Explorer
• Successful completion of Exercise 1

© Copyright IBM Corp. 2014 Exercise 10. Backing up and restoring IBM MQ object definitions 10-1
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Exercise instructions

Step1: Backing up queue manager configuration


__ 1. Ensure that the queue manager QMC01 is running.
__ 2. Run the MQ dmpmqcfg command to back up QMC01.
Use the default formatting option of MQSC and all attributes. Use standard output
redirection to store the definitions into a file.
__ 3. Using a text editor such as Notepad on Windows or gedit on Linux, examine the resulting
file, and answer the following questions.
__ a. Are SYSTEM.* objects in the backup file?
__ b. Can you suppress generation of the SYSTEM.* objects?
__ c. Is the REPLACE option present in the generated definitions?
__ d. What does REPLACE do?

Step 2: Restoring the object definitions


Simulate the running of the file you generated in the previous section. This action would be done if
you need to redefine all your MQ objects. In this case, you do not replace any definitions. SYSTEM
queues are not empty, and redefining these objects effectively removes all cluster, channel state,
and authorities that are stored in the SYSTEM queues.
__ 1. Use MQSC commands to check whether any SYSTEM queues contain messages.
__ 2. Simulate the restore function without replacing the definitions by using runmqsc with the -v
option to run in verify mode.

Important

Ensure that you use the -v option so that you do not overwrite the existing configuration in the lab
environment.

Step 3: Dumping security definitions


__ 1. Use the MQ dmpmqcfg command to dump the queue manager security definitions to a file.
Use the -o setmqaut option to format the output as a series of setmqaut commands.
__ 2. Use MQ Explorer to dump the OAM definitions for QMC01.
__ 3. Examine the output from the security definitions file
Find the setmqaut entries for QL.A.

10-2 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty __ 4. Run the following command to write a formatted view of the current authorities for QL.A on
QMC01.
dmpmqaut -m QMC01 -n QL.A -t q
__ a. Note the format of this output.
__ b. Consider how the different format leads to different uses.
The dmpmqcfg command writes the security definitions as a list of setmqaut commands.
These commands can then be used to re-create the security definitions on a new queue
manager.
In contrast, the dmpmqaut command creates a formatted view of the authorities. The
formatted view is useful for finding all the authorities that are set against a particular MQ
object. The output cannot be used to re-create the security definitions without
reformatting.
End of exercise

© Copyright IBM Corp. 2014 Exercise 10. Backing up and restoring IBM MQ object definitions 10-3
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Exercise instructions with hints

Step1: Backing up queue manager configuration


__ 1. Ensure that the queue manager QMC01 is running.
In a command window, type: dspmq -m QMC01
__ 2. Run the MQ dmpmqcfg command to back up QMC01.
Use the default formatting option of MQSC and all attributes. Use standard output
redirection to store the definitions into a file.
dmpmqcfg -m QMC01 -a > QMC01.mqsc
__ 3. Using a text editor such as Notepad on Windows or gedit on Linux, examine the resulting
file, and answer the following questions.
__ a. Are SYSTEM.* objects in the backup file? 
Yes.
__ b. Can you suppress generation of the SYSTEM.* objects? 
No.
__ c. Is the REPLACE option present in the generated definitions? 
Yes.
__ d. What does REPLACE do? 
The REPLACE and NOREPLACE options control whether any existing definitions are
replaced with the new ones. The MQ default is NOREPLACE.

Step 2: Restoring the object definitions


Simulate the running of this generated file. This action would be done if you need to redefine all
your MQ objects. In this case, you are not replacing any definitions because some of the SYSTEM
queues are not empty. Redefining the SYSTEM queues objects effectively removes all cluster,
channel state, and authorities that are stored in the SYSTEM queues.
__ 1. Use MQSC to check whether any of the SYSTEM queues on QMC01 contain messages.
In MQSC, type:
DIS QL(SYSTEM.*) WHERE(CURDEPTH GT 0)
__ 2. Use the runmqsc command with the –v option to run in verify mode and simulate the restore
function without replacing the definitions.
runmqsc -v QMC01 < QMC01.mqsc

Important

Ensure that you use the -v option so that you do not overwrite the existing configuration in the lab
environment.

10-4 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty __ 3. Use an MQSC command to verify that messages on the SYSTEM queues on QMC01 are
intact.
In MQSC, type:
DIS QL(SYSTEM.*) WHERE(CURDEPTH GT 0)
Ensure that the queue depths match the queue depths reported in Step 2.1.

Step 3: Dumping security definitions


__ 1. Use the MQ dmpmqcfg command with the -x authrec option to dump the queue manager
security definitions to a file. Use the -o setmqaut option to format the output as a series
of setmqaut commands.
dmpmqcfg -o setmqaut -x authrec -t qmgr -m QMC01 > QMC01-setmqaut.mqsc
__ 2. Use MQ Explorer to dump the OAM definitions for QMC01.
__ a. In the MQ Explorer Navigator, right-click QMC01 and then click Object authorities >
Save All.
__ b. Select a directory, enter a file name, and then click Save.
__ 3. Examine the output from the security definitions file.
Find the setmqaut entries for QL.A.
__ 4. Run MQ command: dmpmqaut -m QMC01 -n QL.A -t q
This command writes a formatted view of the authorities for the queue QL.A.
__ a. Consider the format of this output.
__ b. Consider how the different format leads to different uses.
The dmpmqcfg command writes the security definitions as a list of setmqaut commands.
These commands can then be used to re-create the security definitions on a new queue
manager.
In contrast, dmpmqaut, writes a formatted view of the authorities. The formatted view is
useful for finding all the authorities that are set against a particular MQ object. The
output cannot be used to re-create the security definitions without reformatting.
End of exercise

© Copyright IBM Corp. 2014 Exercise 10. Backing up and restoring IBM MQ object definitions 10-5
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Exercise review and wrap-up


Having completed this exercise, you should be able to:
• Use IBM MQ commands to back up object definitions of a queue manager
• Use IBM MQ commands to upload object definitions to another queue manager

10-6 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty
Exercise 11.Monitoring and configuring IBM MQ
for performance

What this exercise is about


In this exercise, you enable and configure the online monitoring, statistics,
and accounting features of IBM MQ.

What you should be able to do


At the end of this exercise, you should be able to:
• Enable accounting and statistics collection in IBM MQ
• View accounting and statistics data

Introduction
With the IBM MQ monitoring facilities, you can postprocess monitoring data
and monitor your queue manager online.
For postprocessing, the collected monitoring data is split into two categories:
1. Statistics monitoring
Statistics monitoring generates data about the activity of the queue
manager for a specified time interval.
Statistics monitoring is used to collect information about the performance
of various areas of the queue manager. You can collect data on the
queue manager, queues, and channels, and you can configure the
amount of information to collect.
After it is collected, the data is made available at regular intervals in the
form of PCF records that are written to the
SYSTEM.ADMIN.STATISTICS.QUEUE system queue, with one
message per subtype.
This information can be used for charging purposes or for generating
historical analysis of the operation or throughput of the IBM MQ system.
2. Accounting monitoring
Accounting monitoring generates data about the activity of an IBM MQ
connection.
Accounting monitoring collects information about each IBM MQ
connection and when the connection disconnects. This information is
written in the form of a PCF monitoring message to the
SYSTEM.ADMIN.ACCOUNTING.QUEUE system queue. As an option,
Interim messages can be written for long-running tasks.

© Copyright IBM Corp. 2014 Exercise 11. Monitoring and configuring IBM MQ for performance 11-1
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

As with statistics monitoring, the user can configure the amount of


information that is collected. Separate messages can be written for each
subtype of information that is collected.
This information can be used for charging or accounting purposes. The
purpose of the online monitoring is to give a quick view of the
performance of a specific resource. Data is immediately available, giving
the user an instantaneous view of the particular resource. The monitoring
data is collected for channels and queues, and are displayed as extra
attributes on the DISPLAY CHSTATUS and the DISPLAY QSTATUS MQSC
commands.
In this exercise, you configure and use the monitoring functions of IBM MQ.
The exercise includes:
1. Configuring a queue manager to collect statistics data.
2. Configuring a queue manager to collect accounting data.
3. Running test programs to generate monitoring data.
4. Use the amqsmon sample program to display the information that is
contained within accounting and statistics messages in a readable
format. The amqsmon program reads accounting messages from the
accounting queue, SYSTEM.ADMIN.ACCOUNTING.QUEUE, and reads
statistics messages from the statistics queue,
SYSTEM.ADMIN.STATISTICS.QUEUE.

Requirements
In addition, the following are required:
• IBM MQ and IBM MQ Explorer
• Successful completion of Exercise 1 and Exercise 7
• The amqsput, amqsget, and amqsmon sample programs that are supplied
with IBM MQ
• The statsdata.txt text file in the C:\labfiles\Lab11\data directory
on Windows or the usr/labfiles/Lab11/data directory on Linux
• WebSphere MQ MS0P SupportPac installed in IBM MQ Explorer

Note

11-2 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty Exercise instructions

Step 1: Configure a queue manager to collect statistics data


In this section, you configure a queue manager to collect statistics data. The configuration is
controlled by using a set of queue manager and queue/channel attributes.
The attributes can be set by using the MQ Explorer or by using MQSC commands; instructions in
this exercise use MQ Explorer.
__ 1. If it is not already running, start MQ Explorer.
__ 2. Start the queue manager that is named QMC01 if it is not already running.
__ 3. Stop all other running queue managers.
__ 4. Edit the properties for queue manager QMC01 to configure statistics monitoring properties.
__ a. In the MQ Explorer navigator view, right-click QMC01 and then click Properties.
__ b. To work with statistics properties, select Statistics monitoring from the Properties list.
Five queue manager properties control statistics generation:
- MQI statistics (STATMQI) counts the number of MQ API requests processed in the
recording interval.
- Queue statistics (STATQ) records information about every local queue in the
system. When a queue is accessed indirectly, for example by using a queue alias,
the statistics are collected against the resolved local queue. Actions against remote
queues are recorded against the associated transmission queue.
- Channel statistics (STATCHL) records information about every channel (except
SVRCONNs) in the system.
- Auto CLUSSDR statistics (STATACLS) specifies whether to collect statistics data
about the activity of auto-defined cluster-sender channels.
- Statistics interval (STATINT) specifies, in seconds, the recording interval for
recording data.
__ c. Activate statistics monitoring. In the Statistics monitoring window, set the following
properties:
• MQI statistics: On
• Queue statistics: On
• Channel statistics: Low
• Statistics interval: 180
With a Statistics interval of 180, statistics messages are generated every 3 minutes.
The interval is set to a short interval to demonstrate this function. On production queue
managers, the interval is likely to be set to a greater interval.

© Copyright IBM Corp. 2014 Exercise 11. Monitoring and configuring IBM MQ for performance 11-3
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ d. Click Apply and then click OK.


These settings enable statistics collection on the queue manager.

Note

You can disable statistics generation on each queue or channel by setting the Queue statistics
(STATQ) or Channel statistics (STATCHL) attribute of the object to Off.

Step 2: Configure a queue manager to collect accounting data


In this part of the exercise, you configure a queue manager to collect accounting data. The
configuration is controlled by using a set of queue manager, queue, and channel properties. These
properties can be set by using MQ Explorer or MQSC commands; the instructions in this exercise
are for MQ Explorer.
__ 1. In the MQ Explorer Navigator view, right-click QMC01 and then click Properties. The
properties for the QM1 queue manager are opened.
__ 2. To work with accounting properties, select Accounting monitoring from the Properties
list.
• Four queue manager properties control accounting data generation:
- MQI accounting (ACCTMQI) records collected information about the MQI
operations that each application runs.
- Queue accounting (ACCTQ) records collected information about queues.
Messages contain lists of records, one for each local queue open during the time
interval.
- Accounting interval (ACCTINT) defines the interval in which to write intermediate
records (that is, for long-running applications). Setting this attribute to zero turns off
intermediate records.

11-4 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty - Accounting connection override (ACCTCONO) enables applications to override


the attributes by using the Connect options in MQCONNX calls,
__ 3. Activate accounting data recording. In the Accounting monitoring properties window, set
the following attributes:
• MQI accounting: On
• Queue accounting: On
• Accounting interval: 180
• Accounting connection override: Disabled
__ 4. Click Apply and then click OK.

Step 3: Generate and view accounting data


In this part of the exercise, you run IBM MQ sample programs to simulate MQ activity and use the
sample program to read and format the generated PCF messages. The test programs write
messages to a local queue, and then read them back off the queue.
At the end of this part of the exercise, you review the generated accounting data.
__ 1. Create a local queue on QMC01 that is named ACCTG.STATS.Q1.
__ 2. From a command window, run the amqsput program with the statsdata.txt file to put
messages to the local queue, ACCTG.STATS.Q1. The statsdata.txt file is a text 536
lines, which generate a message for each line.

Windows

In the command window, type:


amqsput ACCTG.STATS.Q1 QMC01 <C:\labfiles\Lab11\data\statsdata.txt

© Copyright IBM Corp. 2014 Exercise 11. Monitoring and configuring IBM MQ for performance 11-5
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Linux

In a terminal window, type:


amqsput ACCTG.STATS.Q1 QMC01 </usr/labfiles/Lab11/data/statsdata.txt

__ 3. Use MQ Explorer to check the queue depth of queue ACCTG.STATS.Q1 and verify that the
queue contains 536 messages.
__ 4. Use the amqsget program to read messages from ACCTG.STATS.Q1.
In the command window, type:
amqsget ACCTG.STATS.Q1 QMC01
This command gets all the messages off the queue.
__ 5. Check the queue depth of ACCTG.STATS.Q1. It should now be 0.
__ 6. Now look at the accounting data that was generated as a result of using amqsput and
amqsget.
MQ provides a sample program that can be used to read and format statistics and
accounting data.
__ a. Open a new command window.
__ b. Use the MQ sample program amqsmon to read the accounting PCF messages from
SYSTEM.ADMIN.ACCOUNTING.QUEUE and write the results to text file.

Windows

In the command window, type:


amqsmon –m QMC01 –t accounting > c:\labfiles\Lab11\accounting.txt

Linux

In the terminal window, type:


export PATH=$PATH:/opt/mqm/samp/bin/
amqsmon –m QMC01 –t accounting > /usr/labfiles/Lab11/accounting.txt

__ 7. Open the file accounting.txt in a text editor.


The file contains several messages that the amqsput and amqsget sample programs
generate when you use them.
Look at the file and locate the messages that are associated with amqsput and amqsget.
Each program (amqsput and amqsget) generates two messages. One message is

11-6 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty generated to show MQI accounting, that is, the MQI operations that get each application
runs. The other message is generated to show queue accounting, that is, the details of the
queue that the application uses.

Note

For applications that use multiple queues, there is a separate message for each queue.

Look at the file and locate the MQI accounting and queue accounting messages for each
application. 

Table 1 and Table 2 describes the fields in each message.
Table 1: MQI accounting fields
Field Description
QueueManager Name of the queue manager.
IntervalStartDate Date of the start of the monitoring period.
IntervalStartTime Time of the start of the monitoring period.
IntervalEndDate Date of the end of the monitoring period.
IntervalEndTime Time of the end of the monitoring period.
CommandLevel IBM MQ command level.
ConnectionId Connection ID for the task.
Sequence number (normally zero). Increments for each subsequent
SeqNumber
record for long running connections.
ApplicationName Name of the application (program name).
ApplicationPid Operating system process ID of the application.
ApplicationTid IBM MQ thread ID of the connection in the application.
User ID User ID context of the application.
Normally matches “StartTime,” except in the case of long-running
ConnDate
connections.
Normally matches “StartTime,” except in the case of long-running
ConnTime
connection.
ConnName Only written for client connections.
ChannelName Only written for client connections.
Normally matches “EndTime,” except in the case of long running
DiscDate
connections.
Normally matches “EndTime,” except in the case of long running
DiscTime
connections.
MQ_DISCONNECT_TYPE_NORMAL, application requested.
MQ_DISCONNECT_TYPE_IMPLICIT, abnormal application
DiscType termination.
MQ_DISCONNECT_TYPE_QMGR, queue manager broke the
connection (shutdown -i).
OpenCount Number of objects opened.
OpenFailCount Number of unsuccessful open object attempts.

© Copyright IBM Corp. 2014 Exercise 11. Monitoring and configuring IBM MQ for performance 11-7
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Table 1: MQI accounting fields


Field Description
CloseCount Number of objects closed.
CloseFailCount Number of unsuccessful close object attempts.
Number of messages that are successfully put to a queue (excluding
PutCount
MQPUT1 requests).
PutFailCount Number of unsuccessful put message attempts.
PutBytes Number bytes written in MQPUTs.
GetCount Number of successful destructive MQGETs.
GetFailCount Number of unsuccessful destructive gets.
GetBytes Total number of bytes retrieved.
BrowseCount Number of successful non-destructive gets.
BrowseFailCount Number of successful non-destructive gets.
BrowseBytes Total number of bytes browsed.
Number of successful transactions that are completed including those
CommitCount
transactions that the application commits when it disconnects.
Number of unsuccessful attempts to complete a transaction that include
CommitFailCount those transactions that run an implicit commit because the application
disconnected.
Number of backouts processed (including implicit backout upon
BackCount
abnormal disconnect).
InqCount Number of successful objects inquired upon.
InqFailCount Number of unsuccessful “object inquire” attempts.
SetCount Number of successful object updates (SET).
SetFailCount Number of successful SET attempts.
Note: The OpenCount, OpenFailCount, CloseCount, and CloseFailCount fields are displayed as
arrays.
Table 2: Queue accounting fields
QueueManager Name of the queue manager
IntervalStartDate Date of the start of the monitoring period.
IntervalStartTime Time of the start of the monitoring period.
IntervalEndDate Date of the end of the monitoring period.
IntervalEndTime Time of the end of the monitoring period.
CommandLevel IBM MQ command level.
ConnectionId Connection ID for the task.
Sequence number normally zero. Increments for each subsequent
SeqNumber
record for long running connections.
ApplicationName Name of the application (program name).
ApplicationPid Operating system process ID of the application.
ApplicationTid IBM MQ thread ID of the connection in the application.
User ID User ID context of the application.
Number of queues that are accessed in the interval for which
ObjectCount
accounting data was recorded.
QueueName Name of the queue.
CreateDate Date the queue was created.

11-8 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty Table 2: Queue accounting fields


QueueManager Name of the queue manager
CreateTime Time the queue was created.
QueueType Type of the queue.
Queue definition type. Valid values are:

QueueDefinitionType • MQQDT_PREDEFINED
• MQQDT_PERMANENT_DYNAMIC
• MQQDT_TEMPORARY_DYNAMIC
OpenCount Number of times the application opened this queue in this interval.
Date of the first open of the queue in this recording interval. If the queue
OpenDate was already open at the start of this interval, this value is the date that
the queue was originally opened.
Time of first open of the queue in this recording interval. If the queue
OpenTime was already open at the start of this interval, this value is the time that
the queue was originally opened.
CloseCount Number of objects closed.
Date of final close of the queue in this recording interval. If the queue is
CloseDate
still open, then the value is not returned.
Time of final close of the queue in this recording interval. If the queue is
CloseTime
still open, then the value is not returned.
Number of messages that are successfully put to the queue (excluding
PutCount
MQPUT1 requests).
PutFailCount Number of unsuccessfully put message attempts.
Number of messages that are successfully put to the queue through
Put1Count
MQPUT1 requests.
Put1FailCount Number of unsuccessful MQPUT1 message attempts.
PutBytes Total number of bytes put.
PutMinBytes Smallest message size that is placed on the queue.
PutMaxBytes Largest message size that is placed on the queue.
GetCount Number of successful destructive MQGETs.
GetFailCount Number of unsuccessful destructive GETs.
GetBytes Number of bytes read in destructive GETs.
GetMinBytes Size of the smallest messages that are retrieved from the queue.
GetMaxBytes Size of the largest messages that are retrieved from the queue.
BrowseCount Number of successful non-destructive GETs.
BrowseFailCount Number of unsuccessful non-destructive MQGETs.
Number of bytes read in non-destructive MQGETs that returned
BrowseBytes
persistent messages.
BrowseMinBytes Size of the smallest messages that are browsed from the queue.
BrowseMaxBytes Size of the largest messages that are browsed from the queue.
GeneratedMsgCount Number of messages generated (report / event).
Shortest time a message remained on the queue before being retrieved
TimeOnQMin
(in microseconds).
Average time a message remained on the queue before being retrieved
TimeOnQAvg
(in microseconds).

© Copyright IBM Corp. 2014 Exercise 11. Monitoring and configuring IBM MQ for performance 11-9
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Table 2: Queue accounting fields


QueueManager Name of the queue manager
Longest time a message remained on the queue before being retrieved
TimeOnQMax
(in microseconds).
__ 8. Use the WebSphere MQ Explorer MS0P SupportPac to display the accounting data inside
MQ Explorer.
__ a. The amqsmon program clears the accounting statistics on the
SYSTEM.ADMIN.ACCOUNTING. QUEUE. Rerun the amqsput and amqsget sample
programs to generate accounting data.
__ b. After you are done running the sample programs, right-click QMC01 and click Event
Messages > Accounting records.
__ c. Click OK to accept the default values.
__ d. In the Events and Statistics tab, expand Active Application Count. You see a number
of entries for every application by using IBM MQ.
__ e. Expand the entries for amqsget and amqsput.
__ f. Expand the entries in Number of Queues for each of these two entries and examine the
data that was collected in ACCTG.STATS.Q1.

Note

Your statistics might not exactly match the example.

11-10 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty Step 4: Generate and view statistics data


In this step, you use the IBM MQ sample programs to:
• Put and get messages from a local queue
• Generate local queue statistics to put messages on a remote queue
• Generate statistics data for a channel
After the statistics are generated, you review the statistics data.

Note

This part of the exercises assumes that you successfully completed Exercise 7, “Connecting queue
managers”.

__ 1. Restart queue manager QMR01 and verify that the listener is running.
__ 2. In MQ Explorer, connect the remote queue manager QMR01 on ‘localhost(9000)’.
__ 3. Define a new local queue that is named STATS.Q1 on QMC01.
__ 4. Define a remote queue that is called STATS.Q1.REMOTE on QMC01 for the STATS.Q1
queue on queue manager QMR01.
Set the following remote queue definition properties:
• Remote queue: STATS.Q1
• Remote queue manager: QMR01
• Transmission queue: QMR01
__ 5. Create a new local queue on QMC01 that is called STATS.Q2.
__ 6. You should now have three queues on QMC01 for statistics:
• A local queue that is named STATS.Q1
• A remote queue that is named STATS.Q1.REMOTE
• A local queue that is named STATS.Q2
__ 7. Start the sender channel QMC01.QMR01.
Ensure that the channel is in the “Running” status before continuing.

Note

The QMC01.QMR01 channel is the same channel that was used in Exercise 7, “Connecting queue
managers”.

__ 8. Create a local queue on QMR01 that is named STATS.Q1.

© Copyright IBM Corp. 2014 Exercise 11. Monitoring and configuring IBM MQ for performance 11-11
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 9. Return to the command window you used to run the amqsput program.
Run amqsput again to put messages to the remote queue definition on queue manager
QMC01 to send messages over the channel from QMC01 to QMR01.
This command writes messages to the transmission queue (QMR01), which then is sent
across the channel to queue manager QMR02.

Windows

In the command window, type:


amqsput STATS.Q1.REMOTE QMC01 < C:\labfiles\Lab11\data\statsdata.txt

Linux

In the terminal window, type:


amqsput STATS.Q1.REMOTE QMC01 < /usr/labfiles/Lab11/data/statsdata.txt

__ 10. Verify that you have 536 message on STATS.Q1 on QMR01.


__ 11. Use the amqsput program to write messages to STATS.Q2 on QMC01.

Windows

In the command window, type:


amqsput STATS.Q2 QMC01 < C:\labfiles\Lab11\data\statsdata.txt

Linux

In the terminal window, type:


amqsput STATS.Q2 QMC01 < /usr/labfiles/Lab11/data/statsdata.txt

__ 12. Verify that you have 536 messages on STATS.Q2 on QMC01.


__ 13. Use the amqsget sample program to read the messages off the STATS.Q2 queue.
In the command window, type:
amqsget STATS.Q2 QMC01
__ 14. Use the sample program amqsmon to read the accounting PCF messages from
SYSTEM.ADMIN.STATISTICS.QUEUE.
Return to the window that you used to run amqsmon.

11-12 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty
Windows

In the command window, type:


amqsmon –m QMC01 –t statistics > c:\labfiles\Lab11\statistics.txt

Linux

In the terminal window, type:


amqsmon –m QMC01 –t statistics > /usr/labfiles/Lab11/data/statistics.txt

__ 15. Open file statistics.txt in a text editor.


__ 16. The file contains several statistics messages that your tests generate. There are at least
three statistics messages that are generated in each statistics interval (that is, as it is
specified on the Statistics Interval Queue Manager property).
One message shows queue manager statistics. One message is generated for each queue
to show queue statistics. One message is the one that was generated for each channel to
show channel statistics.
Examine the file and locate the following messages:
• The queue manager statistics message for the test period
• The queue statistics message for STATS.Q2 for the test period
• The queue statistics message for QMR01 (that is, the transmission queue that is used to
send messages to your other queue manager)
• The channel statistics message for QMC01.QMR01 for the test period
__ 17. Rerun the tests to put messages on the local and remote queues.
__ 18. Examine the same statistics by using the MS0P SupportPac in MQ Explorer.
__ a. Right-click QMC01 > Event Messages > Statistics Records.
__ b. Click OK to accept the default values.
__ 19. Locate the following data:
• The queue manager statistics message for the test period
• The queue statistics message for STATS.Q2 for the test period
• The queue statistics message for QMR01 (that is, the transmission queue that is used to
send messages to your other queue manager)
• The channel statistics message for QM1.QM2 for the test period

© Copyright IBM Corp. 2014 Exercise 11. Monitoring and configuring IBM MQ for performance 11-13
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Note

It might take a few minutes to update the data in MQ Explorer.


If you do not see the statistics for both the queues (QMR01 and STATS.Q2), refresh the view or
close the Events and Statistics tab and then repeat Step 18.

11-14 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty Step 5: Configure a queue manager for online monitoring


In this section, you configure a queue manager for online monitoring. By default, online monitoring
data is not collected. It must be enabled by using a set of queue manager attributes.
The configuration of monitoring data collection has three values to enable the collection of data
(LOW, MEDIUM, and HIGH). Collecting monitoring data might require that you run some
instructions that affect performance (for example, obtaining system time).To reduce the impact of
online monitoring, the resource-intensive measurements are sampled instead of measuring every
value.
The online monitoring values can be set on each queue manager. The configuration is controlled by
using a set of queue manager, queue, and channel attributes. These values, can be set by using
the MQ Explorer or MQSC commands; the instructions in this exercise are for MQ Explorer.
__ 1. In MQ Explorer, open the properties for queue manager QMC01.
__ 2. Select Online monitoring.
Three queue manager properties control online monitoring:
• Channel monitoring (MONCHL) controls the collection of online monitoring data for
channels.
• Queue monitoring (MONQ) controls the collection of online monitoring data for queues.
• Auto CLUSSDR monitoring (MONACLS) controls the collection of monitoring data for
cluster sender channels.
__ 3. Activate recording of statistics for channels and queues. In the Online Monitoring
properties for QMC01, set the following values:
• Channel monitoring: High
• Queue monitoring: High
__ 4. Create a local queue on QMC01 that is named STATS.Q3.
__ 5. Run the amqsput sample program with the statsdata.txt file to put 536 messages on
STATS.Q3.
__ 6. Run the amqsget sample program against STATS.Q3 to get the messages.
__ 7. Review the generated online monitoring data for QMC01 by using MQSC commands.
In the MQSC session for QMC01, type:
DIS QSTATUS(STATS.Q3) MONITOR
This command displays the monitoring data for the queue. Table 3 summarizes the
monitoring fields.
Table 3:
The interval between when messages are put on the queue and when
QTIME they are destructively read. The value is shown in microseconds,
formatted into a string of up to 9 digits.
Date on which the last message was put to the queue since queue
LPUTDATE
manager started. If no PUT date is available, then the value is blank.

© Copyright IBM Corp. 2014 Exercise 11. Monitoring and configuring IBM MQ for performance 11-15
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Table 3:
Time at which the last message was put to the queue since the queue
LPUTTIME
manager start. If no put time is available, the value shows as blank.
Date on which the last message was retrieved from the queue since the
queue manager start. A message that is browsed does not count as a
LGETDATE
retrieved message. If no get date is available, the value is shown as
blank.
Time at which the last message was retrieved from the queue since the
queue manager start. A browsed message does not count as a
LGETTIME
retrieved message. If no get time is available, the value is shown as
blank.
Current level of monitoring data collection for the queue. Possible
MONQ
values: OFF, LOW, MEDIUM, HIGH.
Age, in seconds, of the oldest message on the queue. The maximum
MSGAGE displayable value is 999 999 999. If the age exceeds this value, 999
999 999 is displayed.
__ 8. Disable statistics monitoring on the QMC01 queue manager.
__ 9. Disable accounting monitoring on the QMC01 queue manager.
__ 10. Disable online monitoring on the QMC01 queue manager.
End of exercise

11-16 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0
Student Exercises

EXempty Exercise review and wrap-up


You should now be able to:
• Enable accounting and statistics collection in IBM MQ
• View accounting, statistics, and online monitoring data

© Copyright IBM Corp. 2014 Exercise 11. Monitoring and configuring IBM MQ for performance 11-17
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

11-18 IBM MQ V8 Administration © Copyright IBM Corp. 2014


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V9.0

backpg
Back page

You might also like