<?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>
<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>integer</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>integer</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>integer</type>
</term>
<listitem>
<para>
This option controls the commit mode used for i5 schema collections
in the PHP application.
<itemizedlist>
<listitem>
<para>
0 no commit (see <parameter>i5_commit</parameter> for override)
</para>
</listitem>
<listitem>
<para>
1 allow commit (see <parameter>i5_commit</parameter> for override)
</para>
</listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ibm-db2.i5-dbcs-alloc">
<term>
<parameter>ibm_db2.i5_dbcs_alloc</parameter>
<type>integer</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>integer</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
-->