dsmUpdateObjEx

Editar en línea

La llamada de función dsmUpdateObjEx actualiza la meta información que está asociada con los objetos de archivado o las copias de seguridad en el servidor. Los datos de bit de la aplicación no se ven afectados. Para actualizar un objeto, debe asignar un nombre sin comodines o bien especificar el ID del objeto con el fin de actualizar un objeto archivado específico. No se pueden utilizar caracteres comodín cuando se especifica el nombre. Para actualizar un objeto al que se le ha realizado una copia de seguridad, configure el parámetro dsmSendType en stBackup. Para actualizar un objeto archivado, configure el parámetro dsmSendType en stArchive.

Sólo puede iniciar la llamada dsmUpdateObjEx en el estado de la sesión; no se puede llamar dentro de una transacción porque realiza su propia transacción. Los objetos sólo se pueden actualizar de uno en uno.

Restricción: En un sistema operativo UNIX o Linux® , si cambia el campo de propietario, no puede consultar o restaurar el objeto a menos que sea el usuario root. Sólo se puede actualizar la versión activa actual de una copia de seguridad.

Sintaxis

dsInt16_t  dsmUpdateObjEx
   (dsmUpdateObjExIn_t   *dsmUpdateObjExInP,
    dsmUpdateObjExOut_t  *dsmUpdateObjExOutP);

Parámetros

dsmUpdateObjExIn_t *dsmUpdateObjExInP
Esta estructura contiene los siguientes parámetros de entrada:
dsUint16_t stVersion (I)
La versión actual de la estructura que se utiliza.
dsUint32_t dsmHandle (I)
El manejador que asocia esta llamada con una llamada dsmInitEx anterior.
dsmSendType sendType (I)
El tipo de envío que se está realizando. El valor puede ser:
stBackup
Un objeto de copia de seguridad que se envía al servidor.
stArchive
Una objeto de copia archivada que se envía al servidor.
dsmObjName *objNameP (I)
Un puntero a la estructura que contiene el nombre del espacio del archivo, el nombre de alto y bajo rango y el tipo de objeto. No puede utilizar un comodín.
ObjAttr *objAttrPtr (I)
Pasa atributos de objeto a la aplicación. Los valores que se actualizan dependen del indicador en el campo objUpdAct. El atributo objCompressed se omite en esta llamada.

Los atributos son:

  • owner cambia el propietario si se especifica un nombre nuevo.
  • sizeEstimate es la cantidad de datos real que se envía en bytes. El valor se almacena en los metadatos de IBM® Storage Protect para su uso futuro.
  • objCompressed es un valor booleano que indica si los datos del objeto ya han sido comprimidos o no.
  • objInfo es un atributo que contiene la información nueva colocada en el campo objInfo. Configure objInfoLength con la longitud del nuevo objInfo.
  • mcNameP contiene el nombre de una clase de gestión que altera temporalmente la clase de gestión obtenida de dsmBindMC.
dsUint32_t objUpdAct
Especifica las máscaras de bit y las acciones de objUpdAct son:
DSM_BACKUPD_MC
Actualiza la clase de gestión del objeto.
DSM_BACKUPD_OBJINFO
Actualiza el objeto de información (objInfo), la longitud del objeto de información (objInfoLength), y la cantidad de datos que se envían (sizeEstimate) en la copia de seguridad del objeto.
DSM_BACKUPD_OWNER
Actualiza al propietario de la copia de seguridad del objeto.
DSM_ARCHUPD_DESCR
Actualiza el campo Description del objeto archivado. Especifique el valor para la nueva descripción a través del parámetro sendBuff .
DSM_ARCHUPD_OBJINFO
Actualiza el objeto de la información (objInfo), la longitud del objeto de información (objInfoLength), y la cantidad de datos que se envían (sizeEstimate) en el objeto archivado.
DSM_ARCHUPD_OWNER
Actualiza el propietario del objeto archivado.
ObjID archObjId
Especifica el ID del objeto único de un objeto archivado determinado. Debido a que varios objetos archivados pueden tener el mismo nombre, este parámetro identifica uno en concreto. Es posible obtener el ID del objeto utilizando una llamada de consulta de archivado.
dsmUpdateObjExOut_t *dsmUpdateObjExOutP
Esta estructura contiene los parámetros de salida:
dsUint16_t stVersion (I)
La versión actual de la estructura que se utiliza.

Códigos de retorno

Los números del código de retorno se proporcionan entre paréntesis ( ) en la siguiente tabla.

Tabla 1. Códigos de retorno de dsmUpdateObjEx
Código de retorno Explicación
DSM_RC_INVALID_ACTION (2012) Acción no válida.
DSM_RC_FS_NOT_REGISTERED (2061) El espacio de archivo no está registrado.
DSM_RC_BAD_CALL_SEQUENCE (2041) La secuencia de llamadas no es válida.
DSM_RC_WILDCHAR_NOTALLOWED (2050) Los caracteres comodín no están permitidos.
DSM_RC_ABORT_NO_MATCH (2) La consulta anterior no coincide.