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 DB2_AUTOCOMMIT_OFF
signifie que AUTOCOMMIT
est désactivé, tandis qu'une valeur de DB2_AUTOCOMMIT_ON
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
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 == DB2_AUTOCOMMIT_OFF) {
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 == DB2_AUTOCOMMIT_OFF) {
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
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-db2-autocommit.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.