<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<section xml:id="odbc.configuration" xmlns="http://docbook.org/ns/docbook">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table>
   <title>Unified 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="odbc.configuration.list">
     <row>
      <entry><link linkend="ini.uodbc.default-db">odbc.default_db</link> *</entry>
      <entry>NULL</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.uodbc.default-user">odbc.default_user</link> *</entry>
      <entry>NULL</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.uodbc.default-pw">odbc.default_pw</link> *</entry>
      <entry>NULL</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.uodbc.allow-persistent">odbc.allow_persistent</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.uodbc.check-persistent">odbc.check_persistent</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.uodbc.max-persistent">odbc.max_persistent</link></entry>
      <entry>"-1"</entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.uodbc.max-links">odbc.max_links</link></entry>
      <entry>"-1"</entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.uodbc.defaultlrl">odbc.defaultlrl</link></entry>
      <entry>"4096"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.uodbc.defaultbinmode">odbc.defaultbinmode</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.uodbc.defaultcursortype">odbc.default_cursortype</link></entry>
      <entry>"3"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
    </tbody>
   </tgroup>
  </table>
  <note>
   <simpara>
    Entries marked with * are not implemented yet.
   </simpara>
  </note>
  &ini.php.constants;
 </para>
 
 &ini.descriptions.title;
 
 <para>
 <variablelist>
   <varlistentry xml:id="ini.uodbc.default-db">
   <term>
    <parameter>odbc.default_db</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     ODBC data source to use if none is specified in
     <function>odbc_connect</function> or
     <function>odbc_pconnect</function>.
    </para>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ini.uodbc.default-user">
   <term>
    <parameter>odbc.default_user</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     User name to use if none is specified in
     <function>odbc_connect</function> or
     <function>odbc_pconnect</function>.
    </para>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ini.uodbc.default-pw">
   <term>
    <parameter>odbc.default_pw</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     Password to use if none is specified in
     <function>odbc_connect</function> or
     <function>odbc_pconnect</function>.
    </para>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ini.uodbc.allow-persistent">
   <term>
    <parameter>odbc.allow_persistent</parameter>
    <type>bool</type>
   </term>
   <listitem>
    <para>
     Whether to allow persistent ODBC connections.
    </para>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ini.uodbc.check-persistent">
   <term>
    <parameter>odbc.check_persistent</parameter>
    <type>bool</type>
   </term>
   <listitem>
    <para>
     Check that a connection is still valid before reuse.
    </para>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ini.uodbc.max-persistent">
   <term>
    <parameter>odbc.max_persistent</parameter>
    <type>int</type>
   </term>
   <listitem>
    <para>
     The maximum number of persistent ODBC connections per process.
    </para>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ini.uodbc.max-links">
   <term>
    <parameter>odbc.max_links</parameter>
    <type>int</type>
   </term>
   <listitem>
    <para>
     The maximum number of ODBC connections per process, including
     persistent connections.
    </para>
   </listitem>
  </varlistentry>
   <varlistentry xml:id="ini.uodbc.defaultlrl">
   <term>
    <parameter>odbc.defaultlrl</parameter>
    <type>int</type>
   </term>
   <listitem>
    <para>
     Handling of LONG fields. Specifies the number of bytes returned to
     variables.
     See <function>odbc_longreadlen</function> for details.
    </para>

    &ini.shorthandbytes;

   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ini.uodbc.defaultbinmode">
   <term>
    <parameter>odbc.defaultbinmode</parameter>
    <type>int</type>
   </term>
   <listitem>
    <para>
     Handling of binary data.
     See <function>odbc_binmode</function> for details.
    </para>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ini.uodbc.defaultcursortype">
   <term>
    <parameter>odbc.default_cursortype</parameter>
    <type>int</type>
   </term>
   <listitem>
    <para>
     Controls the ODBC cursor model.
     Possible values are <constant>SQL_CURSOR_FORWARD_ONLY</constant>,
     <constant>SQL_CURSOR_KEYSET_DRIVEN</constant>,
     <constant>SQL_CURSOR_DYNAMIC</constant> and
     <constant>SQL_CURSOR_STATIC</constant> (default).
    </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
-->

