db2_autocommit
(PECL ibm_db2 >= 1.0.0)
db2_autocommit — Retourne ou modifie l'état AUTOCOMMIT de la connexion à la base de données
Description
Modifie ou lit le comportement de AUTOCOMMIT de la connexion spécifiée.
Liste de paramètres
-
connection
-
Une variable de connexion à une base de données valide retournée par db2_connect() ou db2_pconnect().
-
value
-
Une des constantes suivantes :
- DB2_AUTOCOMMIT_OFF
-
Désactive AUTOCOMMIT.
- DB2_AUTOCOMMIT_ON
-
Active AUTOCOMMIT.
Valeurs de retour
Lorsque db2_autocommit() reçoit seulement
connection
comme paramètre, la fonction retourne
un entier représentant l'état courant de AUTOCOMMIT de la connexion fournie.
Une valeur de 0 signifie que AUTOCOMMIT est désactivé, tandis qu'une valeur
de 1 signifie que AUTOCOMMIT est activé.
Lorsque db2_autocommit() reçoit les deux paramètres
connection
et autocommit
,
la fonction essaie de modifier l'état AUTOCOMMIT à l'état
autocommit
de la connexion fournie.
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.
Exemples
Exemple #1 Récupération de la valeur de AUTOCOMMIT pour une connexion
<?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 désactivé."; } else { print "$ac -- AUTOCOMMIT est activé."; } ?>
<?php $options = array('autocommit' => DB2_AUTOCOMMIT_OFF); $conn = db2_connect($database, $user, $password, $options); // Active AUTOCOMMIT $rc = db2_autocommit($conn, DB2_AUTOCOMMIT_ON); if ($rc) { print "Activation AUTOCOMMIT réussie.\n"; } // Vérification de l'état AUTOCOMMIT $ac = db2_autocommit($conn); if ($ac == 0) { print "$ac -- AUTOCOMMIT est désactivé."; } else { print "$ac -- AUTOCOMMIT est activé."; } ?>
L'exemple ci-dessus va afficher :
Activation AUTOCOMMIT réussie. 1 -- AUTOCOMMIT est activé.
Voir aussi
- db2_connect() - Retourne une connexion à une base de données
- db2_pconnect() - Retourne une connexion persistante à une base de données