The expire command deactivates the backup objects that you specify in the file specification or with the filelist option. You can specify an individual file to expire, or a file that contains a list of files to expire. If OBJTYPE=VM, this command deactivates the current backup for a virtual machine.

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

The expire command does not remove workstation files. If you expire a file or directory that still exists on your workstation, the file or directory is backed up again during the next incremental backup, unless you exclude the object from backup processing.

If you expire a directory that contains active files, those files are not displayed in a subsequent query from the GUI. However, these files are displayed on the command line, if you specify the correct query with a wildcard character for the directory.

Note: Because the expire command changes the server picture of the client file system without changing the client file system, the expire command is not allowed on files that are on a file system that is monitored by the Tivoli® Storage Manager journal service.


Read syntax diagramSkip visual syntax diagram
              .-OBJTYPE=FILE-- --filespec-.                              
>>-EXPire-- --+---------------------------+--+-----------------------+-->
                                             '-OBJTYPE=VM-- --vmname-'   



Specifies a path and a file name that you want to expire. You can enter only one file specification on this command. However, you can use wildcards to select a group of files or all the files in a directory. If you specify the filelist option, the filespec designation is ignored.
vmname specifies the name of a virtual machine. The active backup for the specified virtual machine is expired. The virtual machine name cannot contain wildcard characters.

When objtype=VM is specified, the expire command expires only full virtual machine backups (MODE=FULL or MODE=IFFULL) for the virtual machine 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.
filelist Command line only.
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.


Deactivate the letter1.txt file in the home directory.

Command: dsmc expire c:\home\letter1.txt

Deactivate all files in the admin\mydir directory.

Command: dsmc expire c:\admin\mydir\*

Deactivate all files that are named in the c:\avi\filelist.txt file.

Command: dsmc expire -filelist=c:\avi\filelist.txt

Deactivate the current backup of the virtual machine that is named vm_test.

Command: dsmc expire –objtype=VM vm_test