This is README file for package ora_mail.

    I. Prerequisits
1. Oracle client and header files for building OCI applications
    Check for existance of $ORACLE_HOME/rdbms/demo/demo_rdbms.mk
    to find out if you have it installed
2. MTA installed on same machine as oracle server.
    Preferably qmail. Sendmail will work with
    trivial modifications.

    II. Installation instructions
1. Unpack package and cd into its dirrectory
2. run "make"
3. run "make install" as root
4. login into your oracle database as "system"
5. run mail.sql

    III. Using ora_mail
Using it is very simple:
1. decalre variable of type iv_mail.msg
    msg iv_mail.msg;
2. initialize it using iv_mail.init_msg
    iv_mail.init_msg(msg,'me@mydomain.com','you@yourdomain.com','testing oracle mail')
    where me@maydomain.coom is email address of sender,
    you@yourdomain.com is email address of recepient,
    and last parameter is subject of message.
3. create body of message using iv_mail.write and iv_mail.writeln procedures
    iv_mail.writeln(msg, 'Dear you,');
    iv_mail.writeln(msg, 'Allow me to introduce myself.');
    iv_mail.writeln(msg, 'I''m a fscking spammer, using Oracle database to store');
    iv_mail.writeln(msg, 'all information about you. If you want to be removed from');
    iv_mail.writeln(msg, 'this mailing list, just send an email to AddMeToAllLists@spammers.com');

    Difference between write and writeln is that writeln adds carriege
    return after the text.
4. send message out using iv_mail.send
    iv_mail.send(msg);
    This will send message and clean up msg structure. If you
    want to discard message without sending it, you must call
    iv_mail.discard

That's it Folks, enjoy.

    IV. Contact info
Author: <Ilya A. Volynets> ilya@theIlya.com

    V. Copyleft
This program is distributed under LGPL - Lesser Gnu General Public Licence.
For more information see file Copying.

    VI. Disclaimer

 THIS SOFTWARE IS PROVIDED BY THE TOTAL KNOWLEDGE ``AS IS''
 AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
 TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
 PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE TOTAL 
 KNOWLEDGE SOFTWARE OR ITS CONTRIBUTORS OR SUBSIDIARIES BE LIABLE
 FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, 
 OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT 
 OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
 OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
 WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
 OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 
 ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.


