(PECL ibm_db2 >= 1.0.0)
db2_autocommit — Retorna ou define o estado AUTOCOMMIT para uma conexão de banco de dados
Define ou obtém o comportamento AUTOCOMMIT do recurso de conexão especificado.
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.
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.
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.