DELETE DEDUPSTATS (Delete data deduplication statistics)

Privilege class

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

Parameters

pool_name (Required)

Specifies the name of the directory-container 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

Specifies the name of the client node that is reported 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 name or file space ID (FSID) of one or more file spaces that is reported 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 report. 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 IBM® Storage Protect 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. 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).

TODate

Specifies the latest date for statistics to be deleted. IBM Storage Protect deletes only those statistics with a date on or before the date you specify. This parameter is optional.

Specify one of the following values:

Value	Description	Example
MM/DD/YYYY	A specific date.	10/15/2015 If you specify a date, all candidate records that are written on that day (ending at 11:59:59 pm) will be evaluated.
TODAY	The current date.	TODAY
TODAY-days or -days	The current date minus days specified. The maximum number of days you can specify is 9999.	TODAY–1 or –1. To display information that is created until yesterday, you can specify TODATE=TODAY-1 or TODATE= -1.
EOLM (End Of Last Month)	The last day of the previous month.	EOLM
EOLM-days	The last day of the previous month minus days specified.	EOLM-1 To include records that were active a day before the last day of the previous month.
BOTM (Beginning Of This Month)	The first day of the current month.	BOTM
BOTM+days	The first day of the current month, plus days specified.	BOTM+9 To include records that were active on the 10th day of the current month.

TOTime

Specifies that you want to delete data deduplication statistics that are created on or before this time on the specified date. This parameter is optional. The default is the end of the day (23:59:59). Specify one of the following values:

Value	Description	Example
HH:MM:SS	A specific time on the specified date.	12:30:22
NOW	The current time on the specified date.	NOW
NOW+HH:MM or +HH:MM	The current time plus hours and minutes on the specified date.	NOW+03:00 or +03:00. If you issue the DELETE DEDUPSTATS command at 9:00 with TOTIME=NOW+03:00 or TOTIME=+03:00, IBM Storage Protect deletes records with a time of 12:00 or earlier on the specified date.
NOW-HH:MM or -HH:MM	The current time minus hours and minutes on the specified date.	NOW-03:30 or -03:30. If you issue the DELETE DEDUPSTATS command at 9:00 with TOTIME=NOW-3:30 or TOTIME=-3:30, IBM Storage Protect deletes records with a time of 5:30 or earlier on the specified date.

Related commands

Table 1. Commands related to DELETE DEDUPSTATS

Command	Description
GENERATE DEDUPSTATS	Generates data deduplication statistics.
QUERY DEDUPSTATS	Displays data deduplication statistics.