<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<section xml:id="pdo-ibm.configuration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table>
   <title>PDO_IBM 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-ibm.configuration.list">
     <row>
      <entry><link linkend="ini.pdo-ibm.i5-dbcs-alloc">pdo_ibm.i5_dbcs_alloc</link></entry>
      <entry>"0"</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Added in PDO_IBM 1.5.0</entry>
     </row>
     <row>
      <entry><link linkend="ini.pdo-ibm.i5-override-ccsid">pdo_ibm.i5_override_ccsid</link></entry>
      <entry>"0"</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Added in PDO_IBM 1.5.0</entry>
     </row>
    </tbody>
   </tgroup>
  </table>
  &ini.php.constants;
</para>

&ini.descriptions.title;

 <para>
  <variablelist>
   <varlistentry xml:id="ini.pdo-ibm.i5-dbcs-alloc">
    <term>
     <parameter>pdo_ibm.i5_dbcs_alloc</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      This options affects the internal buffer allocation strategy on IBM i.
      By default, this option is 0. When this option is set, buffers are
      allocated with a much larger size, in case the database is misleading
      about character size when converting between encodings. This option uses
      six times as much memory for buffers (to account for the largest possible
      UTF-8 sequences), but may be needed if truncated data is returned.
      <itemizedlist>
       <listitem>
        <para>
         0 - Minimum size buffers are allocated.
        </para>
       </listitem>
       <listitem>
        <para>
         1 - Larger size buffers are allocated.
        </para>
       </listitem>
      </itemizedlist>
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.pdo-ibm.i5-override-ccsid">
    <term>
     <parameter>pdo_ibm.i5_override_ccsid</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      The ASCII CCSID to use for conversion from EBCDIC on IBM i. Setting this
      to 1208 will use UTF-8. By default, this is 0, which will select the
      default ASCII job CCSID.
     </para>
     <para>
      To learn more about CCSIDs on IBM i, consult the
      <link xlink:href="https://www.ibm.com/docs/en/i/7.5?topic=information-ccsid-reference">IBM documentation</link>.
     </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
-->
