Manuel PHP
Précédent |  | Suivant

# 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é.

## Voir aussi

db2_connect()
db2_pconnect()

Précédent | Sommaire | Suivant
Fonctions IBM DB2, Cloudscape et Apache Derby | Niveau supérieur | db2_bind_param