Add note for connecting to IBM i Db2 locally

php/doc-en@1050bbf

Author: mumumu

reference/ibm_db2/functions/db2-connect.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 61374bbe228e8e9c55a24aba59a1e2bb2a871148 Maintainer: takagi Status: ready -->
-<refentry xml:id="function.db2-connect" xmlns="http://docbook.org/ns/docbook">
+<!-- EN-Revision: 1050bbff77c424193980f6b71bd49d5799c6f0a0 Maintainer: takagi Status: ready -->
+<refentry xml:id="function.db2-connect" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>db2_connect</refname>
   <refpurpose>
@@ -40,6 +40,15 @@
        <parameter>database</parameter> は以下のような形式の接続文字列を表します。
        <literallayout>DATABASE=<parameter>database</parameter>;HOSTNAME=<parameter>hostname</parameter>;PORT=<parameter>port</parameter>;PROTOCOL=TCPIP;UID=<parameter>username</parameter>;PWD=<parameter>password</parameter>;</literallayout>
        それぞれのパラメータは以下の内容を表します。
+      <note>
+        <para>
+         IBM i 上の Db2 に接続する場合、以下のシステムコール
+         <link xlink:href="https://www.ibm.com/docs/en/i/7.5?topic=functions-sqldriverconnect-connect-data-source">SQLDriverConnect</link> は、DSN, UID, PWD のみを
+         <link xlink:href="https://www.ibm.com/docs/en/i/7.5?topic=functions-sqldriverconnect-connect-data-source#rzadpfndvcon__title__5">connection string</link>
+         として受け入れます。たとえば以下のようになります:
+         <literallayout>DSN=<parameter>database</parameter>;UID=<parameter>username</parameter>;PWD=<parameter>password</parameter>;</literallayout>
+        </para>
+       </note>
        <variablelist>
         <varlistentry>
          <term><parameter>database</parameter></term>

reference/ibm_db2/functions/db2-pconnect.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 61374bbe228e8e9c55a24aba59a1e2bb2a871148 Maintainer: takagi Status: ready -->
-<refentry xml:id="function.db2-pconnect" xmlns="http://docbook.org/ns/docbook">
+<!-- EN-Revision: 1050bbff77c424193980f6b71bd49d5799c6f0a0 Maintainer: takagi Status: ready -->
+<refentry xml:id="function.db2-pconnect" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>db2_pconnect</refname>
   <refpurpose>
@@ -53,7 +53,69 @@
      <term><parameter>database</parameter></term>
      <listitem>
       <para>
-       DB2 クライアントカタログ内のデータベースエイリアス。
+       データベースへのカタログ接続向けでは、
+       <parameter>database</parameter>
+       は、DB2 クライアントカタログ内のデータベースエイリアスを表します。
+      </para>
+      <para>
+       データベースへのカタログ接続向けでない場合、
+       <parameter>database</parameter>
+       は、以下のフォーマットからなる完全な接続文字列を表します:
+       <literallayout>DATABASE=<parameter>database</parameter>;HOSTNAME=<parameter>hostname</parameter>;PORT=<parameter>port</parameter>;PROTOCOL=TCPIP;UID=<parameter>username</parameter>;PWD=<parameter>password</parameter>;</literallayout>
+       <note>
+        <para>
+         IBM i 上の Db2 に接続する場合、
+         以下のシステムコール
+         <link xlink:href="https://www.ibm.com/docs/en/i/7.5?topic=functions-sqldriverconnect-connect-data-source">SQLDriverConnect</link>
+         は、DSN, UID, PWD だけを
+         <link xlink:href="https://www.ibm.com/docs/en/i/7.5?topic=functions-sqldriverconnect-connect-data-source#rzadpfndvcon__title__5">connection string</link>
+         として受け入れます。たとえば以下のようになります:
+         <literallayout>DSN=<parameter>database</parameter>;UID=<parameter>username</parameter>;PWD=<parameter>password</parameter>;</literallayout>
+        </para>
+       </note>
+       この場合、パラメータは以下の値からなります:
+       <variablelist>
+        <varlistentry>
+         <term><parameter>database</parameter></term>
+         <listitem>
+          <para>
+           データベースの名前
+          </para>
+         </listitem>
+        </varlistentry>
+        <varlistentry>
+         <term><parameter>hostname</parameter></term>
+         <listitem>
+          <para>
+           データベースサーバーのホスト名あるいは IP アドレス。
+          </para>
+         </listitem>
+        </varlistentry>
+        <varlistentry>
+         <term><parameter>port</parameter></term>
+         <listitem>
+          <para>
+           データベースが要求を待ち受ける TCP/IP ポート。
+          </para>
+         </listitem>
+        </varlistentry>
+        <varlistentry>
+         <term><parameter>username</parameter></term>
+         <listitem>
+          <para>
+           データベースに接続するユーザー名。
+          </para>
+         </listitem>
+        </varlistentry>
+        <varlistentry>
+         <term><parameter>password</parameter></term>
+         <listitem>
+          <para>
+           データベースに接続するパスワード。
+          </para>
+         </listitem>
+        </varlistentry>
+       </variablelist>
       </para>
      </listitem>
     </varlistentry>