<?xml version="1.0" encoding="utf-8"?>

<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-client-info">

<refnamediv>

<refname>db2_client_info</refname>

<refpurpose>

DB2 データベースクライアントの情報をプロパティに保持するオブジェクトを返す

</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type class="union"><type>stdClass</type><type>false</type></type><methodname>db2_client_info</methodname>

<methodparam><type>resource</type><parameter>connection</parameter></methodparam>

</methodsynopsis>

<para>

この関数は、DB2 データベースクライアントについての情報を

読み取り専用のプロパティに保持するオブジェクトを返します。

以下の表は、DB2 クライアントプロパティの一覧です。

<table>

<title>DB2 クライアントプロパティ</title>

<tgroup cols="3">

<thead>

<row>

<entry>プロパティ名</entry>

<entry>戻り値の型</entry>

<entry>説明</entry>

</row>

</thead>

<tbody>

<row>

<entry>APPL_CODEPAGE</entry>

<entry>int</entry>

<entry>アプリケーションのコードページ。</entry>

</row>

<row>

<entry>CONN_CODEPAGE</entry>

<entry>int</entry>

<entry>現在の接続のコードページ。</entry>

</row>

<row>

<entry>DATA_SOURCE_NAME</entry>

<entry>string</entry>

<entry>

現在のデータベース接続に使用されているデータソース名 (DSN)。

</entry>

</row>

<row>

<entry>DRIVER_NAME</entry>

<entry>string</entry>

<entry>

DB2 コールレベルインターフェイス (CLI) の仕様を実装した

ライブラリの名前。

</entry>

</row>

<row>

<entry>DRIVER_ODBC_VER</entry>

<entry>string</entry>

<entry>

DB2 クライアントがサポートしている ODBC のバージョン。

"MM.mm" という形式の文字列で、<varname>MM</varname>

がメジャーバージョン、<varname>mm</varname>

がマイナーバージョンを表します。DB2 クライアントは、

常に "03.51" を返します。

</entry>

</row>

<row>

<entry>DRIVER_VER</entry>

<entry>string</entry>

<entry>

クライアントのバージョン。"MM.mm.uuuu" という形式の文字列で、

<varname>MM</varname> がメジャーバージョン、

<varname>mm</varname> がマイナーバージョン、

そして <varname>uuuu</varname> がアップデートを表します。

例えば "08.02.0001" は

メジャーバージョン 8、マイナーバージョン 2、アップデート 1

を表します。

</entry>

</row>

<row>

<entry>ODBC_SQL_CONFORMANCE</entry>

<entry>string</entry>

<entry>

<para>

クライアントがサポートする ODBC SQL 構文レベル。

<variablelist>

<varlistentry>

<term>MINIMUM</term>

<listitem>

<simpara>

最小限の ODBC SQL 構文をサポートします。

</simpara>

</listitem>

</varlistentry>

<varlistentry>

<term>CORE</term>

<listitem>

<simpara>

コア ODBC SQL をサポートします。

</simpara>

</listitem>

</varlistentry>

<varlistentry>

<term>EXTENDED</term>

<listitem>

<simpara>

拡張 ODBC SQL 構文をサポートします。

</simpara>

</listitem>

</varlistentry>

</variablelist>

</para>

</entry>

</row>

<row>

<entry>ODBC_VER</entry>

<entry>string</entry>

<entry>

ODBC ドライバマネージャがサポートする ODBC のバージョン。

"MM.mm.rrrr" という形式の文字列で、

<varname>MM</varname> がメジャーバージョン、

<varname>mm</varname> がマイナーバージョン、

そして <varname>rrrr</varname> がリリースを表します。

DB2 クライアントは、常に "03.01.0000" を返します。

</entry>

</row>

</tbody>

</tgroup>

</table>

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<variablelist>

<varlistentry>

<term><parameter>connection</parameter></term>

<listitem>

<simpara>

アクティブな DB2 クライアント接続を指定します。

</simpara>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<simpara>

成功した場合にオブジェクトを返します。

&return.falseforfailure;

</simpara>

</refsect1>

<!-- Use when ERRORS exist

<!-- Use when a CHANGELOG exists

<refsect1 role="examples">

&reftitle.examples;

<example>

<title><function>db2_client_info</function> の例</title>

<simpara>

クライアントの情報を取得するには、有効なデータベース接続リソースを

<function>db2_client_info</function> に渡す必要があります。

</simpara>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<simplelist>

<member><function>db2_server_info</function></member>

</simplelist>

</refsect1>

</refentry>