![]() |
![]() |
Use this command to display information about files in a storage pool volume. You can use this command to identify files that the server has found to be damaged and files that have been backed up to a copy storage pool. This command is useful when a volume is damaged or before you:
Because this command can take a long time to run and the results can be very large, consider using the COUNT parameter to limit the number of files displayed.
Privilege Class
Any administrator can issue this command.
Syntax
>>-Query CONtent--volume_name--+--------------------+-----------> '-NODE--=--node_name-' >--+-------------------------------+--+------------------+------> '-FIlespace--=--file_space_name-' '-COUnt--=--number-' .-Type--=--ANY--------------. .-Format--=--Standard-----. >--+---------------------------+--+-------------------------+---> '-Type--=--+-ANY----------+-' '-Format--=--+-Standard-+-' +-Backup-------+ '-Detailed-' +-Archive------+ '-SPacemanaged-' (1) .-DAmaged--=--ANY-----. .-COPied-------=--ANY-. >--+---------------------+--+---------------------+-------------> '-DAmaged--=--+-ANY-+-' '-COPied--=--+-ANY-+--' +-Yes-+ +-Yes-+ '-No--' '-No--' .-NAMEType--=--SERVER------. >--+--------------------------+---------------------------------> '-NAMEType--=--+-SERVER--+-' +-UNIcode-+ '-FSID----' .-CODEType--=--BOTH-----------. >--+-----------------------------+----------------------------->< '-CODEType--=--+-UNIcode----+-' +-NONUNIcode-+ '-BOTH-------'
Notes:
Parameters
For a server that has clients with Unicode support, you may need to have the server convert the file space name that you enter. For example, you may need to have the server convert the name you enter from the server's code page to Unicode. See the NAMETYPE parameter for details. If you do not specify a file space name or specify only a single wildcard character for the name, you can use the CODETYPE parameter to limit the operation to Unicode file spaces or non-Unicode file spaces.
Use COPIED=YES to identify primary files that can be restored using the RESTORE VOLUME or RESTORE STGPOOL command.
Use COPIED=NO to identify primary files that cannot be restored using the RESTORE VOLUME or RESTORE STGPOOL command.
The default value is SERVER. Possible values are:
The default value is BOTH, which means that the file spaces are included regardless of code page type. Possible values are:
Examples
Task 1
Query the contents of the volume that is named f:\tsmstg\diskvol1.dsm. Limit the query to files backed up from the PEGASUS client node.
Results of the command include all logical files that make up any aggregate that is on the volume, even if the aggregate is stored on more than this volume. For aggregates, the query does not determine which logical files are actually stored on the volume for which the query is performed.
query content f:\tsmstg\diskvol1.dsm node=pegasus type=backup
+--------------------------------------------------------------------------------+ |Node Name Type Filespace FSID Client's Name for File | | Name | |--------------- ---- ---------- ---- ---------------------- | |PEGASUS Bkup \\pegasus\e$ 1 \UNI_TEST\ SM01.DAT | |PEGASUS Bkup \\pegasus\e$ 1 \UNI_TEST\ SM02.DAT | | | +--------------------------------------------------------------------------------+
See Task 2 for parameter definitions.
Task 2
Query the contents of the tape volume named WPD001. Display only files backed up by the node MARK, and only the first four files on the volume. Display complete information.
query content wpd001 node=mark count=4 type=backup format=detailed
+--------------------------------------------------------------------------------+ | Node Name: MARK | | Type: Bkup | | Filespace Name: \\mark\e$ | | Hexadecimal Filespace Name: | | FSID: 1 | | Client's Name for File: \UNI_TEST\ SM01.DAT | |Hexadecimal Client's Name for File: | | Aggregated?: 1/3 | | Stored Size: 2,746 | | Segment Number: | | Cached Copy?: No | | | | Node Name: MARK | | Type: Bkup | | Filespace Name: \\mark\e$ | | Hexadecimal Filespace Name: | | FSID: 1 | | Client's Name for File: \UNI_TEST\ SM02.DAT | |Hexadecimal Client's Name for File: | | Aggregated?: 2/3 | | Stored Size: 2,746 | | Segment Number: | | Cached Copy?: No | | | | Node Name: MARK | | Type: Bkup | | Filespace Name: \\mark\e$ | | Hexadecimal Filespace Name: | | FSID: 1 | | Client's Name for File: \UNI_TEST\ SM03.DAT | |Hexadecimal Client's Name for File: | | Aggregated?: 3/3 | | Stored Size: 2,746 | | Segment Number: | | Cached Copy?: No | | | | Node Name: MARK | | Type: Bkup | | Filespace Name: \\mark\f$ | | Hexadecimal Filespace Name: 5c5c6d61726b5c6624 | | FSID: 2 | | Client's Name for File: \UNI_TEST\ ELAP.REX | |Hexadecimal Client's Name for File: 5c554e495f544553545c20454c41502e524558 | | Aggregated?: 1/3 | | Stored Size: 2,372 | | Segment Number: | | Cached Copy?: No | +--------------------------------------------------------------------------------+
File space names and file names that can be in a different code page or locale than the server do not display correctly on the administrator's Web interface or the administrative command-line interface. The data itself is backed up and can be restored properly, but the file space or file name may display with a combination of invalid characters or blank spaces.
If the file space name is Unicode enabled, the name is converted to the server's code page for display. The results of the conversion for characters not supported by the current code page depends on the operating system. For names that Tivoli Storage Manager is able to partially convert, you may see question marks (??), blanks, unprintable characters, or "...". These characters indicate to the administrator that files do exist. If the conversion is not successful, the name is displayed as "...". Conversion can fail if the string includes characters that are not available in the server code page, or if the server has a problem accessing system conversion routines.
File space names and file names that can be in a different code page or locale than the server do not display correctly on the administrator's Web interface or the administrative command-line interface. The data itself is backed up and can be restored properly, but the file space or file name may display with a combination of invalid characters or blank spaces. The results of the conversion for characters not supported by the current code page depends on the operating system. For names that Tivoli Storage Manager is able to partially convert, you may see question marks (??), blanks, unprintable characters, or "...". These characters indicate to the administrator that files do exist.
If the file is not part of an aggregate, the field simply displays "no."
Related Commands
Table 171. Commands Related to QUERY CONTENT
Command | Description |
---|---|
BACKUP STGPOOL | Backs up a primary storage pool to a copy storage pool. |
DEFINE VOLUME | Assigns a volume to be used for storage within a specified storage pool. |
DELETE VOLUME | Deletes a volume from a storage pool. |
RESTORE STGPOOL | Restores files to a primary storage pool from copy storage pools. |
RESTORE VOLUME | Restores files stored on specified volumes in a primary storage pool from copy storage pools. |
UPDATE VOLUME | Updates the attributes of storage pool volumes. |