MYSTATS README
==============

1.0 Introduction
----------------
This archive contains two versions of the MyStats utility. This reports on the resource usage between two snapshots in an active database session. It is a combination of Jonathan Lewis's SNAP_MY_STATS package and my own re-factoring of Tom Kyte's runstats utility (also available via www.oracle-developer.net). I've also added some functionality and flexibility around the statistics reporting section.

2.0 Versions
------------
There are two versions provided:

2.1 mystats_pkg.sql
- - - - - - - - - -
This creates via a single PL/SQL package named MYSTATS_PKG. This uses invoker rights and dynamic SQL to workaround the common issue whereby developers are not given explicit grants on the required V$ views but have V$ access via a role. See the comments in the package header for more details and usage instructions.

2.2 mystats.sql
- - - - - - - -
This version is a standalone SQL*Plus script that runs MyStats from your SQLPATH without the need to create any database objects. This can be used if you are not able to create the PL/SQL package version of MyStats. See the comments in the script header for more details and usage instructions.

3.0 Version History
-------------------
Version  Date            Description
-------- --------------- --------------------------------------------
1.0      June 2007       Original version
1.1      January 2009    Added extended reporting options
2.0      October 2011    Re-design for standalone script version
2.01     November 2011   Bug-fix for numeric overflow

4.0 Credits
-----------
Credit is given to Jonathan Lewis for his original idea of taking two snapshots to identify resource consumption.

5.0 Disclaimer
--------------
See http://www.oracle-developer.net/disclaimer.php

Adrian Billington
(c) www.oracle-developer.net