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
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($conn, DB2_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
- db2_connect() - Devolver una conexión a la base de datos
- db2_pconnect() - Devolver una conexión persistente a la base de datos
add a note
