HP 3000 Manuals HP 3000 Manuals
VOLUTIL Enhancement
by Ching-Ching Su
Commercial Systems Division
PRODUCT OVERVIEW
A new command, SHOWUSAGE, in the VOLUTIL utility has been included in the
this version of MPE/iX. SHOWUSAGE is used to display the disk space usage
of a specified volume. The main purpose of this command is to locate
needed contiguous disk space for a successful system update. Thus,
SHOWUSAGE is intended to be used when preparing for a system update. The
features provided by SHOWUSAGE are:
* Permanent space usage
SHOWUSAGE shows you:
- files that reside on a specified volume
- files that must reside on a specified volume
- files that have extents on a specified volume but these
files do not have to stay on the volume
- the location and the size of extents on a specified
volume.
Permanent space for this command only refers to files. For the
other VOLUTIL commands, permanent space refers to permanent
structures such as files, label tables, and the free space map.
* Free and transient space usage
SHOWUSAGE displays the location and the size of these spaces on a
specified volume.
* Contiguous disk space usage
A contiguous block may consist of either all permanent, free, or
transient space, or any combination of these types of disk space
depending upon the user specifications. Given the number of
contiguous sectors, SHOWUSAGE produces a list of contiguous blocks
that match the user specifications.
Each resulting contiguous block represents enough space that if
all space in the block becomes free, you will be able to build a
file with one extent which is as big as the requested size. The
ability to free up space and to build the file is dependent upon
not having a lot of system activity during the time the command is
executed, the files are removed, and the new file is built.
USER INTERFACE
The parameters supported by the VOLUTIL SHOWUSAGE command are described
as follows:
Syntax
SHOWUSAGE [VOL=]{[sname:]vname} [[CONTIG=]contiguous_sectors]
{ldev }
[ {ALL }] [ {DETAIL }]
[[FILE=]{RESTRICT }] [[FORMAT=]{ }]
[ {NONRESTRICT}] [ {SUMMARY}]
[;PERM][;FREE][;TRANS][;MAX][;PATH]
Parameters
sname Is the name of the volume set containing the volume for which
information is desired. This is an optional parameter. If it
is omitted then the current default volume set is assumed.
Optional.
vname Is the name of the volume for which information is requested.
The volume must be mounted and online - it must be mounted in
the MASTER or MEMBER state as displayed by the MPE/iX :DSTAT
command. Required.
ldev Is an integer value used to specify the logical device on which
the volume to be examined is mounted. Required.
contiguous_sectors Is an integer value used to specify the number of contiguous
sectors. It requests that contiguous blocks whose total sectors
is approximately equal to the requested sectors be displayed.
Optional.
ALL, RESTRICT, or Is used as a filter on files. The keyword FILE applies to
NONRESTRICT permanent space only. RESTRICT requests that only files that
are restricted to this volume be displayed. NONRESTRICT
requests that only files that are not restricted to this volume
be displayed. ALL will show both restricted and nonrestricted
files on the volume. The default is ALL. Optional.
A file may be required to reside on a particular volume. This
restriction is imposed on a file during file creation time.
Refer to FOPEN (device parameter) and HPFOPEN (item 20, 22, 23,
and 42) in the MPE/iX Reference Supplement (32650-90353) for
more information about restricting a file to a volume.
DETAIL or SUMMARY Specifies the output format. DETAIL displays the sector
address, size, and what occupies the location. SUMMARY only
displays filenames which are associated with the permanent
space. Free and transient space will not be shown in this
format. The default is DETAIL. Optional.
PERM, FREE, or TRANS The PERM, FREE, and TRANS options display information about the
volume's current permanent, free, and transient space usage.
PERM, FREE, and TRANS space usage will be displayed by default.
MAX The MAX option is used to control the algorithm that searches
for the contiguous space. When used, a contiguous block, whose
total sectors has met the requested size, will not be displayed
until this block reaches its maximum size.
PATH The PATH option displays all filenames in Hierarchical File
System (HFS) syntax.
EXAMPLES
The following examples show how to use SHOWUSAGE and how the results
differ when using this command with different parameters. They also
demonstrate the messages displayed under certain situations.
1. Disk space is low on ldev 1. In order to free up space on the
device, the system manager wants to know what files are on this device or
what files consume the most space on this device. Enter:
_________________________________________________________
| |
| volutil: SHOWUSAGE VOL=1 FORMAT=SUMMARY ;PERM |
| |
| PERM space on LDEV 1: |
| |
| FILE1.GROUP5.ACCT5 |
| FILE2.GROUP1.ACCT1 |
| FILE1.GROUP1.ACCT1 |
| /dir1/subdir1/subdir2/file1 |
| FILE1.GROUP2.ACCT1 |
| FILE2.GROUP2.ACCT1 |
| /ACCT3/GROUP2/d1/f1 |
| FILE3.GROUP2.ACCT4 |
| |
| . |
| . |
| . |
| |
| |
| volutil: SHOWUSAGE VOL=1 ;PERM |
| |
| PERM space on LDEV 1: |
| |
| SECTOR ADDRESS SIZE SPACE USED BY |
| (in sectors) |
| -------------- ------------ ------------- |
| |
| $00079DD0 672 FILE1.GROUP5.ACCT5|
| $000DDD00 16 FILE2.GROUP1.ACCT1|
| $000DDD10 16 FILE2.GROUP1.ACCT1|
| $000E2E40 208 FILE1.GROUP1.ACCT1|
| $000E3F60 1200 FILE2.GROUP1.ACCT1|
| $000E4160 464 FILE1.GROUP5.ACCT5|
| |
| . |
| . |
| . |
_________________________________________________________
If you are interested in all files displayed in the HFS syntax, specify
;PATH in the command line.
__________________________________________________________
| |
| volutil: SHOWUSAGE VOL=1 FORMAT=SUMMARY ;PERM ;PATH|
| |
| PERM space on LDEV 1: |
| |
| /ACCT5/GROUP5/FILE1 |
| /ACCT1/GROUP1/FILE2 |
| /ACCT1/GROUP1/FILE1 |
| /dir1/subdir1/subdir2/file1 |
| /ACCT1/GROUP2/FILE1 |
| /ACCT1/GROUP2/FILE2 |
| /ACCT3/GROUP2/d1/f1 |
| /ACCT4/GROUP2/FILE3 |
| . |
| . |
| . |
__________________________________________________________
2. A system is running out of disk space on ldev 1. UPDATE warns the
operator that UPDATE is not able to build a file with 60000 contiguous
sectors. The operator brings the system up and looks for files which can
be removed from the device to free up 60000 contiguous sectors for a
successful update. Enter:
_________________________________________________________________
| |
| volutil: SHOWUSAGE 1 60000 NONRESTRICT SUMMARY ;PERM ;FREE|
| |
| *Note: Only PERM space is displayed in SUMMARY format. |
| |
| CONTIG PERM, FREE space on LDEV 1: |
| |
| FILE1.GROUP2.ACCT1 |
| FILE1.GROUP1.ACCT1 |
| FILE2.GROUP2.ACCT1 |
| FILE3.GROUP2.ACCT4 |
| |
| Total sectors: 62176 |
| |
| FILE1.GROUP3.ACCT1 |
| /ACCT1/GROUP2/dir1/f2 |
| FILE1.GROUP1.ACCT1 |
| FILE5.GROUP5.ACCT5 |
| |
| Total sectors: 80416 |
| |
| . |
| . |
| . |
| |
| volutil: SHOWUSAGE 1 60000 NONRESTRICT ;PERM ;FREE |
| |
| CONTIG PERM, FREE space on LDEV 1: |
| |
| SECTOR ADDRESS SIZE SPACE USED BY |
| (in sectors) |
| -------------- ------------ ------------- |
| |
| $00111820 2112 FILE1.GROUP2.ACCT1 |
| $00112060 3680 FILE1.GROUP1.ACCT1 |
| $00112EC0 16816 FILE2.GROUP2.ACCT1 |
| $00117070 864 <free space> |
| $001173D0 1200 FILE2.GROUP2.ACCT1 |
| $00117880 1824 FILE2.GROUP2.ACCT1 |
| $00117FA0 2048 FILE2.GROUP2.ACCT1 |
| $001187A0 480 <free space> |
| $00118980 4384 FILE1.GROUP1.ACCT1 |
| $00119AA0 4688 FILE2.GROUP2.ACCT1 |
| $0011ACF0 5648 <free space> |
| $0011C300 5344 FILE3.GROUP2.ACCT4 |
| $0011D7E0 13088 FILE3.GROUP2.ACCT4 |
| |
| Total sectors: 62176 |
| . |
| . |
| . |
_________________________________________________________________
The first result allows you to quickly identify files that can be moved
off this device and helps you determine a list with the minimum number of
files that you need to move. The second result shows you the total
sectors provided by the previous result containing the number of sectors
used by free space, even though free space is not displayed in the
previous result.
3. This example shows how the results are different with and without
specifying ;MAX in a command line.
______________________________________________________________________
| |
| volutil: SHOWUSAGE BSET:MEMBER2 10000 FORMAT=SUMMARY ;PERM |
| |
| CONTIG PERM space on BSET:MEMBER2: |
| |
| FILEX.GROUP3.ACCTX |
| FILE1.GROUP1.ACCTX |
| /ACCTA/GROUPA/tmp/junk |
| FILE3.GROUP1.ACCTY |
| |
| Total sectors: 12032 |
| |
| FILEX.GROUPN.ACCTM |
| . |
| . |
| . |
| |
| |
| volutil: SHOWUSAGE BSET:MEMBER2 10000 FORMAT=SUMMARY ;PERM ;MAX|
| |
| CONTIG PERM space on BSET:MEMBER2: |
| |
| FILEX.GROUP3.ACCTX |
| FILE1.GROUP1.ACCTX |
| /ACCTA/GROUPA/tmp/junk |
| FILE3.GROUP1.ACCTY |
| FILEX.GROUPM.ACCTB |
| |
| Total sectors: 20264 |
| |
| FILEX.GROUPN.ACCTM |
| . |
| . |
| . |
______________________________________________________________________
4. This example shows the messages that will be displayed if FREE and/or
TRANS are specified and SUMMARY is the output format.
___________________________________________________________________________________
| |
| volutil: SHOWUSAGE BSET:MEMBER1 FORMAT=SUMMARY |
| |
| *Note: Only PERM space is displayed in SUMMARY format. |
| |
| PERM space on BSET:MEMBER1: |
| |
| FILE1800.GROUP2.ACCT18 |
| . |
| . |
| . |
| |
| |
| volutil: SHOWUSAGE BSET:MEMBER1 FORMAT=SUMMARY ;FREE |
| |
| *Error: The requested space cannot be displayed in this format. (volutil 27)|
___________________________________________________________________________________