# $Id: README,v 1.10 2003/07/19 09:18:32 oradb Exp $

DESCRIPTION

A Perl (perldb-like) interface to the Oracle supplied DBMS_DEBUG package for debugging PL/SQL programs.

For more info see L<perldoc Oracle::Debug>

*** CAVEAT LECTOR ***

Note that this package is an alpha release!

That is, it is in a state which proves the concept; it works for me, in a bare-bones manner, and I am now working on making it more robust.

At the very least you will probably have to kill the target process with a CTRL-C or similar, but this should be harmless enough. Also, it is probably unlikely that you can reconnect in the middle of a debugger session, it is preferable to quit both sessions and start again, etc.

Debugging procedures appears possible, but packages have a problem. If you wrap the packaged procedure in an external procedure (like the example supplied), you should have no problems.

No-one else is expected to use this in anger yet, but you're welcome to try :-)

*** CAVEAT LECTOR ***

Full installation instructions and depencies are in the ./INSTALL file

See also the ./demo/oradb file which shows stepping through the accompanying procedure (./packages/xproc.sql) into an associated package (./packages/package.sql).

DEPENDENCIES

This module requires these modules and libraries:

        DBI
        DBD::Oracle

COPYRIGHT AND LICENCE

Copyright (C) 2003 Richard Foley

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.