xa_start

Prototypes


int xa_start(XID *xid, int rmid, long flags);

Description

Débute une nouvelle transaction identifiée par xid pour le gestionnaire de ressources identifié par rmid avec les options flags.

Cette Application Program Interface (API) est fournie par le gestionnaire de ressources au moniteur transactionnel. Ce dernier décide des identifications.

Les valeurs possibles du codage bit de flags sont les suivantes :

TMNOFLAGS.
Pas d'options.
TMASYNC.
Demande de traitement asynchrone.
TMJOIN.
La transaction existe déjà et elle a été créée par une autre tâche. Il s'agit d'une migration.
TMRESUME.
La transaction existe déjà et elle a été créée par cette tâche. Il s'agit d'une reprise.

Une fois débutée, la tâche courante du gestionnaire de ressources est la propriétaire exclusive de la transaction. Elle peut donc insérer, modifier ou supprimer des données de la base dans le cadre de la transaction.

Les valeurs possibles du code retour sont les suivantes :

XAER_RMERR.
Erreur interne.
XAER_ASYNC.
Le mode asynchrone n'est pas supporté.
XAER_INVAL.
Un paramètre possède une valeur invalide.
XA_OK.
Succès.

Exemple


#include <xa.h>



static int rmid;

static XID xid;

static xa_switch_t *XaSwitch;



...

if ((*XaSwitch->xa_start_entry)(&Xid, rmid, TMNOFLAGS)!=XA_OK)

   {

   ...

   }

...

if ((*XaSwitch->xa_end_entry)(&Xid, rmid, TMNOFLAGS)!=XA_OK)

   {

   ...

   }

...

Voir aussi

xa_end pour terminer une transaction.