HP 3000 Manuals HP 3000 Manuals
VOLUTIL Enhancement
by Ching-Ching Su
Commercial Systems Division
Product Overview
The VOLUTIL utility now includes a new command, SHOWUSAGE. SHOWUSAGE is
used to display the disk space usage of a specified volume. The main
purpose of this command is to locate contiguous disk space needed for a
successful system update. SHOWUSAGE is intended to be used when
preparing for a system update.
SHOWUSAGE provides the following features:
* Permanent space usage. SHOWUSAGE displays:
* Files that reside on a specified volume.
* Files that must reside on a specified volume.
* Files that have extents on a specified volume but 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 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 can build a file with one
extent that is as big as the requested size. Freeing up space and
building the file are dependent upon minimal system activity
during the time the command is executed, the files are removed,
and the new file is built.
User Interface
The following information describes the parameters supported by the
VOLUTIL SHOWUSAGE command:
Syntax
SHOWUSAGE [VOL=]{[sname:]vname} [[CONTIG=]contiguous_sectors]
{LDEV }
[ {ALL }]
[[FILE=]{RESTRICT }] [[FORMAT=]{DETAIL }]
[ {NONRESTRICT}] [ {SUMMARY}]
[;PERM][;FREE][;TRANS][;MAX][;PATH]
Parameters
sname Is the name of the volume set containing the volume
for which information is requested. 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 where the volume to be examined is mounted.
Required.
contiguous_sectors Is an integer value used to specify the number of
contiguous sectors. It displays the contiguous
blocks whose total sectors are approximately equal to
the requested sectors. Optional.
ALL, RESTRICT, or Is used as a file filter. The keyword FILE only
NONRESTRICT' applies to permanent space. RESTRICT only displays
the files restricted to this volume. NONRESTRICT
only displays the files not restricted to this
volume. ALL displays 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 Intrinsics Reference Manual (32650-90028)
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 that are associated
with the permanent space. Free and transient space
is not shown in this format. The default is DETAIL.
Optional.
PERM, FREE, or The PERM, FREE, and TRANS options display information
TRANS about the volume's current permanent, free, and
transient space usage. PERM, FREE, and TRANS space
usage is 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 meet the
requested size, is not 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 LDEV1: |
| |
| 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 LDEV1: |
| |
| 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 LDEV1: |
| |
| /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 that 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 LDEV1: |
| |
| 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 LDEV1: |
| |
| |
| 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 is displayed if either FREE,
TRANS or both 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)|
___________________________________________________________________________________