Professional Documents
Culture Documents
Disk Watcher
Dawn May
dmmay@us.ibm.com
Agenda
What is Disk Watcher?
How do I run Disk Watcher?
What data is collected by Disk Watcher?
How do I analyze Disk Watcher data?
What documentation is available?
Data beyond that available in tools such as Work with Disk Status
(WRKDSKSTS), Work with System Status (WRKSYSSTS), and
Work with System Activity (WRKSYSACT)
These tools do provide information concerning: disk I/O, paging
rates, CPU usage, and temporary storage usage
less more
detail detail
Applications
QAPYDW
Disk Watcher Database
I/O request files
Machine Interface
I/O Recorder
Disk 1 Per Configured Unit
From GO LICPGM:
IBM Systems Director Navigator for i is the Web console for managing IBM i
Much of the function that exists in System i Navigator, but with a browser user interface
Prerequisites
Object List
User Authority Mgt
*PUBLIC *EXCLUDE
QSYS *ALL X
PDI01 *USE
PDI02 *USE
PDI03 *USE
PDI04 *USE
PDI05 *USE
PDI06 *USE
PDI07 *USE
PDI08 *USE
PDI09 *USE
More...
Prerequisites, continued
To see the Disk Watcher definitions through the GUI, users need authority to the
QAPYDWDFN file in QUSRSYS
File is shipped with *PUBLIC *EXCLUDE
Object information
Determines whether object and program information will be collected
Performance considerations
Force record write
Determines when disk I/O data records will be written to the database files
To file ASP threshold
Refers to the ASP where the Disk Watcher database files are located
The maximum percent of this ASP that can be consumed
System ASP threshold
The maximum percent of the system ASP that can be consumed
Hardware File
Whether to collect the storage device resource information
This is necessary for viewing trace data via Investigate Data
Created for
n 1
QAPYDWTRC QAPYDWTDER
*TRACE
collection
n n
1 1
Optional for
QAPYDWPGMR QAPYDWOBJR
*TRACE
collection
Statistical Overviews
Disk Statistical Overview
Average response times and total I/Os for the entire collection
Good starting point to get an overview of the entire collection
Can view overviews by
Disk Pools
Disk Units
Disk Paths
Statistical Details
Statistical Details allow more precise analysis of the details of the statistical
Disk Watcher data
Table views only
Sort to find largest contributors
Can view details by
Disk Pools
Disk Units
Disk Paths
Trace
Trace requires the hardware
table and object information to
be collected
Viewing of detailed Disk Watcher
trace data in table form
Metrics for every I/O operation in
the collection
Get into the details .
What object the I/O is for
The program/procedure
that did the I/O
and more
Use filtering / sorting to
focus in on interesting data
Special considerations
Performance considerations
Disk Watcher data collector Included in the base operating system with 6.1 and
later
CL Commands
SI30482 should be loaded to ensure necessary hardware information is collected to view
trace data (6.1 release)
SI30723 should be loaded to ensure necessary object information is collected to view trace
data (6.1 release)
QAPYDWRUNI
One record per collection, updated every interval
QAPYDWINTI
One record per interval
Interval information
Interval number
Interval start time
Interval end time
ASP count
Disk unit path count
Data missed
If set, then consider using smaller collection interval
Condition status
QAPYSTATS
One record per device resource name per interval
Disk I/O statistics data
Interval number
Device resource name / ASP / Disk unit number
Data missed
Sector size
First and last I/O times
Minimum and maximum operation and queue times
I/O buckets
Sort I/O operations by total response time
Operation and queue times reported for each bucket
Bucket 1 = less than 100 microsecs
Bucket 2 = 100 to 199 microsecs
Bucket 8 = 6400 to 12799 microsecs
Bucket 3 = 200 to 399 microsecs
Bucket 9 = 12800 to 25599 microsecs
Bucket 4 = 400 to 799 microsecs
Bucket 10 = 25600 to 51199 microsecs
Bucket 5 = 800 to 1599 microsecs
Bucket 11 = 51200 to 102399 microsecs
Bucket 6 = 1600 to 3199 microsecs
Bucket 12 = 102400 to 204799 microsecs
Bucket 7 = 3200 to 6399 microsecs
Bucket 13 = 204800 microsecs and greater
QAPYDWTRC
One record per I/O operation
collected
Disk I/O trace data
Device resource name / ASP / Disk
unit number
Segment key
Key to join with QAPYDWOBJR file
Program or procedure key
Key to join with QAPYDWPGMR file
Task count
Key to join with QAPYDWTDER file
Deferred queue depth Pool number
I/O flags (multi-path, synchronous) Deferred queue time
I/O type (read / write) Start time of I/O operation
Disk subunit (if part of mirrored pair) End time of I/O operation
QAPYDWTDER
One record per TDE which caused an I/O operation
Task Dispatching Element (TDE) resolution data
Task count
Key to join with QAPYDWTRC file
Unique identifier for the TDE, cannot be reused prior to IPL
Thread ID
Primary thread task count
TDE type
I = Initial (primary) thread
S = Secondary thread
T = Task
L = Lisenced Internal Code (LIC) thread
Qualified job name or task name
Current user
QAPYDWPGMR
One record per program which caused an I/O operation
Program resolution data
Procedure key
Key to join with QAPYDWTRC
Object type
Object subtype
Library name
Program name
Module name
Procedure name
QAPYDWOBJR
One record per object on which an I/O operation was performed
Object resolution data
Segment key
Key to join with QAPYDWTRC
Segment type
Object type
Object subtype
Object name
Context name (library)
Object ASP
IFS path name
Object type/subtype details available here:
http://publib.boulder.ibm.com/infocenter/iseries/v5r4/topic/rbam6/rbam6objecttypes.htm
Common type/subtype combos not documented on the webpage above:
Hex 0B90 = Database member
Hex 0C90 = Index member
QAPYDWHDWR
Contains output from Display Hardware Resources
(DSPHDWRSC) command
Hardware data captured at beginning of collection
V5R3/V5R4: Triggered by setting an environment variable
ADDENVVAR QPY_DW_HDWR_OPT 1
6.1: STRDW parameter Hardware file HDWF
PTF SI30482 to change default to *YES
Special notices
This document was developed for IBM offerings in the United States as of the date of publication. IBM may not make these offerings available in
other countries, and the information is subject to change without notice. Consult your local IBM business contact for information on the IBM
offerings available in your area.
Information in this document concerning non-IBM products was obtained from the suppliers of these products or other public sources. Questions
on the capabilities of non-IBM products should be addressed to the suppliers of those products.
IBM may have patents or pending patent applications covering subject matter in this document. The furnishing of this document does not give
you any license to these patents. Send license inquires, in writing, to IBM Director of Licensing, IBM Corporation, New Castle Drive, Armonk, NY
10504-1785 USA.
All statements regarding IBM future direction and intent are subject to change or withdrawal without notice, and represent goals and objectives
only.
The information contained in this document has not been submitted to any formal IBM test and is provided "AS IS" with no warranties or
guarantees either expressed or implied.
All examples cited or described in this document are presented as illustrations of the manner in which some IBM products can be used and the
results that may be achieved. Actual environmental costs and performance characteristics will vary depending on individual client configurations
and conditions.
IBM Global Financing offerings are provided through IBM Credit Corporation in the United States and other IBM subsidiaries and divisions
worldwide to qualified commercial and government clients. Rates are based on a client's credit rating, financing terms, offering type, equipment
type and options, and may vary by country. Other restrictions may apply. Rates and offerings are subject to change, extension or withdrawal
without notice.
IBM is not responsible for printing errors in this document that result in pricing or information inaccuracies.
All prices shown are IBM's United States suggested list prices and are subject to change without notice; reseller prices may vary.
IBM hardware products are manufactured from new parts, or new and serviceable used parts. Regardless, our warranty terms apply.
Any performance data contained in this document was determined in a controlled environment. Actual results may vary significantly and are
dependent on many factors including system hardware configuration and software design and configuration. Some measurements quoted in this
document may have been made on development-level systems. There is no guarantee these measurements will be the same on generally-
available systems. Some measurements quoted in this document may have been estimated through extrapolation. Users of this document
should verify the applicable data for their specific environment.
The Power Architecture and Power.org wordmarks and the Power and Power.org logos and related marks are trademarks and service marks licensed by Power.org.
UNIX is a registered trademark of The Open Group in the United States, other countries or both.
Linux is a registered trademark of Linus Torvalds in the United States, other countries or both.
Microsoft, Windows and the Windows logo are registered trademarks of Microsoft Corporation in the United States, other countries or both.
Intel, Itanium, Pentium are registered trademarks and Xeon is a trademark of Intel Corporation or its subsidiaries in the United States, other countries or both.
AMD Opteron is a trademark of Advanced Micro Devices, Inc.
Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United States, other countries or both.
TPC-C and TPC-H are trademarks of the Transaction Performance Processing Council (TPPC).
SPECint, SPECfp, SPECjbb, SPECweb, SPECjAppServer, SPEC OMP, SPECviewperf, SPECapc, SPEChpc, SPECjvm, SPECmail, SPECimap and SPECsfs are
trademarks of the Standard Performance Evaluation Corp (SPEC).
NetBench is a registered trademark of Ziff Davis Media in the United States, other countries or both.
AltiVec is a trademark of Freescale Semiconductor, Inc.
Cell Broadband Engine is a trademark of Sony Computer Entertainment Inc.
InfiniBand, InfiniBand Trade Association and the InfiniBand design marks are trademarks and/or service marks of the InfiniBand Trade Association.
Other company, product and service names may be trademarks or service marks of others.