This chapter shows you how to use VDM to generate directory reports. Directory reports show how blocks are allocated by directory and how directories have increased or decreased in size.
The directory report analyzes directories. It does not show the size of individual files in a directory. Use other VDM reports to obtain information about individual files.
Directory Structure
VDM uses the current directory structure as the standard. If the previous directory included sub-directories which have subsequently been deleted, the blocks in those directories are not included in the previous totals.
Directory sizes
The number of blocks shown for each directory is the number of blocks allocated to the files in that directory plus the number of blocks that contain file headers used by the files in that directory. If your disks are relatively contiguous, the number of file headers will be equal to the number of files in that directory.
Summary data
The blocks in each directory are reported (for example "[ENG]") as well as the TOTAL blocks in the directory and all sub_directories (for example "[ENG...]"). Level 1 "directory" reports show only the total blocks for each directory (for example "[ENG...]" unless no sub directories exist in the level 1 directory.
Levels
Normally, the directory report displays only the top level directories (ie those immediately below [000000]) and 1 level of subdirectories (/LEVEL=2). However, the directory report can also display an additional level of sub-directories. You specify the number of levels of directory to show using the /LEVEL qualifier. If you specify /LEVEL=4 or higher, VDM assumes /LEVEL=3.
Levels and directories
The following pages show examples of how the /LEVEL qualifier can be used to summarize directories using a sample directory structure of:
000000
ENG
ENG.MOE
ENG.MOE.SRC
ENG.MOE.EXE
ENG.CURLY
ENG.CURLY.SRC
ENG.CURLY.EXE
PROD
PROD.EXE
PROD.COM
PROD.DOC
If /LEVEL=1 is entered, the report will contain the lines:
000000
ENG
PROD
If no level qualifier is entered, /LEVEL=2 is assumed and the report will contain the lines:
000000
ENG
ENG.MOE (total for this directory and all sub_directories)
ENG.CURLY
PROD
PROD.EXE
PROD.COM
PROD.DOC
And finally, if /LEVEL=3 is entered, the report will contain the lines:
000000
ENG
ENG.MOE
ENG.MOE.SRC
ENG.MOE.EXE
ENG.CURLY
ENG.CURLY.SRC
ENG.CURLY.EXE
PROD
PROD.EXE
PROD.COM
PROD.DOC
Examples
$ VDM /REPORT=CURRENT /SEQUENCE=DIRECTORY /PREVIOUS=01_NOV_96
Produce a current report by directory for all disk drives showing current usage and usage as of November 1st, 1993. Since the number of levels is not specified, VDM assumes /LEVEL=2.
$ VDM /REPORT=CAPACITY /SEQUENCE=DIRECTORY /LEVEL=3
Produce a capacity report by directory for all disk drives showing current usage and previous usage using the oldest data from no more than 3 months ago (the default). Since three levels of directory have been specified, a total for each top level directory will be presented along with a total for all sub_directories down two levels. If the directory structure is deeper than three, the lower level will be summarized. If the directory structure has only one level, it will be presented.