dsmEndTxnEx

Paramètres

dsmEndTxnExIn_t *dsmEndTxnExInP (I)

Cette structure contient les paramètres suivants :

dsmHandle

Descripteur qui identifie la session et l'associe aux appels IBM® Storage Protect ultérieurs.

dsUint8_t vote (I)

Indique si le client d'application valide ou non toutes les actions effectuées entre l'appel dsmBeginTxn précédent et cet appel. Les valeurs admises sont les suivantes :

   DSM_VOTE_COMMIT     /* commit current transaction    */
   DSM_VOTE_ABORT      /* roll back current transaction */

Utilisez DSM_VOTE_ABORT uniquement si votre application a trouvé une raison d'arrêter la transaction.

dsmEndTxnExOut_t *dsmEndTxnExOutP (O)

Cette structure contient les paramètres suivants :

dsUint16_t *reason (O)

Si l'appel à dsmEndTxnEx se termine avec une erreur ou si la valeur de vote n'est pas acceptée, ce paramètre comporte un code raison indiquant la raison de l'échec du vote.

Astuce: Le code retour de l'appel peut être zéro et le code raison peut être différent de zéro. Par conséquent, le client d'application doit toujours rechercher les erreurs sur le code retour et la raison (if (rc || reason)) avant de pouvoir supposer que l'opération a abouti.

Si l'application indique un vote DSM_VOTE_ABORT, le code raison est DSM_RS_ABORT_BY_CLIENT (3). Voir le fichier source des codes retour de l'API : dsmrc.h pour obtenir la liste des codes anomalie possibles. Les nombres 1 à 50 dans la liste des codes retour sont réservés pour les codes raison. Si le serveur termine la transaction, le code retour est DSM_RC_CHECK_REASON_CODE. Dans ce cas, la valeur de la raison contient des informations supplémentaires sur la cause de l'abandon.

groupLeaderObjId

ID objet de leader de groupe renvoyé lorsque l'indicateur DSM_ACTION_OPEN est utilisé avec l'appel dsmGroupHandler .

Codes retour

Les numéros de code retour sont indiqués entre parenthèses ( ).