Tivoli Header
Administrator's Reference
Use this command to manually start inventory expiration processing.
The inventory expiration process removes client backup and archive file copies
from server storage based on policy specified in the backup and archive copy
groups of the management classes to which the files are bound.
When you have the Tivoli Disaster Recovery Manager product for your TSM
server, the inventory expiration process also removes eligible virtual volumes
that are used for the following:
- Database backups of type BACKUPFULL, BACKUPINCR, and DBSNAPSHOT.
The SET DRMDBBACKUPEXPIREDAYS command controls when these volumes are eligible
for expiration.
- Recovery plan files of type RPFILE and RPFSNAPSHOT. The SET
DRMRPFEXPIREDAYS command controls when these volumes are eligible for
expiration.
The inventory expiration process that runs during server initialization
does not remove these virtual volumes.
Only one expiration process is allowed at any time. If an expiration
process is currently running, you cannot start another process.
You can set up automatic expiration processing with the EXPINTERVAL server
option. If you set the EXPINTERVAL to 0, the server does not run
expiration automatically, and you must issue this command to start expiration
processing.
This command creates a background process that can be canceled with the
CANCEL PROCESS command. To display information on background processes,
use the QUERY PROCESS command.
Privilege Class
To issue this command, you must have system privilege.
Syntax
.-Quiet--=--No------.
>>-EXPIre Inventory--+-------------------+---------------------->
'-Quiet--=--+-No--+-'
'-Yes-'
.-Wait--=--No------. .-SKipdirs--=--No------.
>--+------------------+--+----------------------+--------------->
'-Wait--=--+-No--+-' '-SKipdirs--=--+-No--+-'
'-Yes-' '-Yes-'
>--+----------------------+------------------------------------><
'-DUration--=--minutes-'
Parameters
- Quiet
- Specifies whether the server suppresses detailed messages about policy
changes during the expiration processing. This parameter is
optional. The default is NO. Possible values are:
- No
- Specifies that the server sends detailed informational messages.
- Yes
- Specifies that the server sends only summary messages. The server
issues messages about policy changes only when files are deleted and either
the default management class or retention grace period for the domain has been
used to expire the files.
You can also specify the EXPQUIET option in the server options file to
automatically determine if expiration processing is performed with summary
messages.
- Wait
- Specifies whether to wait for the server to complete processing this
command in the foreground. This parameter is optional. The
default value is NO. Possible values are:
- No
- Specifies that the server processes this command in the background.
You can continue with other tasks while the command is being processed.
The server displays messages that are created from the background process
either in the activity log or the server console, depending on where messages
are logged.
- Yes
- Specifies that the server processes this command in the foreground.
You wait for the command to complete before continuing with other
tasks. The server then displays the output messages to the
administrative client when the command completes.
- Note:
- You cannot specify WAIT=YES from the server console.
- SKipdirs
- Specifies whether the server skips directory type objects during the
expiration processing. This parameter is optional. The default
is NO. Possible values are:
- No
- Specifies that the server will expire files and directories based upon the
appropriate policy criteria.
- Yes
- Specifies that the server will skip directory type objects during
expiration processing, even if the directories are eligible for
expiration.
- DUration
- Specifies the maximum number of minutes for the expiration process to
run. The process stops when the specified number of minutes pass or
when all eligible expired objects are deleted, whichever comes first.
You can specify a number from 1 to 999999. This parameter is
optional.
Examples
Task
Run the expiration process for two hours.
- Command:
- expire inventory duration=120
Task
Run the expiration process on files only.
- Command:
- expire inventory skipdirs=yes
Related Commands
Table 133. Commands Related to EXPIRE INVENTORY
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]