<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.6 $ -->
<!-- Purpose: database.vendors -->
<!-- Membership: pecl, external -->

<reference id="ref.ibm-db2">
 <title>IBM DB2, Cloudscape and Apache Derby Functions</title>
 <titleabbrev>ibm_db2</titleabbrev>

 <partintro>
  <section id="ibm-db2.intro">
   &reftitle.intro;
   <para>
    These functions enable you to access IBM DB2 Universal Database, IBM
    Cloudscape, and Apache Derby databases using the DB2 Call Level Interface
    (DB2 CLI).
   </para>
  </section>
  <section id="ibm-db2.requirements">
   &reftitle.required;
   <para>
    To connect to IBM DB2 Universal Database for Linux, UNIX, and Windows, or
    IBM Cloudscape, or Apache Derby, you must install an IBM DB2 Universal
    Database client on the same computer on which you are running PHP. The
    extension has been developed and tested with DB2 Version 8.2.
   </para>
   <para>
    To connect to IBM DB2 Universal Database for z/OS or iSeries, you also
    require IBM DB2 Connect or the equivalent DRDA gateway software.
   </para>
   <section id="ibm-db2.requirements.unix">
    <title>Requirements on Linux or Unix</title>
    <para>
     The user invoking the PHP executable or SAPI must specify the DB2 instance
     before accessing these functions. You can set the name of the DB2 instance
     in &php.ini; using the <literal>ibm_db2.instance_name</literal>
     configuration option, or you can source the DB2 instance profile before
     invoking the PHP executable.
    </para>
    <para>
     If you created a DB2 instance named <literal>db2inst1</literal> in
     <filename>/home/db2inst1/</filename>, for example, you can add the
     following line to &php.ini;:
     <screen>
<![CDATA[
ibm_db2.instance_name=db2inst1
]]>
     </screen>
     If you do not set this option in &php.ini;, you must issue the
     following command to modify your environment variables to enable access to
     DB2:
     <screen>
<![CDATA[
bash$ source /home/db2inst1/sqllib/db2profile
]]>
     </screen>
     To enable your PHP-enabled Web server to access these functions, you must
     either set the <literal>ibm_db2.instance_name</literal> configuration
     option in &php.ini;, or source the DB2 instance environment in your Web
     server start script (typically <filename>/etc/init.d/httpd</filename> or
     <filename>/etc/init.d/apache</filename>).
    </para>
   </section>
  </section>

  <!-- Information found in configure.xml -->
  &reference.ibm-db2.configure;
  <!-- Information found in ini.xml -->
  &reference.ibm-db2.ini;
  &reference.ibm-db2.constants;

  <section id="ibm-db2.resources">
   &reftitle.resources;
   <para>
    The ibm_db2 extension returns connection resources, statement resources,
    and result set resources.
   </para>
  </section>
 </partintro>
 &reference.ibm-db2.functions;
</reference>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->