Expire

Use the expire command to deactivate the current backup of a virtual machine (VM) on the IBM Storage Protect server.

When you are working in interactive mode, a prompt notifies you before objects are expired.

The expire command does not remove the VM from the local host. If you expire a VM that still exists on your local host, the VM is backed up again during the next incremental backup, unless you exclude the VM from backup processing.

Syntax

Parameters

OBJTYPE=VM vmname: vmname specifies the name of a VM. The active backup for the specified VM is expired on the IBM Storage Protect server. The VM name cannot contain wildcard characters.
When objtype=VM is specified, the expire command expires only full VM backups (MODE=IFFULL) for the VM that is specified on the vmname parameter.

Table 1. Expire command: Related options
Option	Where to use
dateformat	Client options file (dsm.opt) or command line.
noprompt Noprompt	Command line only.
numberformat Numberformat	Client options file (dsm.opt) or command line.
pick	Command line only.
timeformat Timeformat	Client user-options file (dsm.opt) or command line.

Example

Task: Deactivate the current backup of the VM that is named vm_test.
Command: dsmc expire –objtype=VM vm_test