Tivoli Header

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:

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 on an MVS system console and in the Job Log for the TSM server.

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 when you issue this command with the MVS MODIFY command.

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

Command Description
AUDIT LICENSES Checks for compliance with defined licenses.
CANCEL PROCESS Cancels a background server process.
QUERY PROCESS Displays information about background processes.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]