==================================================================
PL/SQL-Debug - The Oracle PL/SQL Tracing Facility Version 2.2.2
Copyright (c) 1995-2001 by Material Dreams.
All Rights Reserved.
http://www.materialdreams.com
==================================================================


PURPOSE:
========
PL/SQL-Debug is a simple Windows 95/NT GUI application for Oracle
that allows you to easily trace messages from any PL/SQL code.
Using pipes allows to overcome the limitations of the DBMS_OUTPUT
package and also allows to have a almost immediate feedback from the
PL/SQL Code.
This application is distributed as a shareware product.
The version You can download is a demo version that gives You the full
functionality by only restricting the total number of logging lines to 50.
See Registration, below, for information on how to register your copy.


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


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

This utility used the native Oracle OCI (Oracle Call Interface) to
access the Oracle server. No additional drivers are needed to connect
to an Oracle server. OCI itself is the low-level API that allows to use
SQL in an Oracle SQL*Net environment.

This 32-Bit version of TabExp used OCI Version 8.x. The specific DLL that
contains the OCI implementation is OCIW32.DLL.

Usually OCI is automatically installed during the installation process of
SQL*Net and should be always available.
 

USAGE:
======
Just start PlSqlDbg.EXE. After starting the application You might use the
options button in the toolbar to configure the application and to eventually create
the standard procedures to use. Another button on the toolbar starts the application
and retrieved the data as often as defined in the timer setting.
After the application has been started and You started the logging process, the application
will look for new debug messages on the pipe and show them in the edit window. The application
uses it's timer settings to check the pipe after the specified interval.
From Your PL/SQL Code you can use the following prepared procedures to send messages to
the application:
	SendDebugMessage(VARCHAR2)
	SendTraceMessage(VARCHAR2)
You can just simply use this procedures to send Your messages to the Application.
You must have the execute rights on the package dbms_pipe in order to use this application
and also to send messages to this application from Your PL/SQL code.
This can be done by connecting as a user with administrative rights (eg. sys or system)
and then granting the execute rights to Your user code.
eg.	grant execute on dbms_pipe to <username>;


VERSION HISTORY:
================

Version 2.2.2 - 28-DEC-2000
---------------------------
Internal changes and adapted to new CI.


Version 2.2.1 - 03-JUN-2000
---------------------------
A problem in the online registration process
has been corrected. You must use version 2.2.1
or higher in order to register the application
successfully.

Version 2.2.0 - 25-MAY-2000
---------------------------
The application now supports online registration
and will expire after a 30 day trial period.

Version 2.1.0 - 01-MAI-1999
---------------------------
o The application now allows to debug pipes with a variable
  structure. This can be enabled in the options with the
  'Allow to debug variable messages' flag.
  If this flag is activated the messages will be shown
  argument by argument where the type of each argument
  is at the begin of the line.
o A new toolbar button has been added to purge the contents
  of the currently used pipe.
o The procedured are now also shipped in the debug.sql script
  and do now use a default argument to specify the pipe.
o The options are now stored in the local preference key and will
  be used whenver the application will be started.
o A new flag allows to enable or disable editing in the debugging window.
o A problem with the Add LF flag has been fixed.

Version 2.0.0 - 05-FEB-1999
---------------------------
General changes:
Major new release using a new utility library for all tools.
New login dialog fixes problem with stored connection duplicates
and sets the correct keyboard focus when entering.
New about dialog allows to automatically send email and connect
to the products web page for updates.

Application specific changes:
A minor problem with the max size of a ipe message has been
fixed.

Version 1.1.0 - 18-APR-1998
---------------------------
Addep support for case sensitivity.
Scrolling has been fixed.
Automatic positioning in the last line.

Version 1.0.0 - 25-MAR-1998
---------------------------
First released version.
