array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.db2-autocommit.php', 1 => 'db2_autocommit', 2 => 'Retorna ou define o estado AUTOCOMMIT para uma conexão de banco de dados', ), 'up' => array ( 0 => 'ref.ibm-db2.php', 1 => 'Funções de IBM DB2', ), 'prev' => array ( 0 => 'ref.ibm-db2.php', 1 => 'Funções de IBM DB2', ), 'next' => array ( 0 => 'function.db2-bind-param.php', 1 => 'db2_bind_param', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/ibm_db2/functions/db2-autocommit.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

db2_autocommit

(PECL ibm_db2 >= 1.0.0)

db2_autocommit — Retorna ou define o estado AUTOCOMMIT para uma conexão de banco de dados

Descrição

db2_autocommit(resource $connection, int $value = ?): int|bool

Define ou obtém o comportamento AUTOCOMMIT do recurso de conexão especificado.

Parâmetros

connection
Uma variável de recurso de conexão de banco de dados válida, conforme retornada de db2_connect() ou db2_pconnect().
value

Uma das seguintes constantes:

DB2_AUTOCOMMIT_OFF
Desativa o AUTOCOMMIT.
DB2_AUTOCOMMIT_ON
Ativa o AUTOCOMMIT.

Valor Retornado

Quando db2_autocommit() recebe apenas o parâmetro connection, ele retorna o estado atual de AUTOCOMMIT para a conexão solicitada como um valor inteiro. Um valor de DB2_AUTOCOMMIT_OFF indica que AUTOCOMMIT está desligado, enquanto um valor de DB2_AUTOCOMMIT_ON indica que AUTOCOMMIT está ligado.

Quando db2_autocommit() recebe o parâmetro connection e o parâmetro autocommit, ele tenta definir o estado AUTOCOMMIT da conexão solicitada para o estado correspondente. Retorna true em caso de sucesso ou false em caso de falha.

Exemplos

Exemplo #1 Recuperando o valor AUTOCOMMIT para uma conexão

No exemplo a seguir, uma conexão que foi criada com AUTOCOMMIT desativado é testada com a função db2_autocommit().

<?php
$options = array('autocommit' => DB2_AUTOCOMMIT_OFF);
$conn = db2_connect($database, $user, $password, $options);
$ac = db2_autocommit($conn);
if ($ac == DB2_AUTOCOMMIT_OFF) {
print "$ac -- AUTOCOMMIT está desativado.";
} else {
print "$ac -- AUTOCOMMIT está ativado.";
}
?>

O exemplo acima produzirá:

0 -- AUTOCOMMIT está desativado.

Exemplo #2 Definindo o valor AUTOCOMMIT para uma conexão

No exemplo a seguir, uma conexão que foi inicialmente criada com AUTOCOMMIT desativado tem seu comportamento alterado para ativar AUTOCOMMIT.

<?php
$options = array('autocommit' => DB2_AUTOCOMMIT_OFF);
$conn = db2_connect($database, $user, $password, $options);

// Ativa o AUTOCOMMIT
$rc = db2_autocommit($conn, DB2_AUTOCOMMIT_ON);
if ($rc) {
print "Ativação do AUTOCOMMIT bem sucedida.\n";
}

// Verifica o estado do AUTOCOMMIT
$ac = db2_autocommit($conn);
if ($ac == DB2_AUTOCOMMIT_OFF) {
print "$ac -- AUTOCOMMIT está desativado.";
} else {
print "$ac -- AUTOCOMMIT está ativado.";
}
?>

O exemplo acima produzirá:

Ativação do AUTOCOMMIT bem sucedida.
1 -- AUTOCOMMIT está ativado.

Veja Também