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.

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.

When you have the Tivoli Disaster Recovery Manager product for your TSM server, the inventory expiration process removes eligible virtual volumes that are used for database backup. The SET DRMDBBACKUPEXPIREDAYS command controls when these volumes are eligible for expiration. The inventory expiration process that runs during TSM initialization does not remove virtual volumes.

Privilege Class

To issue this command, you must have system privilege.

Syntax

                       .-Quiet--=--No------.
>>-EXPIre Inventory----+-------------------+-------------------->
                       '-Quiet--=--+-No--+-'
                                   '-Yes-'
 
      .-Wait--=--No------.
>-----+------------------+---+-----------------------+---------><
      '-Wait--=--+-No--+-'   '-DUration--=--minutes--'
                 '-Yes-'
 

Parameters

Quiet
Specifies whether the server suppresses detailed messages about policy changes during 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.

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

Related Commands

Table 107. 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 ]