db2-get-option.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.db2-get-option" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>db2_get_option</refname>
  <refpurpose>Извлекает значение параметра для ресурса оператора или ресурса соединения</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type class="union"><type>string</type><type>false</type></type><methodname>db2_get_option</methodname>
   <methodparam><type>resource</type><parameter>resource</parameter></methodparam>
   <methodparam><type>string</type><parameter>option</parameter></methodparam>
  </methodsynopsis>
  <para>
   Извлекает значение указанного параметра для ресурса оператора или ресурса соединения.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>resource</parameter></term>
     <listitem>
     <para>
      Допустимый ресурс оператора, возвращаемый <function>db2_prepare</function>
      или допустимый ресурс соединения, возвращаемый <function>db2_connect</function> или
      <function>db2_pconnect</function>.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry>
    <term><parameter>option</parameter></term>
    <listitem>
     <para>
      Допустимый оператор или варианты подключения. Следующие новые параметры доступны в ibm_db2 версии 1.6.0.
      Они предоставляют полезную информацию для отслеживания, которую можно установить во время выполнения
      с помощью <function>db2_get_option</function>.
      <note>
       <para>
        Предыдущие версии ibm_db2 не поддерживают эти новые параметры.
       </para>
       <para>
        Когда устанавливается значение в каждой опции, некоторые серверы могут не обрабатывать
        всю предоставленную длину и могут усекать значение.
       </para>
       <para>
        Чтобы обеспечить правильное преобразование данных, указанных в каждой опции,
        при передаче в хост-систему, используйте только символы от A до Z, от 0 до 9, знак подчёркивания (_) или точку (.).
       </para>
      </note>
      <variablelist>
       <varlistentry>
        <term><parameter>userid</parameter></term>
         <listitem>
          <para>
           <literal>SQL_ATTR_INFO_USERID</literal> - Указатель на символьную строку с завершающим нулём,
           используемую для идентификации ID пользователя клиента,
           отправляемого на сервер базы данных хоста при использовании DB2 Connect.
           <note>
            <para>
             Серверы DB2 для z/OS и OS/390 поддерживают длину до 16 символов.
             Идентификатор пользователя не следует путать с идентификатором пользователя для аутентификации,
             он используется только для целей идентификации и не используется для какой-либо авторизации.
            </para>
           </note>
          </para>
         </listitem>
        </varlistentry>
        <varlistentry>
         <term><parameter>acctstr</parameter></term>
         <listitem>
          <para>
           <literal>SQL_ATTR_INFO_ACCTSTR</literal> - Указатель на символьную строку
           с завершающим нулём, используемую для идентификации учётной строки клиента,
           отправляемой на сервер базы данных хоста при использовании DB2 Connect.
           <note>
            <para>
             Серверы DB2 для z/OS и OS/390 поддерживают длину до 200 символов.
            </para>
           </note>
          </para>
         </listitem>
        </varlistentry>
        <varlistentry>
         <term><parameter>applname</parameter></term>
         <listitem>
          <para>
           <literal>SQL_ATTR_INFO_APPLNAME</literal> - Указатель на символьную строку
           с завершающим нулём, используемую для идентификации имени клиентского приложения,
           отправляемого на сервер базы данных хоста при использовании DB2 Connect.
           <note>
            <para>
             Серверы DB2 для z/OS и OS/390 поддерживают длину до 32 символов.
            </para>
           </note>
          </para>
         </listitem>
        </varlistentry>
        <varlistentry>
         <term><parameter>wrkstnname</parameter></term>
         <listitem>
          <para>
           <literal>SQL_ATTR_INFO_WRKSTNNAME</literal> - Указатель на символьную строку
           с завершающим нулём, используемую для идентификации имени клиентского приложения,
           отправляемого на сервер базы данных хоста при использовании DB2 Connect.
           <note>
            <para>
             Серверы DB2 для z/OS и OS/390 поддерживают длину до 18 символов.
            </para>
           </note>
          </para>
         </listitem>
        </varlistentry>
       </variablelist>
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
  <para>
   В следующей таблице указаны параметры, совместимые с доступными типами ресурсов:
   <table>
    <title>Матрица параметров ресурсов</title>
    <tgroup cols="5">
     <colspec colnum="1" colname="col1" align="center" />
     <colspec colnum="2" colname="col2" align="center" />
     <colspec colnum="3" colname="col3" align="center" />
     <colspec colnum="4" colname="col4" align="center" />
     <colspec colnum="5" colname="col5" align="center" />
     <thead>
      <row>
       <entry morerows="1">Ключ</entry>
       <entry morerows="1">Значение</entry>
       <entry namest="col3" nameend="col5">Тип ресурса</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry colname="col3">Connection</entry>
       <entry colname="col4">Statement</entry>
       <entry colname="col5">Result Set</entry>
      </row>
      <row>
       <entry>userid</entry>
       <entry><literal>SQL_ATTR_INFO_USERID</literal></entry>
       <entry colname="col3">X</entry>
       <entry colname="col4">X</entry>
       <entry colname="col5">-</entry>
      </row>
      <row>
       <entry>acctstr</entry>
       <entry><literal>SQL_ATTR_INFO_ACCTSTR</literal></entry>
       <entry colname="col3">X</entry>
       <entry colname="col4">X</entry>
       <entry colname="col5">-</entry>
      </row>
      <row>
       <entry>applname</entry>
       <entry><literal>SQL_ATTR_INFO_APPLNAME</literal></entry>
       <entry colname="col3">X</entry>
       <entry colname="col4">X</entry>
       <entry colname="col5">-</entry>
      </row>
      <row>
       <entry>wrkstnname</entry>
       <entry><literal>SQL_ATTR_INFO_WRKSTNNAME</literal></entry>
       <entry colname="col3">X</entry>
       <entry colname="col4">X</entry>
       <entry colname="col5">-</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Возвращает текущую настройку атрибута подключения, предоставленную в случае успешного выполнения&return.falseforfailure;.
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Установка и получение параметров через ресурс подключения</title>
    <programlisting role="php">
