dsmUpdateObj

Editer en ligne

L'appel de fonction dsmUpdateObj met à jour les informations meta associées à une sauvegarde active ou à un objet archivé déjà présents sur le serveur. Les données binaires de l'application ne sont pas affectées. Pour mettre à jour un objet, vous devez fournir un nom spécifique sans caractère générique. Pour mettre à jour un objet archivé, définissez dsmSendType sur stArchive. Seul le dernier objet archivé nommé est mis à jour.

Vous pouvez démarrer l'appel dsmUpdateObj uniquement dans l'état de session ; cet appel ne peut pas être appelé dans une transaction car il exécute sa propre transaction. Vous pouvez mettre à jour uniquement un objet à la fois.

Restriction: Sur un système d'exploitation UNIX ou Linux® , si vous modifiez la zone de propriétaire, vous ne pouvez pas interroger ou restaurer l'objet sauf si vous êtes l'utilisateur root.

Syntaxe

dsInt16_t  dsmUpdateObj
   (dsUint32_t      dsmHandle,
    dsmSendType     sendType,
    void           *sendBuff,
    dsmObjName     *objNameP,
    ObjAttr        *objAttrPtr,  /* objInfo */
    dsUint16_t      objUpdAct);  /* action bit vector */

Paramètres

Les descriptions de zone sont identiques à celles de dsmSendObj, à l'exception des suivantes:

dsmObjName *objNameP (I)

Vous ne pouvez pas utiliser de caractère générique.

ObjAttr *objAttrPtr (I)

La zone objCompressed est ignorée pour cet appel.

Les autres différences sont les suivantes :

owner. Si vous indiquez une nouvelle zone owner , le propriétaire change.
sizeEstimate. Si vous indiquez une valeur différente de zéro, il doit s'agir de la quantité réelle de données envoyées, en octets. La valeur est stockée dans les métadonnées IBM® Storage Protect pour une utilisation ultérieure.
objInfo. Cet attribut contient les nouvelles informations à placer dans la zone objInfo . Entrez pour objInfoLength la longueur de la nouvelle valeur objInfo.

dsUint16_t objUpdAct

Les masques de contrôle et les actions possibles pour objUpdAct sont les suivants :

DSM_BACKUPD_MC: Met à jour la classe de gestion pour l'objet.
DSM_BACKUPD_OBJINFO: Mises à jour objInfo, objInfoLengthet sizeEstimate.
DSM_BACKUPD_OWNER: Met à jour le propriétaire de l'objet.
DSM_ARCHUPD_DESCR: Met à jour la zone Description. Entrez la valeur de la nouvelle description via le paramètre SendBuff . Voir l'exemple de programme pour une utilisation correcte.
DSM_ARCHUPD_OBJINFO: Mises à jour objInfo, objInfoLengthet sizeEstimate.
DSM_ARCHUPD_OWNER: Met à jour le propriétaire de l'objet.

Codes retour

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

Tableau 1. Codes retour pour dsmUpdateObj
Code retour	Explication
DSM_RC_INVALID_ ACTION (2232)	Action non valide.
DSM_RC_FS_NOT_REGISTERED (2061)	Espace fichier non enregistré.
DSM_RC_BAD_CALL_SEQUENCE (2041)	Séquence d'appels non valide.
DSM_RC_WILDCHAR_NOTALLOWED (2050)	L'utilisation des caractères génériques est interdite dans ce cas précis.
DSM_RC_ABORT_NO_MATCH (2)	La requête précédente ne correspond pas.