dsmBindMC

Editer en ligne

L'appel de fonction dsmBindMC associe ou lie une classe de gestion à l'objet transmis. L'objet est transmis par l'intermédiaire de la liste inclusive-exclusive qui est pointée vers le fichier d'options. Si aucune correspondance n'est trouvée dans la liste inclusive pour une classe de gestion spécifique, la classe de gestion par défaut est affectée. La liste exclusive peut exclure les objets d'une sauvegarde, mais non d'une archive.

Le client d'application peut utiliser les paramètres renvoyés dans la structure mcBindKey pour déterminer si cet objet doit être sauvegardé ou archivé, ou si une nouvelle transaction doit être démarrée en raison de destinations de copie différentes. Pour plus d'informations, voir dsmBeginTxn .

Appelez dsmBindMC avant d'appeler dsmSendObj car chaque objet doit être associé à une classe de gestion. Cet appel peut être exécuté à l'intérieur ou à l'extérieur d'une transaction. Par exemple, dans une transaction à plusieurs objets, si dsmBindMC indique que l'objet a une destination de copie différente de l'objet précédent, la transaction doit être arrêtée et une nouvelle transaction démarrée. Dans ce cas, un autre dsmBindMC n'est pas requis car un autre a déjà été effectué pour cet objet.

Syntaxe

dsInt16_t dsmBindMC  (dsUint32_t       dsmHandle,
   dsmObjName  *objNameP,
   dsmSendType  sendType,
   mcBindKey   *mcBindKeyP);

Paramètres

dsUint32_t dsmHandle (I)

Descripteur qui associe cet appel à un appel dsmInitEx précédent.

dsmObjName *objNameP (I)

Pointeur vers la structure qui contient le nom d'espace fichier, le nom d'objet de haut niveau, le nom d'objet de bas niveau et le type d'objet.

dsmSendType sendType (I)

Identifie si cette liaison de classe de gestion est exécutée pour les envois d'archivage ou de sauvegarde. Les valeurs possibles pour cet appel comprennent notamment les valeurs suivantes :

	Nom	Description
	stBackup	Objet de sauvegarde
	stArchive	Objet archivé
	stBackupMountWait	Objet de sauvegarde
	stArchiveMountWait	Objet archivé

Pour l'appel dsmBindMC , stBackup et stBackupMountWait sont équivalents, et stArchive et stArchiveMountWait sont équivalents.

mcBindKey *mcBindKeyP (O)

Ceci est l'adresse d'une structure mcBindKey à laquelle est renvoyée l'information de classe de gestion. Le client d'application peut utiliser l'informations qui est renvoyée ici pour déterminer si cet objet est adapté à une transaction à objets multiples, ou pour effectuer une requête de classe de gestion sur la classe de gestion liée à cet objet.

Codes retour

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

Tableau 1. Codes de retour pour dsmBindMC
Code retour	Explication
DSM_RC_NO_MEMORY (102)	Il ne reste plus de mémoire RAM pour terminer la requête.
DSM_RC_INVALID_PARM (109)	L'un des paramètres transmis a une valeur non valide.
DSM_RC_TL_NOBCG (184)	La classe de gestion de ce fichier ne possède pas de groupe de copie de sauvegarde valide.
DSM_RC_TL_EXCLUDED (185)	L'objet de sauvegarde est exclu et ne peut pas être envoyé.
DSM_RC_TL_NOACG (186)	La classe de gestion de ce fichier n'a pas de groupe de copie d'archivage valide.
DSM_RC_INVALID_OBJTYPE (2010)	Type d'objet non valide.
DSM_RC_INVALID_SENDTYPE (2022)	Type d'envoi non valide.
DSM_RC_WRONG_VERSION_PARM (2065)	La version de l'API du client d'application est différente de la version de la bibliothèque IBM® Storage Protect .

Remarque: Vérifiez qu'un groupe de copie valide existe pour une classe de gestion. Sinon, la fonction dsmBindMC peut renvoyer des messages d'erreur DSM_RC_TL_NOBCG (184) ou DSM_RC_TL_NOACG (186).