QUERY STGPOOLDIRECTORY (Query a storage pool directory)

Use this command to display information about one or more storage pool directories.

Privilege class

Any administrator can issue this command.

Syntax


                           .-*---------.   
>>-Query STGPOOLDIRectory--+-----------+------------------------>
                           '-directory-'   

                              .-ACCess--=--Any-------------.   
>--+-----------------------+--+----------------------------+---->
   '-STGpool--=--pool_name-'  '-ACCess--=--+-READWrite---+-'   
                                           +-READOnly----+     
                                           +-DEStroyed---+     
                                           +-Any---------+     
                                           '-UNAVailable-'     

   .-Format--=--Standard-----.   
>--+-------------------------+---------------------------------><
   '-Format--=--+-Standard-+-'   
                '-Detailed-'

Parameters

directory

Specifies the storage pool directory to query. This parameter is optional.

*: Specifies that an asterisk (*) represents a wildcard character. Use wildcard characters such as an asterisk to match any characters. Alternatively, you can use a question mark (?) or a percent sign (%) to match exactly one character. This is the default.
directory: Specifies the storage pool directory. If you do not specify a value for this parameter, all storage pool directories are displayed. The maximum length of the storage pool directory is 1024.

STGpool

Specifies the name of the storage pool to query. If you do not specify a value for this parameter, all storage pool directories are displayed. The maximum length of the storage pool name is 30. This parameter is optional.

ACCess

Specifies that output is restricted by directory access mode. This parameter is optional. Specify one of the following values:

READWrite: Display all storage pool directories with an access mode of READWRITE.
READOnly: Display all storage pool directories with an access mode of READONLY.
DEStroyed: Display all storage pool directories with an access mode of DESTROYED. The directories are designated as permanently damaged in the storage pool directory.
Any: Display all storage pool directories. This is the default.
UNAVailable: Display directories with an access mode of UNAVAILABLE.

Format

Specifies how the information is displayed. This parameter is optional. The default value is STANDARD. You can specify one of the following values:

Standard: Specifies that partial information is displayed.
Detailed: Specifies that complete information is displayed.

Example: Display summary information for a specific storage pool directory

Display information for the storage pool directory that is named DPOOL. See Field descriptions for field descriptions.

query stgpooldirectory C:\data

Storage     Directory     Access
Pool Name     
----------  ----------   --------- 
DPOOL       C:\data       Read/Write

Example: Display detailed storage pool directory information

Display details for the storage pool directory named that is named DPOOL.

query stgpooldirectory stgpool=dpool format=detailed

                       Storage Pool Name: DPOOL
                       	       Directory: /storage/sampleDir
                                  Access: Read/Write
                         Free Space(MB): 323,170
                        Total Space(MB): 476,938
                             File System: /storage
                           Absolute Path: /storage/data

                       Storage Pool Name: DPOOL
                       	       Directory: /storage2/sampleDir
                                  Access: Read/Write
                         Free Space(MB): 323,170
                        Total Space(MB): 476,938
                             File System: /storage
                           Absolute Path: /storage2/sampleDir

Field descriptions

Storage Pool Name: The name of the storage pool.

Directory: The name of the storage pool directory.

Access: The access mode of the data in the storage pool directory.

Free Space (MB): The amount of space in the storage pool directory, in megabytes, that is not in use.

Total Space (MB): The total amount of space in the storage pool directory, in megabytes.

File System: The name of the file system where the storage pool directory is located.

Absolute Path: The absolute path name where the storage pool directory is located. The absolute path name contains the name of the root directory and all subdirectories in the path name. All symbolic links are resolved in the absolute path name.

Table 1. Commands related to QUERY STGPOOLDIRECTORY
Command	Description
DEFINE STGPOOL	Defines a storage pool as a named collection of server storage media.
DEFINE STGPOOLDIRECTORY	Defines a storage pool directory to a directory-container or cloud-container storage pool.
DELETE STGPOOLDIRECTORY	Deletes a storage pool directory from a directory-container or cloud-container storage pool.
UPDATE STGPOOLDIRECTORY	Changes the attributes of a storage pool directory.