1 SEARCH The SEARCH option searches for specific files on a device. Syntax : SEARCH device/Qualifiers 2 Qualifiers /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 /ACE /ACE=identifier Searches for files containing an ACL list with an ACE for this identifier. /ACTION Performs an action on resultant files. Disallowed with /FULL, /PAGE, /HOME, /SUMMARY, /FORMAT, /OUTPUT, or /APPEND. Actions can be one of: o DELETE Delete each matching file. When specified an implicit reverse sort is performed such that directory file shuffle operations are minimized. o COMPRESS Compress directory files. Requires /CHARACTERISTICS=DIRECTORY such that only directory files are located/processed. /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. /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. /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 /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 /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 specify'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). /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 deaccess 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, e.g.: SEARCH device/CHAR=(DIRECTORY,NOBACKUP,MATCH=OR) /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) /DENSE When /DENSE is specified, output lines are compressed of multiple whitespace. Intended to move the file size closer to the file name and to reduce the overall output length. Not allowed with /FULL, /HOME or /SUMMARY. /DISPLAY_FIRST /DISPLAY_FIRST=n Use this qualifier to limit the number of output files displayed to the specified value. When used with an implicit or explicit sort, all names are sorted and then the first n are displayed. When there is no implicit or explicit sort, the first n files found are displayed (effectivity in FID order). /EXCLUDE /EXCLUDE=filename Use this qualifier to exclude filenames from the selection. E.g.: /EXCLUDE=*.SYS will force DFU to not select filenames matching *.SYS. /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 /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 specify'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. /FILE /FILE=filename DFU selects only file names which match the 'filename'. Wildcards may be used, e.g.: /FILE=*.SYS or /FILE=LOGIN.*. /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" /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, e.g.: /FRAGMENT=(MIN=4,MAX=10) will select all files with between 4 and 10 fragments. When /SORT is used with /FRAGMENT, output is sorted by file allocation size or fragment count largest to smallest. /SORT with /FRAGMENT accepts either ALLOCATION or FRAGMENTS as a keyword (/SORT=ALLOCATION or /SORT=FRAGMENTS) to adjust the sort field. /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. /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. /GLOBAL_BUFFER_COUNT The following options exist: o /GLOBAL_BUFFER_COUNT=MINUMUM=buffercount DFU selects files with at least buffercount global buffers o /GLOBAL_BUFFER_COUNT=MAXIMUM=blocksize DFU selects files with at most buffercount global buffers. Both options can be combined, e.g. /GLOBAL_BUFFER_COUNT= (MIN=1000,MAX=10000) will select all files between 1000 and 10000 global buffers set in the file attributes. /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. /LBN /LBN=logical-block-number The /LBN option is a special qualifier which allows locating a file which contains a specific logical block number. Note that this qualifier cannot be combined with other search qualifiers (such as /FILE=). /LIMIT /LIMIT=(minimum=n,maximum=m) Searches all directory files for a default version limit between 'n' and 'm'. /NAME_TYPE /NAME_TYPE=ODS2 or ISL1 or UCS2 Searches for files with ODS2 (classic VMS), Iso-Latin1 or Unicode name type. This command is only meaningful for ODS5 disks. /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. /NOVOLSET The /NOVOLSET qualifier overrides default Volume set processing by DFU. This is useful e.g. when doing a /LBN search on a specific disk. /MODIFIED /MODIFIED=keyword=value This qualifier is used in combination with 2 possible keywords : BEFORE=date or SINCE=date. The revision date is used for selecting files. Examples : o /MODIFIED=BEFORE=date o /MODIFIED=(BEFORE=date,SINCE=anotherdate) /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. /ORGANIZATION /ORGANIZATION=INDEXED or RELATIVE or SEQUENTIAL or DIRECT This qualifier searches for files with the specified RMS file organization /OUTPUT /OUTPUT=filename This qualifier redirects the output from DFU about all found files to an output file. /OVER_ALLOCATED /OVER_ALLOCATED=n Select files for which the difference between blocks used and allocated is greater than or equal to 'n' blocks. /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. /PLACED Checks for placed files. /RETURN_LIMIT /RETURN_LIMIT=n restricts the number of file names returned to the user. /NORVNFID /[NO]RVNFID=rvn Use this qualifier to look for files with or without a specific RVN FID. If the File id is (x,y,z) one must specify'z' as the RVN. Use this qualifier to get files from a specific volume. /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, e.g.: /SIZE=(MIN=1000,MAX=10000) will select all files between 1000 and 10000 blocks in size. /SORT /SORT=ALLOCATION or /SORT=FRAGMENTS when used with /FRAGMENT This qualifier will sort the results of DFU to the output file specified in /OUTPUT. By default, file names are sorted. When /SORT is used with /FRAGMENT, output is sorted by file allocation size or fragment count largest to smallest (). /SORT can not be used with /FULL or /SUMMARY. /SPECIFICATION_MATCH /SPECIFICATION_MATCH=filename The specified filename matching pattern string (allowing wildcards) is matched against each resultant file specification returned from the search. This can be utilized to further filter a returned specification. Leading and trailing * may be required to match the returned device and file name components. For example: /SPECIFICATION_MATCH=*[SMITH.*.LOGS]* /STATISTICS /STATISTICS /NOSTATISTICS (default) Controls whether CPU and I/O consumption of the command are shown. /SUMMARY Gives a summary of the total number of files found, and the number of blocks occupied by these files. /TYPE /TYPE=ODS2 or ODS5 Searches for files with ODS2 or ODS5 file headers. Only useful on ODS5 disks. /UNIT /UNIT=BYTES | BLOCKS /UNIT=BLOCKS (default) Report sizes in units of bytes. The default behavior is to report sizes as block units. /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, e.g.: /VERSION=(MIN=1000,MAX=10000) will select all files with a version_number between 1000 and 10000 inclusive.