db2_autocommit

(PECL ibm_db2 >= 1.0.0)

db2_autocommit Devuelve o establece el estado de AUTOCOMMIT en una conexión de bases de datos

Descripción

db2_autocommit ( resource $connection [, bool $value ] ) : mixed

Devuelve o establece el comportamiento de AUTOCOMMIT del recurso de conexión especificado.

Parámetros

connection

Variable válida de tipo recurso de conexión a base de datos, devuelta por db2_connect() o por db2_pconnect().

value

Una de las siguientes constantes:

DB2_AUTOCOMMIT_OFF

Desactiva AUTOCOMMIT.

DB2_AUTOCOMMIT_ON

Activa AUTOCOMMIT.

Valores devueltos

Cuando a db2_autocommit() sólo se le proporciona el parámetro connection, devuelve en forma de integer el valor actual de AUTOCOMMIT para la conexión solicitada. Un valor de 0 indica que AUTOCOMMIT está deshabilitado, mientras que un valor de 1 indica que AUTOCOMMIT está habibilitado.

Cuando db2_autocommit() recibe tanto el parámetro connection como autocommit, establece el valor correspondiente en el estado de AUTOCOMMIT de la conexión solicitada. Devuelve TRUE en caso de éxito o FALSE en caso de error.

Ejemplos

Ejemplo #1 Consultando el valor de AUTOCOMMIT de una conexión

En el siguiente ejemplo, se comprueba con la función db2_autocommit() una conexión creada con AUTOCOMMIT deshabilitado.

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

El resultado del ejemplo sería:

0 -- AUTOCOMMIT está a off.

Ejemplo #2 Asignando el valor de AUTOCOMMIT en una conexión

En el siguiente ejemplo, sobre una conexión inicialmente creada con AUTOCOMMIT dehasbilitado, se cambia su comportamiento a AUTOCOMMIT on.

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

// Activación de AUTOCOMMIT
$rc db2_autocommit($connDB2_AUTOCOMMIT_ON);
if (
$rc) {
    print 
"Activación de AUTOCOMMIT con éxito.\n";
}

// Comprobar estado de AUTOCOMMIT
$ac db2_autocommit($conn);
if (
$ac == 0) {
    print 
"$ac -- AUTOCOMMIT está a off.";
} else {
    print 
"$ac -- AUTOCOMMIT está a on.";
}
?>

El resultado del ejemplo sería:

Activación de AUTOCOMMIT con éxito.
1 -- AUTOCOMMIT está a on.

Ver también