Operation [ MPE/iX System Utilities Reference Manual ] MPE/iX 5.0 Documentation
MPE/iX System Utilities Reference Manual
Operation
To invoke DISCFREE enter:
DISCFREE
or
RUN DISCFREE.PUB.SYS;INFO="[format][,ldev]"
or
DISCFREE "[format][,ldev]"
where
format is the specified display type. The format default is A.
ldev Specifies a particular system volume. The ldev default is no
ldev, causing all volumes to be displayed.
If you do not specify either of the parameters, DISCFREE prompts for
them. If you enter format but not ldev, DISCFREE reports on all logical
disk devices. To report on a particular volume, enter the name of the
volume set. For example, to display information about the volume
USER_VOL_SET, you would enter:
RUN DISCFREE.PUB.SYS;INFO=",,USER_VOL_SET"
The format values you can specify are:
A A histogram showing numbers of blocks by size categories.
B Shows transient and free space allocations in sectors.
C Shows transient and free space allocations in percentage of total
device capacity.
D Shows disk allocation summary in sectors.
E Shows disk allocation summary in percentage of total space.
Displaying the histogram
To display a histogram for ldev 1 only enter:
DISCFREE "A,1"
To display the histogram for all disk devices enter:
DISCFREE "A"
Or, you may enter the DISCFREE command (without any options) and, at the
prompt, enter only the format and ldev or only the format. For example:
Enter [<format>][,<ldev>] : "A,1"
Enter [<format>][,<ldev>] : "A"
Displaying the allocation summary
To display the allocation summary as a percent of total space on all
logical disk devices, enter:
DISCFREE "C"
If you omit quotation marks, the default is the specified format for all
devices.
DISCFREE displays the following information:
DEVICE SIZE The capacity, in sectors, of the device.
TRANS SPACE The number of sectors currently allocated for transient space.
Transient space is used for objects which are not permanent files,
such as stacks, heaps and system tables.
MAX TRANS SPACE An upper limit on the number of sectors that may be allocated for
transient space. TRANS SPACE should not exceed this number
although it may if the percentage of MAX TRANS SPACE space is
lowered using VOLUTIL.
FREE SPACE The amount of space on a device currently not used for transient
or permanent space. Space available for use.
AVAIL TO TRANS The amount of space on the device currently available for use as
SPACE transient space. The difference between MAX TRANS SPACE and TRANS
SPACE. If this difference exceeds the amount of FREE SPACE,
DISCFREE displays the amount of FREE SPACE.
PERM SPACE The number of sectors currently allocated for permanent space.
User and system files use permanent space.
MAX PERM SPACE An upper limit on the number of sectors that may be allocated for
permanent space. PERM SPACE should not exceed this number
although it may if the percentage of MAX PERM SPACE space is
lowered using VOLUTIL, or if enough space is consumed by files
brought in during an UPDATE.
AVAIL TO PERM SPACE The amount of space on the device currently available for use as
permanent space. The difference between MAX PERM SPACE and PERM
SPACE.
AVAIL TO TRANS SPACE and AVAIL TO PERM SPACE may be negative values. For
example, if TRANS SPACE exceeded MAX TRANS SPACE, AVAIL TO TRANS SPACE
would be negative. This could occur if VOLUTIL were used to change the
maximum percentage of MAX TRANS SPACE to a level lower than currently
used for TRANS SPACE. Also, if enough permanent space is used by files
brought in during an UPDATE, PERM SPACE may exceed MAX PERM SPACE, which
would make AVAIL TO PERM SPACE a negative number.
Additional Discussion
For more information on the general topic of disk volumes refer to Volume
Management Reference Manual (32650-90045). For more information on the
DSTAT command refer to MPE/iX Commands Reference Manual Volumes 1 and 2
(32650-90003 and 32650-90364).
MPE/iX 5.0 Documentation