The SEARCH option searches for specific files on a device.
Syntax :
SEARCH <device>/Qualifiers
1 – Qualifiers
1.1 /ACCESS
/ACCESS=keyword(=value)
This qualifier is used in combination with 3 possible
keywords : BEFORE=date, SINCE=date or NONE. The last access
date is used for selecting files. Use SINCE and BEFORE or NONE ,
but not both. The NONE keyword returns files which don't have a
last access date set. Examples :
o /ACCESS=BEFORE=date
o /ACCESS=(BEFORE=date,SINCE=anotherdate)
o /ACCESS=NONE
1.2 /ACE
/ACE=identifier
Searches for files containing an ACL list with an ACE for
this identifier.
1.3 /ALLOCATED
When using the /SIZE qualifier, the default size
used for comparison is the actual file size. Use
/ALLOCATED to force DFU to use the allocated filesize
for comparison.
1.4 /APPEND
/APPEND=filename
Same as /OUTPUT, but the output will be appended to the
file if it already exists. Thus output from multiple
DFU commands can be put in the same output file.
If the file does not exists it will be created.
1.5 /ATTRIBUTE
/ATTRIBUTE=keyword(=value)
This qualifier is used in combination with 3 possible
keywords : BEFORE=date, SINCE=date or NONE. The last attribute
change date is used in for selecting files. Use SINCE and BEFORE or
NONE , but not both. The NONE keyword returns files which don't
have a last attribute change date set. Examples :
o /ATTRIBUTE=BEFORE=date
o /ATTRIBUTE=(BEFORE=date,SINCE=anotherdate)
o /ATTRIBUTE=NONE
1.6 /BACKUP
/BACKUP=keyword(=value)
This qualifier is used in combination with 3 possible
keywords : BEFORE=date, SINCE=date or NONE. The backup
date is used in for selecting files. Use SINCE and BEFORE or NONE,
but not both. The NONE keyword returns files which don't have a
backup date recorded. Examples :
o /BACKUP=BEFORE=date
o /BACKUP=(BEFORE=date,SINCE=anotherdate)
o /BACKUP=NONE
1.7 /BAKFID
/BAKFID=backlink-file-id
Use this qualifier to look for a file with a specific backlink.
Only the first part of the file id must be specified, that is,
if the File id is (x,y,z) one must specifiy 'x' as the file-id.
Use this qualifier to get files from a specific directory.
If /BAKFID=0 is used, DFU returns files not belonging to a
directory (often temporary files).
1.8 /CHARACTERISTICS
/CHARACTERISTICS=(characteristic,...)
This qualifier is used to select files by their
characteristics. The possible characteristics are :
o BADACL : files marked with a bad ACL list
o BADBLOCK : files marked with Bad Blocks
o BESTTRY : files marked contiguous-best-try
o CONTIGUOUS : files which are contiguous
o DIRECTORY : files marked as a directory file
o ERASE : erase file before deletion
o LOCKED : files with the deacces lock bit set
o MARKED : files marked for deletion
o NOBACKUP : files marked as NoBackup
o NOCHARGE : files marked as NOCHARGE
o NOMOVE : files marked as NOMOVE
o SPOOL : spool files
o SCRATCH : files marked as scratch files
o NOSHELVABLE: files marked a noshelvable
o ISSHELVED : files which are shelved
DFU will use a logical AND to select files, that is
if several characteristics are specified DFU will only return
files which have all these characteristics set. To overrule
this, use the MATCH=OR keyword, eg:
SEARCH device/CHAR=(DIRECTORY,NOBACKUP,MATCH=OR)
1.9 /CREATED
/CREATED=keyword=value
This qualifier is used in combination with 2 possible
keywords : BEFORE=date or SINCE=date. The creation
date is used in for selecting files. Examples:
o /CREATED=BEFORE=date
o /CREATED=(BEFORE=date,SINCE=anotherdate)
1.10 /EXCLUDE
/EXCLUDE=filename
Use this qualifier to exclude filenames from the
selction. Eg.: /EXCLUDE=*.SYS will force DFU to not
select filenames matching *.SYS.
1.11 /EXPIRED
/EXPIRED=keyword(=value)
This qualifier is used in combination with 3 possible
keywords BEFORE=date, SINCE=date or NONE. The
expiration date is used in for selecting files.
Either use SINCE and BEFORE or NONE , but not
both. The NONE keyword returns files which don't
have a expiration date recorded. Examples :
o /EXPIRED=BEFORE=date
o /EXPIRED=(BEFORE=date,SINCE=anotherdate)
o /EXPIRED=NONE
1.12 /FID
/FID=file-id
Use this qualifier to look for a specific
file. Only the first part of the file id must be
specified, that is , if the File id is (x,y,z) one
must specifiy 'x' as the file-id. If this qualifier is used,
DFU does not scan INDEXF.SYS but just looks up the specific file
header. Therefore, this qualifier can not be combined with other
search qualifiers such as /SIZE or /FILE.
1.13 /FILE
/FILE=filename
DFU selects only file names which match the
'filename'. Wildcards may be used, eg: /FILE=*.SYS or
/FILE=LOGIN.*.
1.14 /FORMAT
/FORMAT=format_string
Used with /OUTPUT. Create an output file using
the format as described in formatstring. The format string
MUST contains the !AS directive; DFU fills in the resultant
file there. Example :
DFU> SEARCH/FILE=*.TMP/FORMAT="$delete/confirm !AS"
1.15 /FRAGMENT
/FRAGMENT [=option]
Shows the numbers of headers/fragments of the file.
Available options:
o /FRAGMENT
Don't select files, but show fragmentation info
o /FRAGMENT=MINUMUM=fragments
DFU selects files with at least 'fragments' fragments
o /FRAGMENT=MAXIMUM=fragments
DFU selects files with at most 'fragments' fragments
Both options can be combined, eg.:
/FRAGMENT=(MIN=4,MAX=10) will select all files with
between 4 and 10 fragments.
1.16 /FULL
Gives a full output for each found file. The
output contains directory, filename, File ID, Virtual
Block Number within INDEXF.SYS, filesize, owner,
creation date, revision date. Note that default is to produce
a 'short' output.
1.17 /HOME
Displays information about the home block of the disk.
DFU uses the home block to calculate the actual used
and free file headers in INDEXF.SYS.
1.18 /IDENT
/IDENT=identifier
/NOIDENT=identifier
DFU Selects files owned by this identifier. Another
way is to use the /OWNER=uic qualifier. /IDENT and /UIC can
not be used in the same DFU command. Using /NOIDENT causes
DFU to search for all files NOT owned by this identifier.
1.19 /LBN
/LBN=logical-block-number
The /LBN option is a special qualifier which allows
to find a file which contains a specific logical
block number. Note that this qualifier cannot be
combined with other search qualifiers (such as /FILE=).
1.20 /LIMIT
/LIMIT=(minimum=n,maximum=m)
Searches all directory files for a default version limit
between 'n' and 'm'.
1.21 /NAME_TYPE
/NAME_TYPE=ODS2 | ISL1 | UCS2
Searches for files with ODS2 (classic VMS), Iso-Latin1
or Unicode name type. This command is only meaningfull
for ODS5 disks.
1.22 /NOSEARCH
Do not search the volume. This qualifier can only be used
with /HOME. It is used to display only the home block info
of the device.
1.23 /NOVOLSET
The /NOVOLSET qualifier overrides default Volume set
processing by DFU. This is usefull eg. when doing a /LBN
search on a specific disk.
1.24 /MODIFIED
/MODIFIED=keyword=value
This qualifier is used in combination with 2 possible
keywords : BEFORE=date or SINCE=date. The revision
date is used in for selecting files. Examples :
o /MODIFIED=BEFORE=date
o /MODIFIED=(BEFORE=date,SINCE=anotherdate)
1.25 /MULTIPLE
This qualifier displays files which have extension
headers. This gives an indication about possible
fragmentation of the disk. Note that these headers can also
be a result of large ACL lists.
1.26 /ORGANIZATION
/ORGANIZATION=INDEXED | RELATIVE | SEQUENTIAL | DIRECT
This qualifier searches for files with the specified RMS
file organization
1.27 /OUTPUT
/OUTPUT=filename
This qualifier redirects the output from DFU about
all found files to an output file.
1.28 /OVER_ALLOCATED
/OVER_ALLOCATED=n
Select files for which the difference between blocks used
and allocated is greater than or equal to 'n' blocks.
1.29 /OWNER
/OWNER=uic
/NOOWNER=uic
Selects all files owned by the specified uic. This
qualifier cannot be used in combination with /IDENT.
The uic must be specified in a standard [grp,mem] format.
Using /NOOWNER causes DFU to search for all files
NOT owned by this uic.
1.30 /PLACED
Cheks for placed files.
1.31 /SIZE
/SIZE=option
The following options exist:
o /SIZE=MINUMUM=blocksize
DFU selects files at least blocksize blocks in size
o /SIZE=MAXIMUM=blocksize
DFU selects files at most blocksize blocks in size.
Both options can be combined, eg.:
/SIZE=(MIN=1000,MAX=10000) will select all files
between 1000 and 10000 blocks in size.
1.32 /SORT
This qualifier will sort the results of DFU to the
output file specified in /OUTPUT.
/SORT can not be used with /FULL or /SUMMARY.
1.33 /STATISTICS
/STATISTICS
/NOSTATISTICS (default)
Controls whether cpu and I/O consumption of the
command are shown.
1.34 /SUMMARY
Gives a summary of the total number of files
found, and the number of blocks occupied by these
files.
1.35 /TYPE
/TYPE=ODS2 | ODS5
Searches for files with ODS2 or ODS5 file headers.
Only usefull on ODS5 disks.
1.36 /VERSION_NUMBER
/VERSION_NUMBER=option
Use at least one of the following options:
o /VERSION_NUMBER=MINUMUM=file_version
DFU selects files whose version number in the file name
is at least 'file_version'.
o /VERSION_NUMBER=MAXIMUM=file_version
DFU selects files whose version number in the file name
is at most 'file_version'.
Both options can be combined, eg.:
/VERSION=(MIN=1000,MAX=10000) will select all files
with a version_number between 1000 and 10000 inclusive.