dsmUpdateObj

Modifica in linea

La chiamata alla funzione dsmUpdateObj aggiorna le meta informazioni associate a un oggetto di archivio o di backup attivo già presente sul server. I dati di bit dell'applicazione non vengono influenzati. Per aggiornare un oggetto, è necessario fornire un nome non jolly specifico. Per aggiornare un oggetto archiviato, impostare dsmSendType su stArchive. Viene aggiornato solo l'ultimo oggetto archivio denominato.

È possibile avviare la chiamata dsmUpdateObj solo nello stato di sessione; non può essere richiamata all'interno di una transazione perché esegue la propria transazione. Inoltre, è possibile aggiornare solo un oggetto alla volta.

Limitazione: su un sistema operativo UNIX o Linux® , se si modifica il campo proprietario, non è possibile interrogare o ripristinare l'oggetto a meno che non si sia l'utente root.

Sintassi

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

Parametri

Le descrizioni dei campi sono uguali a quelle in dsmSendObj, con le seguenti eccezioni:
*objNamePdsmObjName (I)
Non è possibile utilizzare un carattere jolly.
*objAttrPtrObjAttr (I)
Il campo objCompressed viene ignorato per questa chiamata.

Altre differenze sono:

  • owner. Se si specifica un nuovo campo owner , il proprietario cambia.
  • sizeEstimate. Se si specifica un valore diverso da zero, deve essere la quantità effettiva di dati inviati, in byte. Il valore viene memorizzato nei metadati IBM® Storage Protect per un utilizzo futuro.
  • objInfo. Questo attributo contiene le nuove informazioni da inserire nel campo objInfo . Impostare objInfoLength sulla lunghezza del nuovo obiInfo.
dsUint16_t objUpdAct
Le maschere bit e le possibili azioni per objUpdAct sono:
DSM_BACKUPD_MC
Aggiorna la classe di gestione per l'oggetto.
DSM_BACKUPD_OBJINFO
Aggiorna objInfo, objInfoLengthe sizeEstimate.
PROPRIETARIO_BACKUPD_DSM
Aggiorna il proprietario dell'oggetto.
DDSM_ARCHUPD_DESCR
Aggiorna il campo Description . Immettere il valore per la nuova descrizione mediante il parametro SendBuff . Consultare il programma di esempio per un uso corretto.
DSM_ARCHUPD_OBJINFO
Aggiorna objInfo, objInfoLengthe sizeEstimate.
PROPRIETARIO_ARCHUPD_DSM
Aggiorna il proprietario dell'oggetto.

Codici di ritorno

I numeri dei codici di ritorno vengono forniti tra parentesi ().

Tabella 1. Codici di ritorno per dsmUpdateObj
Codice di ritorno Spiegazione
DSM_RC_AZIONE_NON_VALIDA (2232) Azione non valida.
DSM_RC_FS_NON_REGISTRATO (2061) Spazio file non registrato.
DSM_RC_SEQUENZA_CHIAMATA_ERRATA (2041) La sequenza di chiamate è non valida.
DSM_RC_WILDCHAR_NOTALLOWED (2050) Non sono consentiti caratteri jolly.
DSM_RC_ABORT_NO_MATCH (2) La query precedente non corrisponde.