<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<section xml:id="pdo-odbc.configuration" xmlns="http://docbook.org/ns/docbook">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table>
   <title>PDO_ODBC Configuration Options</title>
   <tgroup cols="4">
    <thead>
     <row>
      <entry>&Name;</entry>
      <entry>&Default;</entry>
      <entry>&Changeable;</entry>
      <entry>&Changelog;</entry>
     </row>
    </thead>
    <tbody xml:id="pdo-odbc.configuration.list">
     <row>
      <entry><link linkend="ini.pdo-odbc.connection-pooling">pdo_odbc.connection_pooling</link></entry>
      <entry>"strict"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.pdo-odbc.db2-instance-name">pdo_odbc.db2_instance_name</link></entry>
      <entry>NULL</entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry>&removed.php.future;</entry>
     </row>
    </tbody>
   </tgroup>
  </table>
  &ini.php.constants;
</para>

&ini.descriptions.title;

<para>
 <variablelist>
   <varlistentry xml:id="ini.pdo-odbc.connection-pooling">
   <term>
    <parameter>pdo_odbc.connection_pooling</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     Whether to pool ODBC connections. Can be one of <literal>"strict"</literal>,
     <literal>"relaxed"</literal> or <literal>"off"</literal> (equals to
     <literal>""</literal>). The parameter describes how strict the connection
     manager should be when matching connection parameters to existing pooled
     connections.  <userinput>strict</userinput> is the recommend default, and
     will result in the use of cached connections only when all the connection
     parameters match exactly.  <userinput>relaxed</userinput> will result in
     the use of cached connections when similar connection parameters are
     used.  This can result in increased use of the cache, at the risk of
     bleeding connection information between (for example) virtual hosts.
    </para>
    <para>
     This setting can only be changed from the &php.ini;
     file, and affects the entire process; any other modules loaded into the
     process that use the same ODBC libraries will be affected too, including
     the <link linkend="ref.uodbc">Unified ODBC extension</link>.
    </para>
    <warning>
     <para>
      <userinput>relaxed</userinput> matching should not be used on a shared
      server, for security reasons.
     </para>
    </warning>
    <tip>
     <para>
      Leave this setting at the default <userinput>strict</userinput> setting
      unless you have good reason to change it.
     </para>
    </tip>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ini.pdo-odbc.db2-instance-name">
   <term>
    <parameter>pdo_odbc.db2_instance_name</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     If you compile PDO_ODBC using the <literal>db2</literal> flavour,
     this setting sets the value of the DB2INSTANCE environment variable on
     Linux and UNIX operating systems to the specified name of the DB2
     instance. This enables PDO_ODBC to resolve the location of the DB2
     libraries and make cataloged connections to DB2 databases.
    </para>
    <para>
     This setting can only be changed from the &php.ini;
     file, and affects the entire process; any other modules loaded into the
     process that use the same ODBC libraries will be affected too, including
     the <link linkend="ref.uodbc">Unified ODBC extension</link>.
    </para>
    <para>
     This setting has no effect on Windows.
    </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
-->
