QUERY DEDUPSTATS (Query data deduplication statistics)

Use this command to display information about data deduplication statistics for a directory-container storage pool or a cloud storage pool.

You must issue the GENERATE DEDUPSTATS command before you can issue the QUERY DEDUPSTATS command.

Privilege class

Any administrator can issue this command.

Syntax


>>-Query DEDUPSTats--+-----------+--+-----------+--------------->
                     '-pool_name-'  '-node_name-'   

   .-*------------------.  .-Format--=--Standard-----.   
>--+--------------------+--+-------------------------+---------->
   | .-,--------------. |  '-Format--=--+-Standard-+-'   
   | V                | |               '-Detailed-'     
   +---filespace_name-+-+                                
   | .-,--------.       |                                
   | V          |       |                                
   '-----FSID---+-------'                                

   .-CODEType--=--BOTH-----------.   
>--+-----------------------------+------------------------------>
   '-CODEType--=--+-UNIcode----+-'   
                  +-NONUNIcode-+     
                  '-BOTH-------'     

   .-NAMEType--=--SERVER------.                           
>--+--------------------------+--+--------------------+--------->
   '-NAMEType--=--+-SERVER--+-'  '-BEGINDate--=--date-'   
                  +-UNIcode-+                             
                  '-FSID----'                             

>--+--------------------+--+------------------+----------------->
   '-BEGINTime--=--time-'  '-ENDDate--=--date-'   

                         .-ALLSTats--=--No------.   
>--+------------------+--+----------------------+--------------><
   '-ENDTime--=--time-'  '-ALLSTats--=--+-Yes-+-'   
                                        '-No--'

Parameters

pool_name

Specifies the name of the directory-container storage pool whose data is contained in the data deduplication statistics. This parameter is optional. If you do not specify a value for this parameter, all storage pools are displayed. You can specify up to 30 characters for the storage pool name. If you specify more than 30 characters, the command fails.

Restriction: You can specify directory-container storage pools or cloud storage pools only.

node_name

Specifies the name of the client node whose data is contained in the data deduplication statistics. This parameter is optional. If you do not specify a value for this parameter, all nodes are displayed. You can specify up to 64 characters for the node name. If you specify more than 64 characters, the command fails.

filespace_name or FSID

Specifies the names of one or more file spaces that contain the data to be included in the data deduplication statistics. This parameter is optional. You can use wildcard characters to specify this name. If you do not specify a value for this parameter, all file spaces are displayed. You can specify more than one file space by separating the names with commas and no intervening spaces.

For a server that has clients with support for file spaces that are in Unicode format, you can enter either a file space name or a file space identifier (FSID). If you enter a file space name, you might need to have the server convert the file space name that you enter. For example, you might need to have the server convert the name that you enter from the server's code page to Unicode.

Restrictions: The following restrictions apply to file space names and FSIDs:

You must specify a node name if you specify a file space name.
Do not mix file space names and FSIDs in the same command.

Format

Specifies how the information is displayed. This parameter is optional. Specify one of the following values:

Standard: Specifies that partial information is displayed for the specified data deduplication sets. This is the default.
Detailed: Specifies that complete information is displayed for the specified data deduplication sets.

CODEType

Specify what type of file spaces to include in the operation. The default value is BOTH, which specifies that file spaces are included regardless of code page type. Use this parameter only when you enter a single wildcard character for the file space name. Specify one of the following values:

UNIcode: Include file spaces that are in Unicode format.
NONUNIcode: Include file spaces that are not in Unicode format.
BOTH: Include file spaces regardless of code page type. This is the default.

NAMEType

Specify how you want the server to interpret the file space names that you enter. This parameter is useful when the server has clients with support for file spaces that are in Unicode format. You can use this parameter for IBM Spectrum Protect™ clients that use Windows, NetWare, or Macintosh OS X operating systems.

Use this parameter only when you enter a node name and a file space name or FSID.

Restriction: When you specify this parameter, the file space name cannot contain a wildcard.