MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 8 467
Command Definitions (HPMERGEEND-LOGSTATUS)
HPVOLINFO
34 & 35 Reserved for disk space used by temporary files.
36 & 37 Free space distribution array
Function = MPE/iX: DISCFREE MPE V: FREE5
Returns the free space distribution array. The caller passes an array that
specifies a series of ranges. The intrinsic returns the number of free areas
whose size is within each of the specified ranges. The array must consist of
64-bit values.
The item passed must be a variable length array of 64-bit numbers
(maximum array length of 16 elements).
For item 36, the values must be in integer format. It returns an array of
64-bit integers containing the free space distribution.
For item 37, the values must be in real format. Real values is rounded off.
It returns an array of 64-bit reals.
On MPE V, the largest value that may be specified in either format is
2,147,483,646.
The first value is the number of ranges (minimum 2, maximum 16). The
remaining values are the lower bounds for the ranges, in ascending order.
On return the first element is the number of free areas whose size is
smaller than the smallest bound specified. Each remaining element is the
number of free space areas whose size is greater than or equal to the
bound, and less than the next larger bound. The following example shows
a return in six ranges:
Array Values Free Area Size Ranges
Index Passed In
1 6 1 - 9 contiguous sectors
2 10 10 - 99 contiguous sectors
3 100 100 - 999 contiguous sectors
4 1000 1000 - 9999 contiguous sectors
5 10000 10,000 - 99,999 contiguous sectors
6 100000 100,000+ contiguous sectors
For example, if there are four areas of free space that are between the size
of 100 and 999, the third value of the free space distribution array would
contain 4 on return.
Notice that the number of ranges specified in the first element of the array
example is 6, but only 5 lower bounds are specified, because the smallest
lower bound is assumed to be 1 (one).
When the specifier is 1 or 4, the free space distribution array consists of
the contiguous free space areas on the volume whose LDEV or volume
name was specified.
When the specifier is 2 or 3, the free space distribution array returns the
total values from the volumes that make up the volume set or class.