 |
» |
|
|
|
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
ldev}]
[ [CONTIG=]contiguous_sectors]
[ [FILE=]{ALL
RESTRICT
NONRESTRICT} ]
[ [FORMAT=] { DETAIL
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 NONRESTRICT
Used as a filter of files. The keyword FILE 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. - 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.
|