db2_autocommit
(PECL)
db2_autocommit --
Retourne ou modifie l'état AUTOCOMMIT de la connexion à la base de
données
Description
mixed
db2_autocommit ( resource connection [, bool value] )
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, FALSE en cas d'échec.
Exemples
Exemple 1. Récupération de la valeur de AUTOCOMMIT pour une connexion
Dans l'exemple suivant, une connexion qui a été initialisée avec l'état AUTOCOMMIT
désactivé est testé avec la fonction db2_autocommit().
<?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é."; } ?>
|
L'exemple ci-dessus va afficher : 0 -- AUTOCOMMIT est désactivé. |
|
Exemple 2. Modification de la valeur de AUTOCOMMIT pour une connexion
Dans l'exemple suivant, une connexion qui a été préalablement initialisée avec
l'état AUTOCOMMIT désactivé a son comportement changé lors de l'activation de
l'état AUTOCOMMIT.
<?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é. |
|