dbs Tue Apr 12 19:45:14 2005 EDT
Added files:
/phpdoc/en/reference/ibm_db2 configure.xml
Modified files:
/phpdoc/en/reference/ibm_db2 constants.xml reference.xml
/phpdoc/en/reference/ibm_db2/functions db2-autocommit.xml
db2-close.xml
db2-connect.xml
db2-pconnect.xml
Log:
Add real details and examples for basic functions.
http://cvs.php.net/diff.php/phpdoc/en/reference/ibm_db2/constants.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc/en/reference/ibm_db2/constants.xml
diff -u phpdoc/en/reference/ibm_db2/constants.xml:1.1
phpdoc/en/reference/ibm_db2/constants.xml:1.2
--- phpdoc/en/reference/ibm_db2/constants.xml:1.1 Tue Apr 12 17:12:48 2005
+++ phpdoc/en/reference/ibm_db2/constants.xml Tue Apr 12 19:45:14 2005
@@ -1,5 +1,5 @@
<?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc.
-->
<section id="ibm_db2.constants">
&reftitle.constants;
@@ -11,8 +11,7 @@
(<type>integer</type>)
</term>
<listitem>
- <simpara>
-
+ <simpara>
</simpara>
</listitem>
</varlistentry>
@@ -44,8 +43,10 @@
(<type>integer</type>)
</term>
<listitem>
- <simpara>
-
+ <simpara>
+ Specifies a scrollable cursor for a statement resource. This mode enables
+ random access to rows in a result set, but currently is supported only by
+ IBM DB2 Universal Database.
</simpara>
</listitem>
</varlistentry>
@@ -56,7 +57,8 @@
</term>
<listitem>
<simpara>
-
+ Specifies a forward-only cursor for a statement resource. This is the
+ default cursor type and is supported on all database servers.
</simpara>
</listitem>
</varlistentry>
@@ -67,7 +69,8 @@
</term>
<listitem>
<simpara>
-
+ Specifies the PHP variable should be bound as an IN parameter for a
+ stored procedure.
</simpara>
</listitem>
</varlistentry>
@@ -78,7 +81,8 @@
</term>
<listitem>
<simpara>
-
+ Specifies the PHP variable should be bound as an OUT parameter for a
+ stored procedure.
</simpara>
</listitem>
</varlistentry>
@@ -89,7 +93,8 @@
</term>
<listitem>
<simpara>
-
+ Specifies the PHP variable should be bound as an INOUT parameter for a
+ stored procedure.
</simpara>
</listitem>
</varlistentry>
@@ -100,7 +105,8 @@
</term>
<listitem>
<simpara>
-
+ Specifies that the column should be bound directly to a file for input or
+ output.
</simpara>
</listitem>
</varlistentry>
@@ -111,7 +117,7 @@
</term>
<listitem>
<simpara>
-
+ Specifies that autocommit should be turned on.
</simpara>
</listitem>
</varlistentry>
@@ -122,7 +128,7 @@
</term>
<listitem>
<simpara>
-
+ Specifies that autocommit should be turned off.
</simpara>
</listitem>
</varlistentry>
@@ -133,7 +139,8 @@
</term>
<listitem>
<simpara>
-
+ Specifies that the variable should be bound as a DOUBLE, FLOAT, or REAL
+ data type.
</simpara>
</listitem>
</varlistentry>
@@ -144,7 +151,8 @@
</term>
<listitem>
<simpara>
-
+ Specifies that the variable should be bound as a SMALLINT, INTEGER, or
+ BIGINT data type.
</simpara>
</listitem>
</varlistentry>
@@ -155,7 +163,7 @@
</term>
<listitem>
<simpara>
-
+ Specifies that the variable should be bound as a CHAR or VARCHAR data
type.
</simpara>
</listitem>
</varlistentry>
http://cvs.php.net/diff.php/phpdoc/en/reference/ibm_db2/reference.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc/en/reference/ibm_db2/reference.xml
diff -u phpdoc/en/reference/ibm_db2/reference.xml:1.1
phpdoc/en/reference/ibm_db2/reference.xml:1.2
--- phpdoc/en/reference/ibm_db2/reference.xml:1.1 Tue Apr 12 17:12:48 2005
+++ phpdoc/en/reference/ibm_db2/reference.xml Tue Apr 12 19:45:14 2005
@@ -1,35 +1,54 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc.
-->
<reference id="ref.ibm_db2">
- <title>ibm_db2 Functions</title>
+ <title>IBM DB2, Cloudscape and Apache Derby Functions</title>
<titleabbrev>ibm_db2</titleabbrev>
<partintro>
<section id="ibm_db2.intro">
&reftitle.intro;
<para>
- This is the ibm_db2 extension. It enables you to connect to IBM DB2
- Universal Database, IBM Cloudscape, or Apache Derby databases.
+ These functions enable you to access IBM DB2 Universal Database, IBM
+ Cloudscape, and Apache Derby databases using the DB2 Call Level Interface
+ (DB2 CLI).
</para>
</section>
<section id="ibm_db2.requirements">
&reftitle.required;
<para>
To connect to IBM DB2 Universal Database for Linux, UNIX, and Windows, or
- IBM Cloudscape, or Apache Derby, you must install an IBM DB2 client on the
- same computer on which you are running PHP.
+ IBM Cloudscape, or Apache Derby, you must install an IBM DB2 Universal
+ Database client on the same computer on which you are running PHP. The
+ extension has been developed and tested with DB2 Version 8.2.
</para>
<para>
To connect to IBM DB2 Universal Database for z/OS or iSeries, you also
require IBM DB2 Connect or the equivalent DRDA gateway software.
</para>
+ <para>
+ On Linux or Unix operating systems, ensure that the user invoking the
+ PHP executable or SAPI has sourced the DB2 instance environment before
+ accessing these functions. If you created a DB2 instance in
+ <filename>/home/db2inst1/</filename>, for example, you must issue the
+ following command to modify your environment variables to enable access to
+ DB2:
+ <screen>
+<![CDATA[
+bash$ source /home/db2inst1/sqllib/db2profile
+]]>
+ </screen>
+ To enable your PHP-enabled Web server to access these functions, you must
+ add the same command to your Web server start script (typically
+ <filename>/etc/init.d/httpd</filename> or
+ <filename>/etc/init.d/apache</filename>).
+ </para>
</section>
<!-- Information found in configure.xml -->
- <!--&reference.ibm_db2.configure;-->
+ &reference.ibm-db2.configure;
<!-- Information found in ini.xml -->
- <!--&reference.ibm_db2.ini;-->
+ <!--&reference.ibm-db2.ini;-->
&reference.ibm-db2.constants;
<section id="ibm_db2.resources">
http://cvs.php.net/diff.php/phpdoc/en/reference/ibm_db2/functions/db2-autocommit.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc/en/reference/ibm_db2/functions/db2-autocommit.xml
diff -u phpdoc/en/reference/ibm_db2/functions/db2-autocommit.xml:1.1
phpdoc/en/reference/ibm_db2/functions/db2-autocommit.xml:1.2
--- phpdoc/en/reference/ibm_db2/functions/db2-autocommit.xml:1.1 Tue Apr
12 17:12:48 2005
+++ phpdoc/en/reference/ibm_db2/functions/db2-autocommit.xml Tue Apr 12
19:45:14 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc.
-->
<refentry id="function.db2-autocommit">
<refnamediv>
@@ -17,6 +17,9 @@
</methodsynopsis>
&warn.experimental.func;
+ <para>
+ Sets or gets the AUTOCOMMIT behavior of the specified connection resource.
+ </para>
</refsect1>
<refsect1 role="parameters">
@@ -66,9 +69,9 @@
<para>
When <function>db2_autocommit</function> receives only the
<parameter>connection</parameter> parameter, it returns the current state
- of autocommit for the requested connection as an integer value. A value of
- 0 indicates that autocommit is off, while a value of 1 indicates that
- autocommit is on.
+ of AUTOCOMMIT for the requested connection as an integer value. A value of
+ 0 indicates that AUTOCOMMIT is off, while a value of 1 indicates that
+ AUTOCOMMIT is on.
</para>
<para>
When <function>db2_autocommit</function> receives both the
@@ -79,57 +82,26 @@
</para>
</refsect1>
- <!-- Use when EXCEPTIONS exist
- <refsect1 role="exceptions">
- &reftitle.exceptions;
- <para>
- When does this function throw exceptions?
- </para>
- </refsect1>
- -->
-
-
- <!-- Use when a CHANGELOG exists
- <refsect1 role="changelog">
- &reftitle.changelog;
- <para>
- <informaltable>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>&Version;</entry>
- <entry>&Description</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>Enter the PHP version of change here
- <entry>Description of change
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </para>
- </refsect1>
- -->
-
-
- <!-- Use when examples exist
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
- <title>A <function>db2_autocommit</function> example</title>
+ <title>Retrieving the AUTOCOMMIT value for a connection</title>
<para>
- Any text that describes the purpose of the example, or
- what goes on in the example should go here (inside the
- <example> tag, not out
+ In the following example, a connection which has been created with
+ AUTOCOMMIT turned off is tested with the
+ <function>db2_autocommit</function> function.
</para>
<programlisting role="php">
<![CDATA[
<?php
-if ($anexample === true) {
- echo 'Use the PEAR Coding Standards';
+$options = array('autocommit' => DB2_AUTOCOMMIT_OFF);
+$conn = db2_connect($database, $user, $password, $options);
+$ac = db2_autocommit($conn);
+if ($ac == 0) {
+ print "$ac -- AUTOCOMMIT is off."
+} else {
+ print "$ac -- AUTOCOMMIT is on."
}
?>
]]>
@@ -137,27 +109,60 @@
&example.outputs;
<screen>
<![CDATA[
-Use the PEAR Coding Standards
+0 -- AUTOCOMMIT is off.
]]>
</screen>
</example>
+ <example>
+ <title>Setting the AUTOCOMMIT value for a connection</title>
+ <para>
+ In the following example, a connection which was initially created with
+ AUTOCOMMIT turned off has its behavior changed to turn AUTOCOMMIT on.
+ </para>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$options = array('autocommit' => DB2_AUTOCOMMIT_OFF);
+$conn = db2_connect($database, $user, $password, $options);
+
+// Turn AUTOCOMMIT on
+$rc = db2_autocommit($conn, DB2_AUTOCOMMIT_ON);
+if ($rc) {
+ print "Turning AUTOCOMMIT on succeeded.\n"
+}
+
+// Check AUTOCOMMIT state
+$ac = db2_autocommit($conn);
+if ($ac == 0) {
+ print "$ac -- AUTOCOMMIT is off."
+} else {
+ print "$ac -- AUTOCOMMIT is on."
+}
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+Turning AUTOCOMMIT on succeeded.
+1 -- AUTOCOMMIT is on.
+]]>
+ </screen>
+ </example>
+
</para>
</refsect1>
- -->
-
- <!-- Use when adding See Also links
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
- <member><function></function></member>
- <member>Or <link linkend="somethingelse">something else</link></member>
+ <member><function>db2_connect</function></member>
+ <member><function>db2_pconnect</function></member>
+ <member><function>db2_setoption</function></member>
</simplelist>
</para>
</refsect1>
- -->
-
</refentry>
http://cvs.php.net/diff.php/phpdoc/en/reference/ibm_db2/functions/db2-close.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc/en/reference/ibm_db2/functions/db2-close.xml
diff -u phpdoc/en/reference/ibm_db2/functions/db2-close.xml:1.1
phpdoc/en/reference/ibm_db2/functions/db2-close.xml:1.2
--- phpdoc/en/reference/ibm_db2/functions/db2-close.xml:1.1 Tue Apr 12
17:12:48 2005
+++ phpdoc/en/reference/ibm_db2/functions/db2-close.xml Tue Apr 12 19:45:14 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc.
-->
<refentry id="function.db2-close">
<refnamediv>
@@ -15,7 +15,17 @@
<methodparam><type>resource</type><parameter>connection</parameter></methodparam>
</methodsynopsis>
- &warn.undocumented.func;
+ &warn.experimental.func;
+ <para>
+ This function closes a DB2 client connection created with
+ <function>db2_connect</function> and returns the corresponding
+ resources to the database server.
+ </para>
+ <para>
+ If you attempt to close a persistent DB2 client connection created with
+ <function>db2_pconnect</function>, the close request is ignored and the
+ persistent DB2 client connection remains available for the next caller.
+ </para>
</refsect1>
<refsect1 role="parameters">
@@ -26,7 +36,7 @@
<term><parameter>connection</parameter></term>
<listitem>
<para>
- Its description
+ Specifies an active DB2 client connection.
</para>
</listitem>
</varlistentry>
@@ -36,62 +46,26 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- What the function returns, first on success, then on failure. See
- also the &return.success; entity
- </para>
- </refsect1>
-
- <!-- Use when EXCEPTIONS exist
- <refsect1 role="exceptions">
- &reftitle.exceptions;
- <para>
- When does this function throw exceptions?
+ &return.success;
</para>
</refsect1>
- -->
-
- <!-- Use when a CHANGELOG exists
- <refsect1 role="changelog">
- &reftitle.changelog;
- <para>
- <informaltable>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>&Version;</entry>
- <entry>&Description</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>Enter the PHP version of change here
- <entry>Description of change
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </para>
- </refsect1>
- -->
-
-
- <!-- Use when examples exist
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
- <title>A <function>db2_close</function> example</title>
+ <title>Closing a connection</title>
<para>
- Any text that describes the purpose of the example, or
- what goes on in the example should go here (inside the
- <example> tag, not out
+ The following example demonstrates a successful attempt to close a
+ connection to an IBM DB2, Cloudscape, or Apache Derby database.
</para>
<programlisting role="php">
<![CDATA[
<?php
-if ($anexample === true) {
- echo 'Use the PEAR Coding Standards';
+$conn = db2_connect('SAMPLE', 'db2inst1', 'ibmdb2');
+$rc = db2_close($conn);
+if ($rc) {
+ echo "Connection was successfully closed.";
}
?>
]]>
@@ -99,27 +73,22 @@
&example.outputs;
<screen>
<![CDATA[
-Use the PEAR Coding Standards
+Connection was successfully closed.
]]>
</screen>
</example>
</para>
</refsect1>
- -->
-
- <!-- Use when adding See Also links
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
- <member><function></function></member>
- <member>Or <link linkend="somethingelse">something else</link></member>
+ <member><function>db2_connect</function></member>
+ <member><function>db2_pconnect</function></member>
</simplelist>
</para>
</refsect1>
- -->
-
</refentry>
http://cvs.php.net/diff.php/phpdoc/en/reference/ibm_db2/functions/db2-connect.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc/en/reference/ibm_db2/functions/db2-connect.xml
diff -u phpdoc/en/reference/ibm_db2/functions/db2-connect.xml:1.1
phpdoc/en/reference/ibm_db2/functions/db2-connect.xml:1.2
--- phpdoc/en/reference/ibm_db2/functions/db2-connect.xml:1.1 Tue Apr 12
17:12:48 2005
+++ phpdoc/en/reference/ibm_db2/functions/db2-connect.xml Tue Apr 12
19:45:14 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc.
-->
<refentry id="function.db2-connect">
<refnamediv>
@@ -143,9 +143,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- Returns a connection handle resource if the connection attempt was
- successful. If the connection attempt failed,
- <function>db2_connect</function> returns &false;.
+ Returns a connection handle resource if the connection attempt is
+ successful. If the connection attempt fails,
<function>db2_connect</function>
+ returns &false;.
</para>
</refsect1>
http://cvs.php.net/diff.php/phpdoc/en/reference/ibm_db2/functions/db2-pconnect.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc/en/reference/ibm_db2/functions/db2-pconnect.xml
diff -u phpdoc/en/reference/ibm_db2/functions/db2-pconnect.xml:1.1
phpdoc/en/reference/ibm_db2/functions/db2-pconnect.xml:1.2
--- phpdoc/en/reference/ibm_db2/functions/db2-pconnect.xml:1.1 Tue Apr 12
17:12:48 2005
+++ phpdoc/en/reference/ibm_db2/functions/db2-pconnect.xml Tue Apr 12
19:45:14 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc.
-->
<refentry id="function.db2-pconnect">
<refnamediv>
@@ -12,13 +12,37 @@
&reftitle.description;
<methodsynopsis>
<type>resource</type><methodname>db2_pconnect</methodname>
-
<methodparam><type>string</type><parameter>database_name</parameter></methodparam>
+
<methodparam><type>string</type><parameter>database</parameter></methodparam>
<methodparam><type>string</type><parameter>username</parameter></methodparam>
<methodparam><type>string</type><parameter>password</parameter></methodparam>
<methodparam
choice="opt"><type>array</type><parameter>options</parameter></methodparam>
</methodsynopsis>
- &warn.undocumented.func;
+ &warn.experimental.func;
+
+ <para>
+ Returns a persistent connection to an IBM DB2 Universal Database, IBM
+ Cloudscape, or Apache Derby database. For more information on persistent
+ connections, refer to <xref linkend='features.persistent-connections' />.
+ </para>
+
+ <para>
+ Calling <function>db2_close</function> on a persistent connection always
+ returns &true;, but the underlying DB2 client connection remains open and
+ waiting to serve the next matching <function>db2_pconnect</function>
+ request.
+ </para>
+
+ <para>
+ Note that you are strongly urged to only use persistent connections on
+ connections with autocommit turned on. If you attempt to combine
+ transactions with persistent connections, issuing
+ <function>db2_commit</function> or <function>db2_rollback</function>
+ against a persistent connection will affect every persistent connection
+ that is currently using the same underlying DB2 client connection. You may
+ also rapidly experience locking escalation if you do not use autocommit for
+ your persistent connections.
+ </para>
</refsect1>
<refsect1 role="parameters">
@@ -26,99 +50,102 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>database_name</parameter></term>
- <listitem>
- <para>
- Its description
- </para>
- </listitem>
- </varlistentry>
+ <term><parameter>database</parameter></term>
+ <listitem>
+ <para>
+ The database alias in the DB2 client catalog.
+ </para>
+ </listitem>
+ </varlistentry>
<varlistentry>
<term><parameter>username</parameter></term>
- <listitem>
- <para>
- Its description
- </para>
- </listitem>
- </varlistentry>
+ <listitem>
+ <para>
+ The username with which you are connecting to the database.
+ </para>
+ </listitem>
+ </varlistentry>
<varlistentry>
<term><parameter>password</parameter></term>
- <listitem>
- <para>
- Its description
- </para>
- </listitem>
- </varlistentry>
+ <listitem>
+ <para>
+ The password with which you are connecting to the database.
+ </para>
+ </listitem>
+ </varlistentry>
<varlistentry>
<term><parameter>options</parameter></term>
- <listitem>
- <para>
- Its description
- </para>
- </listitem>
- </varlistentry>
+ <listitem>
+ <para>
+ An associative array of connection options that affect the behavior
+ of the connection, where valid array keys include:
+ <variablelist>
+ <varlistentry>
+ <term><parameter>autocommit</parameter></term>
+ <listitem>
+ <para>
+ Passing the <literal>DB2_AUTOCOMMIT_ON</literal> value turns
+ autocommit on for this connection handle.
+ </para>
+ <para>
+ Passing the <literal>DB2_AUTOCOMMIT_OFF</literal> value turns
+ autocommit off for this connection handle.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- What the function returns, first on success, then on failure. See
- also the &return.success; entity
- </para>
- </refsect1>
-
- <!-- Use when EXCEPTIONS exist
- <refsect1 role="exceptions">
- &reftitle.exceptions;
- <para>
- When does this function throw exceptions?
+ Returns a connection handle resource if the connection attempt is
+ successful. <function>db2_pconnect</function> tries to reuse an existing
+ connection resource that exactly matches the
+ <parameter>database</parameter>, <parameter>username</parameter>, and
+ <parameter>password</parameter> parameters. If the connection attempt fails,
+ <function>db2_pconnect</function> returns &false;.
</para>
</refsect1>
- -->
-
- <!-- Use when a CHANGELOG exists
- <refsect1 role="changelog">
- &reftitle.changelog;
- <para>
- <informaltable>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>&Version;</entry>
- <entry>&Description</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>Enter the PHP version of change here
- <entry>Description of change
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </para>
- </refsect1>
- -->
-
-
- <!-- Use when examples exist
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>A <function>db2_pconnect</function> example</title>
<para>
- Any text that describes the purpose of the example, or
- what goes on in the example should go here (inside the
- <example> tag, not out
+ In the following example, the first call to
+ <function>db2_pconnect</function> returns a new persistent connection
+ resource. The second call to <function>db2_pconnect</function> returns
+ a persistent connection resource that simply reuses the first persistent
+ connection resource.
</para>
<programlisting role="php">
<![CDATA[
<?php
-if ($anexample === true) {
- echo 'Use the PEAR Coding Standards';
+$database = 'SAMPLE';
+$user = 'db2inst1';
+$password = 'ibmdb2';
+
+$pconn = db2_pconnect($database, $user, $password);
+
+if ($pconn) {
+ echo "Persistent connection succeeded.";
+}
+else {
+ echo "Persistent connection failed.";
+}
+
+$pconn2 = db2_pconnect($database, $user, $password);
+if ($pconn) {
+ echo "Second persistent connection succeeded.";
+}
+else {
+ echo "Second persistent connection failed.";
}
?>
]]>
@@ -126,26 +153,22 @@
&example.outputs;
<screen>
<![CDATA[
-Use the PEAR Coding Standards
+Persistent connection succeeded.
+Second persistent connection succeeded.
]]>
</screen>
</example>
</para>
</refsect1>
- -->
-
- <!-- Use when adding See Also links
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
- <member><function></function></member>
- <member>Or <link linkend="somethingelse">something else</link></member>
+ <member><function>db2_connect</function></member>
</simplelist>
</para>
</refsect1>
- -->
</refentry>
http://cvs.php.net/co.php/phpdoc/en/reference/ibm_db2/configure.xml?r=1.1&p=1
Index: phpdoc/en/reference/ibm_db2/configure.xml
+++ phpdoc/en/reference/ibm_db2/configure.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<section id="ibm_db2.installation">
&reftitle.install;
<para>
To build the ibm_db2 extension, the DB2 application development header
files and libraries must be installed on your system. DB2 does not install
these by default, so you may have to return to your DB2 installer and add
this option.
</para>
<para>
If you add the DB2 application development header files and libraries to
a Linux or Unix operating system on which DB2 was already installed, you
must issue the command <command>db2iupdt -e</command> to update the symbolic
links to the header files and libraries in your DB2 instances.
</para>
<para>
ibm_db2 is a <ulink url="&url.pecl;">PECL</ulink> extension, so follow the
instructions in <xref linkend='install.pecl' /> to install the ibm_db2
extension for PHP. Issue the <command>configure</command> to point
to the location of your DB2 header files and libraries as follows:
<screen>
<![CDATA[
bash$ ./configure --with-IBM_DB2
]]>
</screen>
The <command>configure</command> command defaults to
<filename class='directory'>/opt/IBM/db2/V8.1</filename>.
</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:"../../../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
-->
