QUERY FSCOUNTS (Query number of objects)

Edit online

Use this command to display information about the number of objects (files and directories) in file spaces that belong to a client node.

Tip: To obtain accurate information, issue the QUERY FSCOUNTS command after the backup operations ends. Also, if you are currently expiring objects from the file space, the numbers might not reflect the latest changes.

The database is queried and the counts are completed in real time.

Privilege class

Any administrator can issue this command.

Syntax

Read syntax diagramSkip visual syntax diagram Query FSCounts *node_name*file_space_nameNAMEType=SERVERNAMEType=SERVERUNIcodeFSIDCODEType=BOTHCODEType=UNIcodeNONUNIcodeBOTH

Parameters

node_name (Required)
Specifies the client node to which the file space belongs. You can use wildcard characters to specify this name, or use a group name. A group name specifies the name of the group to which the client node belongs. This parameter is required. Comma-delimited lists are not allowed. An asterisk specifies all client nodes.
NAMEType
Specifies 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 Unicode. You can use this parameter for Unicode-enabled IBM Storage Protect clients that have Windows, Macintosh OS X, and NetWare operating systems.

Use this parameter only when you enter a partly qualified or fully qualified file space name. The default value is SERVER. You can specify one of the following values:

SERVER
The server uses the server code page to interpret the file space names.
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 code page. Conversion can fail if the string includes characters that are not available in the server code page, or if the server has problems accessing system conversion routines.
FSID
The server interprets the file space names as their file space IDs (FSIDs).
CODEType
Specifies what type of file spaces are to be included in the operation. The default is BOTH, meaning 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. You can specify one of the following values:
UNIcode
Include only file spaces that are in Unicode.
NONUNIcode
Include only file spaces that are not in Unicode.
BOTH
Include file spaces regardless of code page type.

Field descriptions

Node Name
Specifies the name of the client node.
FSID
Specifies the file space ID of the file space.
Filespace Type
Specifies the type of file space.

A file space type that is appended with "(VFS)" denotes that this file space name is a virtual file space mapping for a directory path on a network-attached storage (NAS) device.

Is Filespace Unicode?
Indicates whether the file space is Unicode.

Related commands

Table 1. Commands related to QUERY FSCOUNTS
Command Description
QUERY NODE Displays partial or complete information about one or more clients.
QUERY OCCUPANCY Displays file space information by storage pool.