Delete - deleting an object or image
Deleting a NetBackup XBSA object is done with the BSADeleteObject() function. BSADeleteObject() does not always delete the object specified, even if it returns a success status. The only objects that can be deleted using BSADeleteObject() are objects in which there was only one object created per transaction.
Based on those limitations, the BSADeleteObject() function is pretty straightforward. It takes a copyId as its parameter and deletes this object. Multiple objects can be deleted in one transaction and it is permissible to have query operations within a delete transaction. The object is not deleted until the transaction is committed, so these query operations in a delete transaction can return a deleted object.
Deleting a NetBackup image is done with the NBBSADeleteImage() function. NBBSADeleteImage() deletes an entire image that can contain one or more objects created per transaction.
The NBBSADeleteImage() function takes a copyId of any object contained in the image as its parameter and deletes the entire image. Multiple images can be deleted in one transaction and it is permissible to have query operations within a delete transaction. Unlike BSADeleteObject(), the deletion of the image takes place during the NBBSADeleteImage() call.
Note:
Deletion only removes an entry from the NetBackup catalog and not from the storage media. NetBackup allows media to be imported to recreate all of the images that are stored on them, and doing so may cause a deleted object or image to reappear.