Query Archive
The query archive command displays a list of your archived files and the following information about each file: file size, archive date, file specification, expiration date, and archive description.
If you use the detail option with the query
archive command, the client displays the following additional
information:
- Last modification date
Last access date- Last file attributes (inode)
change date
Creation date- Compression type
- Encryption type
- Client-side
data deduplication
- Retention initiation
- Whether the file is on hold
- Size of ACL metadata (IBM
Spectrum Scale), for AIX® and Linux® clients
- Server storage information (media class, volume ID, and restore order), for
AIX and Linux clients
The following example shows sample output when the query archive command is issued with the detail option:.
Size Archive Date - Time File - Expires on - Description
---- ------------------- -------------------------------
219 B 08/15/2016 09:32:13 /Volumes/Data/info.txt 08/16/2016
Archive Date: 08/16/2016
RetInit:STARTED Obj
Held:NO
Modified: 03/02/2016 19:43:00 Accessed: 03/03/2016 09:31:23 Inode changed: 03/02/2016 19:43:00
Compression Type: LZ4 Encryption Type: None Client-deduplicated: YES
ACL Size: 0 Media Class: Fixed Volume ID: 0008 Restore Order: 00000000-0000001F-00000000-00600774Size Archive Date - Time File - Expires on - Description
---- ------------------- -------------------------------
219 B 03/03/2016 09:32:13 \\halley\m$\tsm620c.0901fa\debug\bin\
winnt_unicode\dsm.opt 03/03/2016
Archive Date: 03/03/2016
RetInit:STARTED Obj
Held:NO
Modified: 03/03/2016 19:43:00 Created: 03/01/2016 15:31:23
Compression Type: LZ4 Encryption Type: None Client-deduplicated: YESFor more information about the compression type, see Compression.
Supported Clients
This command is valid for all clients.
Syntax
Parameters
- filespec
- Specifies the path and file name that you want to query. Use wildcard
characters to specify a group of files or all the files in a directory.
If you use wildcard characters, enclose the file specification in
double quotation marks. Specify an asterisk (*) to query all archived
files in the current directory.
- filespec
- Specifies the path and file name that you want to query. Use wildcard
characters to specify a group of files or all the files in a directory.
If you include filespacename, do not include a drive letter in the file specification. Drive label names are only used for removable media.
- {filespacename}
- Specifies the file space (enclosed in braces) on the server that
contains the file that you want to query. The file space is the name
on the workstation drive from which the file was archived. The following
example is valid for specifying a UNC name: {'\\machine\C$'}. Use the filespacename if the name was changed or if you are querying files that were archived from another node with drive labels that are different from yours.Note: You must specify a mixed or lowercase NTFS filespacename that is enclosed in quotation marks within braces, for example, {"NTFSDrive"}. Single quotation marks or double quotation marks are valid in loop mode. For example: {"NTFSDrive"} and {'NTFSDrive'} are both valid. In batch mode, only single quotation marks are valid.
| Option | Where to use |
|---|---|
| dateformat |
Client options file
(dsm.opt) or command line. |
| dateformat |
Client user-options
file (dsm.opt) or command line. |
| description | Command line only. |
| detail | Command line only. |
| dirsonly | Command line only. |
| filelist | Command line only. |
| filesonly | Command line only. |
| fromdate | Command line only. |
| fromnode | Command line only. |
| fromowner |
Command line only. |
| fromtime | Command line only. |
| numberformat |
Client options file
(dsm.opt) or command line. |
| numberformat |
Client user-options
file (dsm.opt) or command line. |
| querysummary | Command line only. |
| scrolllines |
Client options file
(dsm.opt) or command line. |
| scrolllines |
Client user-options
file (dsm.opt) or command line. |
| scrollprompt |
Client options file
(dsm.opt) or command line. |
| scrollprompt |
Client user-options
file (dsm.opt) or command line. |
| subdir |
Client options file
(dsm.opt) or command line. |
| subdir |
Client user-options
file (dsm.opt) or command line. |
| timeformat |
Client options file
(dsm.opt) or command line. |
| timeformat |
Client user-options
file (dsm.opt) or command line. |
| todate | Command line only. |
| totime | Command line only. |
Examples
- Task
- Display a list of all your archived files in the current working
directory.
Command:
q archive "*" - Task
- Display a list of all your archived files in the
c:\projdirectory.Command:
q ar c:\proj\* - Task
- Display a list of all your archived files in the
/develdirectory and all of its subdirectories.Command:
query archive "/devel/*" -subdir=yes - Task
- Display a list of archived files from your
c:drive with the description "January Ledgers".Command:
query archive c:\ -su=y -descr="January Ledgers" - Task
- Display a list of all your archived files in the current directory.
Use the dateformat and timeformat options
to reformat the dates and times.
Command:
q ar –date=5 –time=1 "*" - Task
- Display a list of all your archived files in the
c:\projdirectory. Use the dateformat and timeformat options to reformat the dates and times.Command:
q ar –date=5 –time=4 c:\proj\* - Task
- Display a list of all your archived files in the current directory.
Use the detail option to display the last modification
date and the last access date of each file.
Command:
q ar -detail "*" - Task
- Display a list of all your archived files in the
c:\dir1directory. Use the detail option to display the last modification date and the creation date of each file.Command:
q ar -detail c:\dir1\* - Task
- Display a list of archived files in the
c:\projdirectory that contains a file extension of.dev. Use the dateformat and timeformat options.Command:
q ar –date=5 –time=4 c:\proj\*.dev - Task
- Recently you changed the label of your
c:\drive tostoreand archive some files. Then, yesterday the label was changed todevand some more files were archived. Display a list of all the files you archived in thec:\projdirectory when the label wasstore.Command:
q ar {store}\proj\* - Task
- Recently you archived files from a diskette labeled
docs. Display a list of all the files you archived.Command:
q ar {docs}\* - Task
- Display a list of archived files in the
/home/projdirectory whose first four characters of the file name begin withproj.Command:
q ar "/home/proj/proj*"