dsmDeleteObj

Editar en línea

La llamada de función dsmDeleteObj desactiva los objetos de copia de seguridad, suprime los objetos de copia de seguridad o suprime los objetos de archivado en el almacenamiento. El tipo dtBackup inactiva únicamente la copia de seguridad activa actual. El tipo dtBackupID elimina del servidor el ID de objeto especificado. Invoque esta función desde una transacción.

Consulte dsmBeginTxn para obtener más información.

Restricción: No puede suprimir objetos de copia de seguridad contenidos en un conjunto de retención. Para satisfaces los requisitos de retención de datos a largo plazo, estos archivos permanecerán en el almacenamiento de servidor y caducan de acuerdo con la fecha de caducidad del conjunto de retención tras la cual son aptos para su supresión.

Antes de enviar dsmDeleteObj, envíe la secuencia de consulta que se describe en Consulta del sistema IBM Storage Protect para obtener la información para delInfo. La llamada a dsmGetNextQObj devuelve una estructura de datos denominada qryRespBackupData para consultas de copia de seguridad o qryRespArchiveData para consultas de archivado. Estas estructuras de datos contienen información que necesita en delInfo.

El valor de maxObjPerTxn determina el número máximo de objetos que se pueden eliminar en una única transacción. Para obtener este valor, llame a dsmQuerySessInfo.

Sugerencia: El nodo debe tener el permiso adecuado establecido por el administrador. Para eliminar objetos archivados, debe tener autorización para eliminar copias archivadas. Para inactivar un objeto de copia de seguridad, no necesita autorización para suprimir copias de seguridad.

Sintaxis

dsInt16_t dsmDeleteObj  (dsUint32_t      dsmHandle,
   dsmDelType  delType,
   dsmDelInfo  delInfo)

Parámetros

dsUint32_t dsmHandle (I)

El manejador que asocia esta llamada con una llamada dsmInitEx anterior.

dsmDelType delType (I)

Indica qué tipo de objeto (copia de seguridad o archivada) se va a eliminar. Los valores posibles incluyen:

	Nombre	Descripción
	dtArchive	El objeto que se va a eliminar se archivó anteriormente.
	dtBackup	Al objeto que se va a desactivar se le ha realizado una copia de seguridad anteriormente.
	dtBackupID	Al objeto que se va a desactivar se le ha realizado una copia de seguridad anteriormente. Restricción: al utilizar este delType con objID elimina el objeto de copia de seguridad del servidor. Sólo un propietario del objeto puede eliminarlo. Es posible eliminar cualquier versión (activa o inactiva) de un objeto. El servidor reconcilia las versiones. Si elimina una versión activa de un objeto, la primera versión inactiva se transforma en activa. Si elimina una versión inactiva de un objeto, todas las versiones antiguas avanzan. El nodo debe estar registrado con el permiso backDel.

dsmDelInfo delInfo (I)

Una estructura cuyos campos identifican al objeto. Los campos son distintos, dependiendo de si el objeto es una copia de seguridad o una copia archivada. La estructura para desactivar una copia de seguridad de un objeto delBack, contiene el nombre del objeto y el grupo de la copia del objeto. La estructura de un objeto archivado, delArch, contiene el ID del objeto.

La estructura para eliminar una copia de seguridad de un objeto delBackID, contiene el ID del objeto.

Códigos de retorno

Los números de código de retorno se proporcionan entre paréntesis ( ).

Tabla 1. Códigos de retorno para dsmDeleteObj
Código de retorno	Explicación
DSM_RC_FS_NOT_REGISTERED (2061)	El nombre del espacio de archivos no está registrado.
DSM_RC_WRONG_VERSION_PARM (2065)	La versión de la API del cliente de aplicaciones es diferente de la versión de la biblioteca de IBM® Storage Protect .