Administrator's Reference

EXPIRE INVENTORY (Manually Start Inventory Expiration Processing)

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 131. Commands Related to EXPIRE INVENTORY