(PECL ibm_db2:1.0-1.6.2)
db2_autocommit — Retourne ou modifie l'état AUTOCOMMIT de la connexion à la base de données
Modifie ou lit le comportement de AUTOCOMMIT de la connexion spécifiée.
Une variable de connexion à une base de données valide retournée par db2_connect() ou db2_pconnect() .
Une des constantes suivantes :
Désactive AUTOCOMMIT.
Active AUTOCOMMIT.
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.
Exemple 1062. 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 1063. 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é.
| db2_connect() |
| db2_pconnect() |