![]() |
![]() |
The dsmDeleteObj function call inactivates backup objects, deletes backup objects, or deletes archive objects in storage. The dtBackup type inactivates the currently active backup copy only. The dtBackupID type removes from the server whichever object ID is specified. Call this function from within a transaction. See dsmBeginTxn for more information.
Before you send dsmDeleteObj, send the query sequence that is described in Querying the TSM System to obtain the information for delInfo. The call to dsmGetNextQObj returns a data structure named qryRespBackupData for backup queries, or qryRespArchiveData for archive queries. These data structures contain the information that you need for delInfo.
The value of maxObjPerTxn determines the maximum number of objects that you can delete in a single transaction. To obtain this value, call dsmQuerySessInfo.
dsInt16_t dsmDeleteObj (dsUint32_t dsmHandle, dsmDelType delType, dsmDelInfo delInfo)
Parameters
dtArchive | The object to delete previously was archived. |
dtBackup | The object to inactivate previously was backed up. |
dtBackupID | The object to delete previously was backed up.
To use this delete type, you must have a TSM server, version 3.7.04 or later. Attention: Using this delType with objID removes the backup object from the server. Only an owner of an object can delete it. You can delete any version (active or inactive) of an object. The server reconciles the versions. If you delete an active version of an object, the first inactive version becomes active. If you delete an inactive version of an object, all older versions will advance. The node must be registered with backDel permission. |
The structure to remove a backup object, delBackID, contains the object ID.
The return code numbers are provided in parentheses ( ).
Table 22. Return Codes for dsmDeleteObj
Return Code | Explanation |
---|---|
DSM_RC_FS_NOT_REGISTERED (2061) | Filespace name is not registered. |
DSM_RC_WRONG_VERSION_PARM (2065) | Application client API version is different from the TSM library version. |