<![CDATA[
<?php
/* Параметры подключения к базе данных */
$database = 'SAMPLE';
$user     = 'db2inst1';
$password = 'ibmdb2';

/* Получение ресурса подключения */
$conn = db2_connect($database, $user, $password);

echo "Атрибуты клиента, передаваемые через строку подключения:\n";

/* Создайте массив ассоциативных опций с допустимыми парами "ключ-значение" */
/* Назначьте атрибуты через строку подключения */
/* Доступ к указанным параметрам */
$options1 = array('userid' => 'db2inst1');
$conn1 = db2_connect($database, $user, $password, $options1);
$val = db2_get_option($conn1, 'userid');
echo $val . "\n";

$options2 = array('acctstr' => 'account');
$conn2 = db2_connect($database, $user, $password, $options2);
$val = db2_get_option($conn2, 'acctstr');
echo $val . "\n";

$options3 = array('applname' => 'myapp');
$conn3 = db2_connect($database, $user, $password, $options3);
$val = db2_get_option($conn3, 'applname');
echo $val . "\n";

$options4 = array('wrkstnname' => 'workstation');
$conn4 = db2_connect($database, $user, $password, $options4);
$val = db2_get_option($conn4, 'wrkstnname');
echo $val . "\n";

echo "Атрибуты клиента прошли после подключения:\n";

/* Create the associative options array with valid key-value pairs */
/* Assign the attributes after a connection is made */
/* Access the options specified */
$options5 = array('userid' => 'db2inst1');
$conn5 = db2_connect($database, $user, $password);
$rc = db2_set_option($conn5, $options5, 1);
$val = db2_get_option($conn5, 'userid');
echo $val . "\n";

$options6 = array('acctstr' => 'account');
$conn6 = db2_connect($database, $user, $password);
$rc = db2_set_option($conn6, $options6, 1);
$val = db2_get_option($conn6, 'acctstr');
echo $val . "\n";

$options7 = array('applname' => 'myapp');
$conn7 = db2_connect($database, $user, $password);
$rc = db2_set_option($conn7, $options7, 1);
$val = db2_get_option($conn7, 'applname');
echo $val . "\n";

$options8 = array('wrkstnname' => 'workstation');
$conn8 = db2_connect($database, $user, $password);
$rc = db2_set_option($conn8, $options8, 1);
$val = db2_get_option($conn8, 'wrkstnname');
echo $val . "\n";
?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
Атрибуты клиента, передаваемые через строку подключения
db2inst1
account
myapp
workstation
Атрибуты клиента прошли после подключения:
db2inst1
account
myapp
workstation
]]>
    </screen>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>db2_connect</function></member>
    <member><function>db2_cursor_type</function></member>
    <member><function>db2_exec</function></member>
    <member><function>db2_set_option</function></member>
    <member><function>db2_pconnect</function></member>
    <member><function>db2_prepare</function></member>
   </simplelist>
  </para>
 </refsect1>

</refentry>
<!-- 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
-->