Administrator's Reference

EXPIRE INVENTORY (Manually Start Inventory Expiration Processing)

Use the EXPIRE INVENTORY command to manually start inventory expiration processing. Only one expiration process is allowed at any time; therefore, if expiration processing is currently running, another process cannot be started. Expiration eligibility is determined by policy information assigned to either the backup or archive files. If a file is eligible for expiration, the storage used by this file is deallocated.

Automatic expiration processing is controlled by the EXPINTERVAL option specified in the ADSM server options file. If EXPINTERVAL is set to 0, no automatic expiration will occur, and this command will be necessary 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.

The inventory expiration process removes client backup and archive file copies from server storage under the terms specified by the management classes to which the files are bound. The management class copygroup parameters, RETEXTRA and RETVER, control backup version and archive copy deletion, respectively. Unexpired backup versions and archive copies are considered by the license audit process in determining the amount of storage managed by the server.

When the Disaster Recovery Manager (DRM) is licensed, the inventory expiration process removes database backup virtual volumes (except during ADSM initialization). The SET DRMDBBACKUPEXPIREDAYS command controls when these volumes are eligible for expiration. For additional information, see the SET DRMDBBACKUPEXPIREDAYS command.

Privilege Class

To issue this command, you must have system privilege.

Syntax

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

Parameters

Quiet=quietvalue

Specifies whether to suppress detailed messages during ADSM's expiration processing. Normally ADSM sends detailed messages when you make policy changes that affect client files, such as deleting a management class or copy group. You can use this option to reduce the number of messages about policy changes that are generated during expiration processing.

When you specify QUIET=YES, ADSM will issue 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. This parameter is optional.

You can also specify the EXPQUiet option in the server options file to automatically determine if expiration processing is performed with minimal summary messages.

The values are:

No

Specifies that ADSM sends detailed informational messages. No is the default.

Yes

Specifies that ADSM sends only minimal summary messages and only for files that have expired based on the copy group in the default management class or retention grace period for the domain.

Wait=waitvalue

Specifies whether to wait for the server to complete processing this command in the foreground. This parameter is optional. The default value is No.

Note:

You cannot specify Wait=Yes from the server console.

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. Messages created from the background process are displayed 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.

Examples

Task

Issue the EXPIRE INVENTORY command.

Command:

expire inventory

Related Commands

Table 95. 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 one or all background server processes.