QUERY CLEANUP (Query the cleanup that is required in a source storage pool)

Use this command to display information about damaged files that are identified during a storage pool conversion process.

When you issue the CONVERT STGPOOL command to convert a FILE device class, a tape device class, or a virtual tape library (VTL) to a directory-container storage pool, some files in the source storage pool might not convert because of damaged data. To display damaged data that is identified during the conversion process, issue the QUERY CLEANUP command on a source storage pool.

To recover an undamaged version of the data from a copy or active-data storage pool, issue the RESTORE STGPOOL command. To recover an undamaged version of the data from a target replication server issue the REPLICATE NODE command and specify the RECOVERDAMAGED=YES parameter.

Privilege class

To issue this command, you must have restricted storage privilege.

Syntax

Parameters

pool_name(Required): Specifies the storage pool to query.

Example: Display damaged files that are identified by a storage pool conversion process

Display damaged files in a storage pool that is named POOL1. See Field descriptions for field descriptions.

query cleanup pool1

              File Name: \RTC\BDAT\GIGFILES\BF1.GB
                  State: Active        
            Stored Size: 1 GB
         Filespace Name: \\ibm838-r90gf0gx\c$
                   Type: Backup
            Client Name: CAKINProtection 
        Protection Date: 03/25/2016 16:47:57

Field descriptions

File Name

The name of the damaged file.

State

The state of the data in the inventory. The following states are possible:

Active: The version of the file in the inventory is active. You can have only one active version of the file in the inventory.

Inactive: The version of the file in the inventory is inactive. You can have multiple inactive versions of the file in the inventory.

Stored Size

The size of the data, in megabytes (MB) or gigabytes (GB), that is stored in the storage pool.

Filespace Name

The name of the file space where the file is assigned.

Type

The type of operation that was used to store the file. The following types are possible:

Backup: Files that are backed up.

Archive: Files that are archived.

SpaceMg: Files that are migrated from an IBM Spectrum® Protect for Space Management client.

Client Name

The name of the client that owns the file.

Protection Date

The time and date that the file was backed up, archived, or migrated by an IBM Spectrum Protect for Space Management client.

Related commands

Table 1. Commands related to QUERY CLEANUP
Command	Description
CONVERT STGPOOL	Convert a storage pool to a directory-container storage pool.
PROTECT STGPOOL	Protects a directory-container storage pool.
QUERY CONVERSION	Query conversion status of a storage pool.
REMOVE DAMAGED	Removes damaged data from a source storage pool.
REPAIR STGPOOL	Repairs a directory-container storage pool.
REPLICATE NODE	Replicates data in file spaces that belong to a client node.
RESTORE STGPOOL	Restores files to a primary storage pool from copy storage pools.