Links

DELVOL

The DELVOL command is used to delete backup versions created by the full-volume dump policy runs. The Model9 server finalization process automatically deletes expired backups as part of the generation management process.

DELVOL - Logic

The user must have READ access to the Model9 Resource M9.CLI.DELVOL.
The deleted full-volume dump will be visible in the UI until a periodic synchronization, which by default, is performed automatically every 5 minutes. If needed, on-demand synchronization can be performed via the UI, by clicking the “SYNC WITH STORAGE” button in the “Agents” tab. See the Administration and User Guide for more information.
Warning
The DELVOL action cannot be undone.

DELVOL - Syntax

M9CLI DELVOL <volser>
UNIQUEID(<uniqueId>)
[PURGE]

DELVOL - Required parameters

Parameter
Description
volser
A specific volume name.
uniqueid
The unique id or a partial prefix of the unique id of the deleted full-volume dump.

DELVOL - Optional parameters

Option
[Short option]
Description
Format
Examples
PURGE
Deletes backup of a full-volume dump, although it has not yet expired. The user must have READ access to the Model9 Resource M9.CLI.DELVOL.PURGE

DELVOL - Output

The output displays the given DELVOL command and parameters, followed by the requested information:
ZM9I073I Backup of volume <volume_name> with UNIQUEID <uniqueid> was deleted successfully
If the full-volume dump has not yet expired, it will not be deleted, and the message ZM9I077E will be displayed:
ZM9I077E Backup of volume <volume_name> with UNIQUEID <uniqueid> has not expired yet, use the PURGE keyword to force delete regardless of expiration
If the full-volume dump specified doesn't exists, the message ZM9I058E will be displayed:
ZM9I058E UNIQUEID <uniqueid> was not found for volume: <volume_name>

DELVOL - Examples

Deleting a backup that has not yet expired or with no expiration date:
TSO M9CLI DELVOL M9SYS1 UNIQUEID(9009F2C3) PURGE