==================================================================
Top100 - The Oracle Shared Pool Profiler
Copyright (c) 1995-2003 by Material Dreams.
All Rights Reserved.
http://www.materialdreams.com/oracle
==================================================================


PURPOSE:
========
Oracle Top100 is a Windows utility for Oracle Databases allowing
you to profile the statements in the global SQL Area of your RDBMS.
Top100 allows you to select filter and order the statements in the
SGA with a very simple to use interface and to find the SQL statements
that need to be further examined or optimized.
The table allows you sort by each column just by clicking on the
column header. You can look at the complete statement, see it's
execution plan and modify it.


LICENSE:
========
Please consult the License.TXT file for licensing information
and on how to register this application.


INSTALLATION:
=============
Copy the files in the distribution archive to a convenient directory.
Typically, I keep these files in a directory along with other small
Oracle utilities.


ORACLE CONNECTIVITY:
====================
All Material Dreams utilities access Oracle natively via the Oracle Call
Interface (OCI). The Oracle Call Interface is a component of the SQL*Net
or Net8 installation and consist of a set of DLL's.
No additional drivers or DLL's are needed to connect to an Oracle server.
All our utilities support most of the OCI versions by dynamically loading
the appropriate DDL's at runtime. The most current DDL will be loaded
automatically by evaluating the following list of supported versions:

The following OCI version are currently supported:

Version	DLL Name	Comment
------- ---------------	--------------------
9.1.x	oraclient9.dll	using the oci8 api
8.1.x	oraclient8.dll	using the oci8 api
8.0.5	ora805.dll	using the oci8 api
8.0.4	ora804.dll	using the oci8 api
8.0.3	ora803.dll	using the oci8 api
7.3.x	ora73.dll	using the oci7 api
7.2.x	ora72.dll	using the oci7 api
7.1.x	orant71.dll	using the oci7 api


USAGE:
======
Just start the executable with or without command line arguments.
It is possible to specify all needed command line arguments or
to only specify the -u, -p and -s arguments to automatically log
into the oracle server.

The following command line arguments will be processed:
Usage: Top100 -u -p -s -v -d -h
       -u ... user name
       -p ... password
       -s ... server
       -v ... oci interface version (7 or 8)
       -c ... connect as (NORMAL, SYSDBA, SYSOPER)
       -d ... debugging level (0-15)
       -h ... help

I you want to use this utility should connect as a user with administrative rights
like the sys or system.
You can also use the utility with a more restricted set of rights granted to you but
will not be able to see all executiopn plans.
The minimal set of grants needed to use Top100 are shown in the following example
user called Top100:

create user top100 identified by top100;
grant unlimited tablespace to Top100;
grant alter system to top100;
grant create session to top100;
grant alter session to top100;
grant all on plan_table to top100;
grant select any table to top100;
grant select on sys.v_$version to top100;
grant select on sys.v_$database to top100;
grant select on sys.all_users to top100;
grant select on sys.v_$sqlarea to top100;
grant select on sys.v_$sqltext_with_newlines to top100;
grant create procedure to top100;
grant create table to top100;
grant analyze any to top100;
grant execute any procedure to top100;
grant execute on sys.dbms_sql to top100;
grant execute on sys.dbms_sys_sql to top100;
grant execute on sys.dbms_pipe to top100;


VERSION HISTORY:
================
The complete version history can be found in the file HISTORY.TXT
