GENERATE DEDUPSTATS (Generate data deduplication statistics)

Use this command to generate data deduplication statistics for a directory-container storage pool or a cloud storage pool to determine data deduplication performance.

Privilege class

To issue this command, you must have system privilege, unrestricted storage privilege, or restricted storage privilege for the storage pool.

Syntax


>>-GENerate DEDUPSTats--pool_name--node_name-------------------->

   .-*------------------.  .-CODEType--=--BOTH-----------.   
>--+--------------------+--+-----------------------------+------>
   | .-,--------------. |  '-CODEType--=--+-UNIcode----+-'   
   | V                | |                 +-NONUNIcode-+     
   +---filespace_name-+-+                 '-BOTH-------'     
   | .-,--------.       |                                    
   | V          |       |                                    
   '-----FSID---+-------'                                    

   .-NAMEType--=--SERVER------.   
>--+--------------------------+--------------------------------><
   '-NAMEType--=--+-SERVER--+-'   
                  +-UNIcode-+     
                  '-FSID----'

Parameters

pool_name (Required)

Specifies the name of the storage pool that is reported in the data deduplication statistics. 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 only specify directory-container storage pools or cloud storage pools.

node_name (Required)

Specifies the name of the client node that is reported in the data deduplication statistics. 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 in the data deduplication statistics. This parameter is optional. You can use wildcard characters to specify this name. An asterisk is the default. Specify one of the following values:

*: Specify an asterisk (*) to show all file spaces or IDs.
filespace_name: Specifies the name of the file space. Specify more than one file space by separating the names with commas and no intervening spaces. FSID Specifies the file space identifier. This parameter is valid for clients with file spaces that are in Unicode format. Specify more than one file space by separating the names with commas and no intervening spaces.

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

Restrictions: The following restrictions apply to file space names and file space identifiers (FSID):

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

CODEType

Specifies what type of file spaces to include in the record. The default value is BOTH, which specifies that file spaces are included regardless of code page type. Use this parameter only when you enter an asterisk to display information about all file spaces. This parameter is optional. 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

Specifies how you want the server to interpret the file space names that you enter. Use this parameter when Tivoli® Storage Manager clients have file spaces that are in Unicode format, and are on Windows, NetWare, or Macintosh OS X operating systems. This parameter is optional.

This parameter is required if you specify a node name and a file space name or FSID.

Restriction: When you specify this parameter, the file space name cannot contain an asterisk.

Specify one of the following values:

SERVER: The server uses the server's code page to interpret the file space names. This is the default.
UNIcode: The server converts the file space name that is entered from the server code page to the UTF-8 code page. The success of the conversion depends on the actual characters in the name and the server's code page.
Tip: Conversion can fail if the string includes characters that are not available in the server code page, or if the server cannot access system conversion routines.
FSID: The server interprets the file space names as their file space IDs (FSIDs).

Example: Generate data deduplication statistics for a file space

Generate data deduplication statistics of a file space that is called /srvr that belongs to a directory-container storage pool, POOL1, that is stored on client node NODE1.

generate dedupstats pool1 node1 /srvr

Example: Generate data deduplication statistics of a Unicode-enabled file space

Generate data deduplication statistics of a Unicode-enabled file space that is called \\abc\c$ that belongs to client node NODE2. Have the server convert the \\abc\c$ file space name from the server code page to the UTF-8 code page.

generate dedupstats node2 \\abc\c$ nametype=unicode

Related commands

Table 1. Commands related to GENERATE DEDUPSTATS
Command	Description
DELETE DEDUPSTATS	Deletes data deduplication statistics.
QUERY DEDUPSTATS	Displays data deduplication statistics.