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
- Encryption type
- Client-side
data deduplication
- Retention initiation
- Whether or not the file is on hold
The following show sample output from the detail option.
Size Archive Date - Time File - Expires on - Description
---- ------------------- -------------------------------
219 B 09/03/2009 09:32:13 /Volumes/Data/info.txt 09/03/2010
Archive Date: 09/03/2009
RetInit:STARTED Obj
Held:NO
Modified: 09/02/2009 19:43:00 Accessed: 09/03/2009 09:31:23 Inode changed: 09/02/2009 19:43:00
Compressed: NO Encryption Type: None
Client-deduplicated: NO Size Archive Date - Time File - Expires on - Description
---- ------------------- -------------------------------
219 B 09/03/2009 09:32:13 \\halley\m$\tsm620c.0901fa\debug\bin\
winnt_unicode\dsm.opt 09/03/2010
Archive Date: 09/03/2009
RetInit:STARTED Obj
Held:NO
Modified: 09/02/2009 19:43:00 Created: 09/01/2009 15:31:23
Compressed: NO Encryption Type: None
Client-deduplicated: NO Supported Clients
This command is valid for all clients.
Syntax
>>-Query ARchive--+------------+--------------------------------> '- --options-' >--+- --filespec----------------------+--+- --filespec---+----->< '- --{--filespacename--}--filespec-' '- --"filespec"-'
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. This 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 has 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 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:\proj directory.
Command: q ar c:\proj\*
- Task
- Display a list of all your archived files in the /devel directory
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:\proj directory.
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:\dir1 directory.
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:\proj directory
containing a file extension of .dev. Use the dateformat and timeformat options.
Command: q ar –date=5 –time=4 c:\proj\*.dev
- Task
- Last week you changed the label of your c: drive
to store and archived some files. Yesterday you changed the
label to dev and archived more files. Display a list of all
the files you archived in the c:\proj directory when
the label was store.
Command: q ar {store}\proj\*
- Task
- Last week 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/proj directory
whose first four characters of the file name begin with proj.
Command: q ar "/home/proj/proj*"