<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->

<chapter xml:id="ibm-db2.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.setup;

 <!-- {{{ Requirements -->
 <section xml: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 xml: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>
 <!-- }}} -->

 <!-- {{{ Installation -->
 &reference.ibm-db2.configure;
 <!-- }}} -->

 <!-- {{{ Configuration -->
 &reference.ibm-db2.ini;
 <!-- }}} -->

 <!-- {{{ Resources -->
 <section xml:id="ibm-db2.resources">
  &reftitle.resources;
  <para>
   The ibm_db2 extension returns connection resources, statement resources,
   and result set resources.
  </para>
 </section>
 <!-- }}} -->

</chapter>

<!-- 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:"~/.phpdoc/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
-->

