DFU V2.7-A

Previous | Contents

DELETE

Deletes files or directories.

Format

DELETE device[:] or directory-file(s)

PARAMETERS

device

The device on which to perform the DELETE/FILE=file-id command.

directory-file(s)

The filespecification of the directory on which to perform the DELETE/DIRECTORY command. Wildcard file specifications may be used. DFU will automatically add .DIR to the filespecification if a filetype is not provided.

QUALIFIERS

/DIRECTORY

Specify the directory file which must be deleted. Wildcards may be used but must be used very carefully. Make sure that the directory does not contain non-empty subdirectories. Note that the directory file itself will also be deleted, unless the /KEEP qualifier is used.

Example: 

$ DIR EXAMPLE 
 
Directory MYDISK:[RUBBISH] 
 
EXAMPLE.DIR;1 
 
$ DFU 
DFU> DELETE/DIRECTORY EXAMPLE.DIR 
 
%DFU-I-CLEANUP, Deleting MYDISK:[RUBBISH]EXAMPLE.DIR;1... 
%DFU-S-DELETED, File DBGINI.COM;3 deleted 
%DFU-S-DELETED, File ICON.COM;1 deleted 
%DFU-S-DELETED, File I_FOOL.COM;1 deleted 
%DFU-S-DELETED, File LOGICALS.COM;51 deleted 
%DFU-S-DELETED, File LOGIN.COM;79 deleted 
%DFU-S-DELETED, File LOGOUT.COM;4 deleted 
%DFU-S-DELETED, File NOTE_COMPRESS.COM;3 deleted 
%DFU-S-DELETED, File SHOWCL.COM;3 deleted 
%DFU-S-DELETED, File SYMBOLS.COM;89 deleted 
%DFU-S-DELETED, File TPUBUILD.COM;5 deleted 
%DFU-S-TOTAL, 11 file(s) deleted 
%DFU-S-DELETED, File EXAMPLE.DIR;1 deleted

/FILE=file-id

Specify a complete file-id (num,seq,rvn) of the file which must be deleted. This qualifier allows the deletion of lost files or files marked for delete. Example : 
$ DFU 
DFU> VERIFY MYDISK: 
 
%DFU-S-CHKHOME, Home block info verified OK 
%DFU-I-IFSCAN, Scanning INDEXF.SYS... 
%DFU-E-INVBAKFID, file (86,17915,1) 0004CF04$BFS.;1 has invalid backlink 
%DFU-W-DELETED, file (537,2878,1) APPL_UTRYIT_BOOK.TMP;1 marked for delete 
 . 
 . 
 . 
 
DFU> DELETE MYDISK/FILE=(86,17915,1) 
%DFU-S-DELETED, File 0004CF04$BFS.;1 deleted 
 
DFU> DELETE MYDISK/FILE=(537,2878,1) 
%DFU-S-DELETED, File APPL_UTRYIT_BOOK.TMP;1 deleted

/KEEP

Preserve the directory tree; only delete the contents. /KEEP is only valid with the /DIRECTORY qualifier. /KEEP works for DELETE/DIR and DELETE/DIR/TREE.

/NOLOG

Do not log succesfull deletes to SYS$OUTPUT. /LOG is the default.

/NOREMOVE

Can only be used with /FILE. Default DELETE/FILE will try to remove the file from the parent directory. If the file's backlink no longer points to a valid directory this will generate an error. The /NOREMOVE qualifier overrules this behaviour allowing such files to be deleted.

/STATISTICS

This qualifier displays the performance statistics: CPU time, Elapsed Time, I/O and PageFaults.

/TREE

Can only be used with /DIRECTORY. The delete command will delete all subdirectories within the directory file specified. DFU will first sort out the subdirectory tree and than delete the files in the proper order. Thus a complete directory tree is deleted with one command.

Chapter 8
DIRECTORY

This chapter describes the DIRECTORY command with the related parameters and qualifiers.

8.1 Introduction

The DIRECTORY command offers 8 major functions. 3 functions deal with all directories on a disk, the other 5 functions are used for manipulating individual directories. These functions are activated by special qualifiers:

When using /GRAPH the disk's free space distribution is shown as a bitmap image. Each position in the graph represents a certain number of blocks (in the example above 3472 blocks). This bitmap image gives a quick impression about the free space distribution on the disk.

If you use the /USAGE qualifier a sorted usage table will be added. Per Identifier / UIC the blocks used/allocated, and the number of file headers are shown. If Diskquota is enabled a third column will be included which shows the blocks used/permitted allowing to QUOTA.SYS. Normally quota should satisfy the following rule : 

 Quota used = blocks allocated + # of file headers

REPORT

Create a file and free space report of a disk device.

Format

REPORT device[:]

PARAMETERS

device[:]

Device to be reported. You may also specify a logical devicename.

QUALIFIERS

/APPEND=filename

This qualifier redirects the output to be appended to an already existing file. If the output file does not exists it will be created. You can use /APPEND or /OUTPUT but not both.

/GRAPH

This qualifier generates a graph table which visualizes the free space distribution on the disk. /NOGRAPH is the default.

/NOBITMAP

