<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<section xml:id="ibm-db2.configuration" xmlns="http://docbook.org/ns/docbook">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table>
   <title>ibm_db2 &ConfigureOptions;</title>
   <tgroup cols="4">
    <thead>
     <row>
      <entry>&Name;</entry>
      <entry>&Default;</entry>
      <entry>&Changeable;</entry>
      <entry>Changelog</entry>
     </row>
    </thead>
    <tbody xml:id="ibm-db2.configuration.list">
     <row>
      <entry><link linkend="ini.ibm-db2.binmode">ibm_db2.binmode</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.ibm-db2.i5-all-pconnect">ibm_db2.i5_all_pconnect</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry>Available since ibm_db2 1.6.5.</entry>
     </row>     
     <row>
      <entry><link linkend="ini.ibm-db2.i5-allow-commit">ibm_db2.i5_allow_commit</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry>Available since ibm_db2 1.4.9.</entry>
     </row>
     <row>
      <entry><link linkend="ini.ibm-db2.i5-dbcs-alloc">ibm_db2.i5_dbcs_alloc</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry>Available since ibm_db2 1.5.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.ibm-db2.instance-name">ibm_db2.instance_name</link></entry>
      <entry>NULL</entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry>Available since ibm_db2 1.0.2.</entry>
     </row>
     <row>
      <entry><link linkend="ini.ibm-db2.i5-ignore-userid">ibm_db2.i5_ignore_userid</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry>Available since ibm_db2 1.8.0.</entry>
     </row>
    </tbody>
   </tgroup>
  </table>

 </para>
 
 &ini.descriptions.title;
 
 <para>
  <variablelist>
   <varlistentry xml:id="ini.ibm-db2.binmode">
    <term>
     <parameter>ibm_db2.binmode</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      This option controls the mode used for converting to and from binary
      data in the PHP application.
      <itemizedlist>
       <listitem>
        <para>
         1 (DB2_BINARY)
        </para>
       </listitem>
       <listitem>
        <para>
         2 (DB2_CONVERT)
        </para>
       </listitem>
       <listitem>
        <para>
         3 (DB2_PASSTHRU)
        </para>
       </listitem>
      </itemizedlist>
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.ibm-db2.i5-all-pconnect">
    <term>
     <parameter>ibm_db2.i5_all_pconnect</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      This option overrides i5 <function>db2_connect</function> full open and close in the PHP 
      application. When <parameter>ibm_db2.i5_all_pconnect</parameter> = 1, all db2 connections 
      become persistent (<function>db2_pconnect</function>). On i5/OS, <function>db2_pconnect</function> performs 
      dramatically better with lower machine stress over <function>db2_connect</function>. This 
      is a convenience override of <function>db2_connect</function> to evoke <function>db2_pconnect</function> without 
      PHP source code changes. 
      <itemizedlist>
       <listitem>
        <para>
         0 <function>db2_connect</function> default full open and close
        </para>
       </listitem>
       <listitem>
        <para>
         1 <function>db2_connect</function> override to <function>db2_pconnect</function> for persistent connection only
        </para>
       </listitem>
      </itemizedlist>
     </para>
    </listitem>
   </varlistentry>   
   <varlistentry xml:id="ini.ibm-db2.i5-allow-commit">
    <term>
     <parameter>ibm_db2.i5_allow_commit</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      This option controls the isolation mode used for i5 schema collections 
      in the PHP application (see <parameter>i5_commit</parameter> for override).
      <itemizedlist>
       <listitem>
        <para>
         0 - commitment control is not used 
        </para>
       </listitem>
       <listitem>
        <para>
         1 - read uncommitted, dirty reads possible.
        </para>
       </listitem>
       <listitem>
        <para>
         2 - read committed, dirty reads are not possible.
        </para>
       </listitem>
       <listitem>
        <para>
         3 - repeatable read, dirty reads and non-repeatable reads are not possible
        </para>
       </listitem>
       <listitem>
        <para>
         4 - serializeable, dirty reads, non-repeatable reads, and phantoms are not possible
        </para>
       </listitem>
      </itemizedlist>
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.ibm-db2.i5-dbcs-alloc">
    <term>
     <parameter>ibm_db2.i5_dbcs_alloc</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      This option controls the internal ibm_db2 allocation scheme 
      for large DBCS column buffers.
      <itemizedlist>
       <listitem>
        <para>
         0 no expanded allocations (see <parameter>i5_dbcs_alloc</parameter> for override)
        </para>
       </listitem>
       <listitem>
        <para>
         1 use expanded allocations (see <parameter>i5_dbcs_alloc</parameter> for override)
        </para>
       </listitem>
      </itemizedlist>
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.ibm-db2.instance-name">
    <term>
     <parameter>ibm_db2.instance_name</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      On Linux and UNIX operating systems, this option defines the name of the
      instance to use for cataloged database connections. If this option is set,
      its value overrides the DB2INSTANCE environment variable setting.
     </para>
     <para>
      This option is ignored on Windows operating systems.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.ibm-db2.i5-ignore-userid">
    <term>
     <parameter>ibm_db2.i5_ignore_userid</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      This option overrides i5 db2_(p)connect userid and password in the PHP 
      application. When  <parameter>ibm_db2.i5_ignore_userid</parameter> = 1, 
      all db2 (p)connections become null userid and null password. Therefore 
      Apache jobs connect with the current profile (NOBODY). Use of this override 
      is only for simple DB2 based websites that never require profile switching 
      and therefore can avoid all overhead of server mode additional QSQSRVR jobs. 
      This is a convenience override of db2_(p)connect to set the userid and password 
      values to null without PHP source code changes. This override can be used in 
      combination with <parameter>ibm_db2.i5_all_pconnect</parameter> = 1.
      <itemizedlist>
       <listitem>
        <para>
         0 db2_(p)connect with specified userid and password
        </para>
       </listitem>
       <listitem>
        <para>
         1 db2_(p)connect override connect with null userid and null password
        </para>
       </listitem>
      </itemizedlist>
     </para>
    </listitem>
   </varlistentry>
  </variablelist>
 </para>
</section>

<!-- 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
-->
