dsmBeginTxn

Editer en ligne

L'appel de fonction dsmBeginTxn lance une ou plusieurs transactions IBM® Storage Protect qui commencent une action complète ; toutes les actions aboutissent ou aucune n'aboutit. Une action peut être un appel unique ou une série d'appels. Par exemple, un appel dsmSendObj suivi d'un certain nombre d'appels dsmSendData peut être considéré comme une seule action. De même, un appel dsmSendObj avec un dataBlkPtr qui indique une zone de données contenant l'objet à sauvegarder est également considéré comme une action unique.

Essayez de regrouper plusieurs objets en une seule transaction pour des opérations de transfert de données. Le regroupement d'objets permet d'améliorer considérablement les performances du système IBM Storage Protect . Pour le cient comme le serveur, le démarrage et la fin de chaque transaction consomment une quantité non négligeable de ressources système.

Les opérations que vous pouvez effectuer dans le cadre d'une transaction unique sont limitées. Ces restrictions sont notamment les suivantes :

  • Le nombre d'objets que vous pouvez envoyer ou supprimer dans une seule transaction est limité. Cette limite se trouve dans les données qui dsmQuerySessInfo renvoie dans le champ ApiSessInfo.maxObjPerTxn champ. Ceci correspond à l'option de serveur TxnGroupMax .
  • Tous les objets envoyés au serveur (de sauvegarde ou d'archivage) en une seule transaction doivent avoir la même destination de copie que celle définie dans la liaison de classe de gestion pour l'objet. Cette valeur se trouve dans les données renvoyées par dsmBindMC dans les zones mcBindKey.backup_copy_dest ou mcBindKey.archive_copy_dest .

Avec l'API, soit le client d'application peut surveiller et contrôler ces restrictions, soit l'API elle-même peut les contrôler. Si l'API contrôle les restrictions, les codes retour appropriés à partir des appels API informent le client d'application lorsqu'une ou plusieurs restrictions sont atteintes.

Faites toujours correspondre un appel dsmBeginTxn à un appel dsmEndTxn pour optimiser l'ensemble d'actions au sein d'une paire d'appels dsmBeginTxn et dsmEndTxn .

Syntaxe

dsInt16_t dsmBeginTxn  (dsUint32_t dsmHandle);

Paramètres

dsUint32_t dsmHandle (I)
Descripteur qui associe cet appel à un appel dsmInitEx précédent.

Codes retour

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

Tableau 1. Codes retour pour dsmBeginTxn
Code retour Explication
DSM_RC_ABORT_NODE_NOT_AUTHORIZED (36) FROMNODE ou FROMOWNER n'est pas autorisé pour les opérations TXN.