|
| 1 | +<?xml version="1.0" encoding="utf-8"?> |
| 2 | +<!-- EN-Revision: 61374bbe228e8e9c55a24aba59a1e2bb2a871148 Maintainer: leonardolara Status: ready --> |
| 3 | +<refentry xml:id="function.db2-autocommit" xmlns="http://docbook.org/ns/docbook"> |
| 4 | + <refnamediv> |
| 5 | + <refname>db2_autocommit</refname> |
| 6 | + <refpurpose> |
| 7 | + Retorna ou define o estado AUTOCOMMIT para uma conexão de banco de dados |
| 8 | + </refpurpose> |
| 9 | + </refnamediv> |
| 10 | + <refsect1 role="description"> |
| 11 | + &reftitle.description; |
| 12 | + <methodsynopsis> |
| 13 | + <type class="union"><type>int</type><type>bool</type></type><methodname>db2_autocommit</methodname> |
| 14 | + <methodparam><type>resource</type><parameter>connection</parameter></methodparam> |
| 15 | + <methodparam choice="opt"><type>int</type><parameter>value</parameter></methodparam> |
| 16 | + </methodsynopsis> |
| 17 | + |
| 18 | + <para> |
| 19 | + Define ou obtém o comportamento AUTOCOMMIT do recurso de conexão especificado. |
| 20 | + </para> |
| 21 | + |
| 22 | + </refsect1> |
| 23 | + <refsect1 role="parameters"> |
| 24 | + &reftitle.parameters; |
| 25 | + <para> |
| 26 | + <variablelist> |
| 27 | + <varlistentry> |
| 28 | + <term><parameter>connection</parameter></term> |
| 29 | + <listitem> |
| 30 | + <para> |
| 31 | + Uma variável de recurso de conexão de banco de dados válida, conforme retornada de |
| 32 | + <function>db2_connect</function> ou <function>db2_pconnect</function>. |
| 33 | + </para> |
| 34 | + </listitem> |
| 35 | + </varlistentry> |
| 36 | + <varlistentry> |
| 37 | + <term><parameter>value</parameter></term> |
| 38 | + <listitem> |
| 39 | + <para> |
| 40 | + Uma das seguintes constantes: |
| 41 | + <variablelist> |
| 42 | + <varlistentry> |
| 43 | + <term><constant>DB2_AUTOCOMMIT_OFF</constant></term> |
| 44 | + <listitem> |
| 45 | + <para> |
| 46 | + Desativa o AUTOCOMMIT. |
| 47 | + </para> |
| 48 | + </listitem> |
| 49 | + </varlistentry> |
| 50 | + <varlistentry> |
| 51 | + <term><constant>DB2_AUTOCOMMIT_ON</constant></term> |
| 52 | + <listitem> |
| 53 | + <para> |
| 54 | + Ativa o AUTOCOMMIT. |
| 55 | + </para> |
| 56 | + </listitem> |
| 57 | + </varlistentry> |
| 58 | + </variablelist> |
| 59 | + </para> |
| 60 | + </listitem> |
| 61 | + </varlistentry> |
| 62 | + </variablelist> |
| 63 | + </para> |
| 64 | + </refsect1> |
| 65 | + <refsect1 role="returnvalues"> |
| 66 | + &reftitle.returnvalues; |
| 67 | + <para> |
| 68 | + Quando <function>db2_autocommit</function> recebe apenas o parâmetro |
| 69 | + <parameter>connection</parameter>, ele retorna o estado atual |
| 70 | + de AUTOCOMMIT para a conexão solicitada como um valor inteiro. Um valor de |
| 71 | + <constant>DB2_AUTOCOMMIT_OFF</constant> indica que AUTOCOMMIT está desligado, |
| 72 | + enquanto um valor de <constant>DB2_AUTOCOMMIT_ON</constant> indica que |
| 73 | + AUTOCOMMIT está ligado. |
| 74 | + </para> |
| 75 | + <para> |
| 76 | + Quando <function>db2_autocommit</function> recebe o parâmetro |
| 77 | + <parameter>connection</parameter> e o parâmetro |
| 78 | + <parameter>autocommit</parameter>, ele tenta definir o |
| 79 | + estado AUTOCOMMIT da conexão solicitada para o estado correspondente. |
| 80 | + &return.success; |
| 81 | + </para> |
| 82 | + </refsect1> |
| 83 | + |
| 84 | + <refsect1 role="examples"> |
| 85 | + &reftitle.examples; |
| 86 | + <para> |
| 87 | + <example> |
| 88 | + <title>Recuperando o valor AUTOCOMMIT para uma conexão</title> |
| 89 | + <para> |
| 90 | + No exemplo a seguir, uma conexão que foi criada com |
| 91 | + AUTOCOMMIT desativado é testada com a |
| 92 | + função <function>db2_autocommit</function>. |
| 93 | + </para> |
| 94 | + <programlisting role="php"> |
| 95 | +<![CDATA[ |
| 96 | +<?php |
| 97 | +$options = array('autocommit' => DB2_AUTOCOMMIT_OFF); |
| 98 | +$conn = db2_connect($database, $user, $password, $options); |
| 99 | +$ac = db2_autocommit($conn); |
| 100 | +if ($ac == DB2_AUTOCOMMIT_OFF) { |
| 101 | + print "$ac -- AUTOCOMMIT está desativado."; |
| 102 | +} else { |
| 103 | + print "$ac -- AUTOCOMMIT está ativado."; |
| 104 | +} |
| 105 | +?> |
| 106 | +]]> |
| 107 | + </programlisting> |
| 108 | + &example.outputs; |
| 109 | + <screen> |
| 110 | +<![CDATA[ |
| 111 | +0 -- AUTOCOMMIT está desativado. |
| 112 | +]]> |
| 113 | + </screen> |
| 114 | + </example> |
| 115 | + <example> |
| 116 | + <title>Definindo o valor AUTOCOMMIT para uma conexão</title> |
| 117 | + <para> |
| 118 | + No exemplo a seguir, uma conexão que foi inicialmente criada com |
| 119 | + AUTOCOMMIT desativado tem seu comportamento alterado para ativar AUTOCOMMIT. |
| 120 | + </para> |
| 121 | + <programlisting role="php"> |
| 122 | +<![CDATA[ |
| 123 | +<?php |
| 124 | +$options = array('autocommit' => DB2_AUTOCOMMIT_OFF); |
| 125 | +$conn = db2_connect($database, $user, $password, $options); |
| 126 | +
|
| 127 | +// Ativa o AUTOCOMMIT |
| 128 | +$rc = db2_autocommit($conn, DB2_AUTOCOMMIT_ON); |
| 129 | +if ($rc) { |
| 130 | + print "Ativação do AUTOCOMMIT bem sucedida.\n"; |
| 131 | +} |
| 132 | +
|
| 133 | +// Verifica o estado do AUTOCOMMIT |
| 134 | +$ac = db2_autocommit($conn); |
| 135 | +if ($ac == DB2_AUTOCOMMIT_OFF) { |
| 136 | + print "$ac -- AUTOCOMMIT está desativado."; |
| 137 | +} else { |
| 138 | + print "$ac -- AUTOCOMMIT está ativado."; |
| 139 | +} |
| 140 | +?> |
| 141 | +]]> |
| 142 | + </programlisting> |
| 143 | + &example.outputs; |
| 144 | + <screen> |
| 145 | +<![CDATA[ |
| 146 | +Ativação do AUTOCOMMIT bem sucedida. |
| 147 | +1 -- AUTOCOMMIT está ativado. |
| 148 | +]]> |
| 149 | + </screen> |
| 150 | + </example> |
| 151 | + |
| 152 | + </para> |
| 153 | + </refsect1> |
| 154 | + |
| 155 | + <refsect1 role="seealso"> |
| 156 | + &reftitle.seealso; |
| 157 | + <para> |
| 158 | + <simplelist> |
| 159 | + <member><function>db2_connect</function></member> |
| 160 | + <member><function>db2_pconnect</function></member> |
| 161 | + </simplelist> |
| 162 | + </para> |
| 163 | + </refsect1> |
| 164 | + |
| 165 | +</refentry> |
| 166 | +<!-- Keep this comment at the end of the file |
| 167 | +Local variables: |
| 168 | +mode: sgml |
| 169 | +sgml-omittag:t |
| 170 | +sgml-shorttag:t |
| 171 | +sgml-minimize-attributes:nil |
| 172 | +sgml-always-quote-attributes:t |
| 173 | +sgml-indent-step:1 |
| 174 | +sgml-indent-data:t |
| 175 | +indent-tabs-mode:nil |
| 176 | +sgml-parent-document:nil |
| 177 | +sgml-default-dtd-file:"~/.phpdoc/manual.ced" |
| 178 | +sgml-exposed-tags:nil |
| 179 | +sgml-local-catalogs:nil |
| 180 | +sgml-local-ecat-files:nil |
| 181 | +End: |
| 182 | +vim600: syn=xml fen fdm=syntax fdl=2 si |
| 183 | +vim: et tw=78 syn=sgml |
| 184 | +vi: ts=1 sw=1 |
| 185 | +--> |
0 commit comments