The /NOBITMAP qualifier suppresses the "Free space statistics" output.

/NOFILE

The /NOFILE qualifier suppressed the "File Statistics" output.

/NOVOLUME

The /NOVOLUME qualifier suppresses the "Volume info" output.

/OUTPUT=filename

This qualifier redirects the output to a file. The output will also go to SYS$OUTPUT.

/STATISTICS

This qualifier displays the performance statistics: CPU time, Elapsed Time, I/O and PageFaults.

/USAGE(=uic or identifier)

The /USAGE qualifier will generate a diskspace usage report based on Identifiers/UIC. If diskquota is enabled on the disk the blocks used/permitted allowing to QUOTA.SYS will also be shown. /USAGE is very useful when diskquota is not enabled on the disk. When a UIC or identifier is specified only the information for this UIC or identifier will be displayed.

Chapter 10
SEARCH

This chapter describes the SEARCH command with the related parameters and qualifiers.

10.1 Introduction

The search function allows very quick disk-wide searches for specific files. You can use almost any possible file attribute as a search qualifier.

10.2 Syntax and Output

The command syntax for SEARCH is: 

DFU> SEARCH device/qualifiers

The output is displayed on your terminal. You can also sort the output with the /SORT qualifier. The output is shown in 2 or 3 columns eg: 

DFU> SEARCH MYDISK/FILE=X.X/FRAGMENT 
 . 
 . 
$1$DUA102:[USER.COMMAND]X.X;1             1/3               1/1 
 . 
 .

The first column shows the full file name . The device name is included in the file name. The second columns shows the file size as actual/allocated size. The 3rd column is optional and will only be shown when the /FRAGMENT qualifier is used. It shows the number of fileheaders / number of file fragments.

10.3 Volume Set processing

SEARCH checks if the device to-be-searched is member of a volume set. If so, the complete volume set will be processed, starting with Relative Volume Number 1 up to the last member in set. You can override this behaviour with the /NOVOLSET qualifier.

10.4 Output formatting

The qualifier /FORMAT can be used with SEARCH. This allows the build up of a command procedure directly from the output generated by the SEARCH command. /FORMAT has the following restrictions :

  1. /FORMAT is only valid with the /OUTPUT qualifier, and can not be used together with the /FULL or the /SORT qualifiers.
  2. The format string used must contain the !AS directive (in uppercase). The file found will be substituted at the !AS location

Example: 

DFU> SEARCH/OUTP=DEL.COM/FORMAT="$DELETE/CONF !AS"/FILE=*.LOG mydisk

10.5 UIC and identifier processing

Version V2.4 introduced an improved handling of UIC's. Previous versions of DFU only accepted a numeric UIC in the /OWNER qaulifier or an identifier in the /IDENT qualifier. V2.4 and later now accepts all valid UIC and identifier formats (numeric and alphanumeric) in the /OWNER and /IDENT qualifiers. Technically there is no longer any difference between these two qualifiers, but they will be left in for compatibility reasons.

SEARCH

Fast file search through INDEXF.SYS.

Format

SEARCH device[:]

PARAMETERS

device[:]

Device to be searched. You may also specify a logical devicename.

DESCRIPTION

The SEARCH command is used for quick disk-wide searches for specific files. The qualifiers describe the file attributes used as the search criteria. You can combine almost all of the possible qualifiers, unless otherwise specified. Eg.: 
DFU> SEARCH DISK1/SIZE=MIN=10/OWN=[1,4]/CREATED=SINCE=YESTERDAY

is a valid command. Note that qualifiers will be used in a logical AND manner, that is, SEARCH will only display files which match all qualifiers and options specified.

QUALIFIERS

/ACCESS=option(,option)

The /ACCESS qualifier is used to search files depending on their last ACCESS date (VMS 7.2 only). The possible options are :

/ACE=identifier

Search for files which have an ACE containing the specific identifier. Only ACE's of the format "IDENTIFIER=<identifier>,..." will be searched.

/ALLOCATED

Default, SEARCH will use the actual file size. The /ALLOCATED qualifier forces SEARCH to use the allocated filesize. This qualifier is only meaningfull if you combine it with /SIZE.

/APPEND=filename

This qualifier redirects the output to be appended to an already existing file. If the output file does not exists it will be created. You can use /APPEND or /OUTPUT but not both.

/ATTRIBUTE=option(,option)

The /ATTRIBUTE qualifier is used to search files depending on their last attribute change date (VMS 7.2 only). The possible options are :

/BACKUP=option(,option)

The /BACKUP qualifier is used to search files depending on their backup date. The possible options are :

The NONE option gives files which don't have a backup date recorded.The other 2 options can be used to get files which have a backup date before or after a specific date. The BEFORE and SINCE option can be combined in one command.

/BAKFID=backlink-file-id

You can 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) you must specify 'x' as the file id. You can use this qualifier to get files from a specific directory. If you use /BAKFID=0 you will get files not belonging to a directory (often temporary files).

/CHARACTERISTIC=(char1,char2...)

This qualifier is used to get files with specific file characteristics.The characteristics can have the following values:

Previous | Next | Contents