HP 3000 Manuals HP 3000 Manuals
SHOWUSAGE
The SHOWUSAGE command displays disk space usage of a volume.
Task
Displays usage of a volume.
Capability
No special capability is required to execute this command.
Syntax
SHOWUSAGE [VOL=] [[sname:]{vname}] [[CONTIG=]contiguous_sectors]
[ {ldev }]
[ {ALL }]
[[FILE=]{RESTRICT }] [[FORMAT=] {DETAIL }]
[ {NONRESTRICT}] [ {SUMMARY}]
[;PERM][;FREE][;TRANS][;MAX][;PATH]
Parameters
sname The name of the volume set containing the volume
for which information is desired. This is an
optional parameter. If it is omitted, the current
default volume set is assumed. Optional.
vname The name of the volume for which information is
requested. The volume must be mounted and online.
Volume must be mounted in the "MASTER" or "MEMBER"
state, as displayed by the MPE/iX DSTAT command.
Required if ldev is omitted. Optional.
ldev An integer value used to specify the logical device
on which the volume to be examined is mounted.
Required if vname is omitted. Optional.
contiguous_sectors An integer value used to specify the number of
contiguous sectors requested. It requests that the
contiguous blocks whose total sectors are
approximately equal to the requested sectors to be
displayed. Optional.
ALL, RESTRICT, or Used as a filter of files. The keyword FILE
NONRESTRICT applies to 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 shows both restricted and
nonrestricted files on the volume. The default is
ALL. Optional.
__________________________________________________
NOTE A file may be required to reside on a
particular volume. This restriction is
imposed upon file creation. Refer to the
FOPEN and HPFOPEN intrinsics for more
information.
__________________________________________________
DETAIL or SUMMARY Specifies the output format. DETAIL displays the
sector address, size, and what occupies the
location. SUMMARY only displays file names which
are associated with the permanent space. Free and
transient space are not shown in this format. The
default is DETAIL. Optional.
PERM, FREE, or TRANS The PERM, FREE, and TRANS option displays
information about the volume's current permanent,
free, and transient space. PERM, FREE, and TRANS
space usage are 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 file names in
Hierarchical File System (HFS) syntax.