MPE/iX Intrinsics Reference Manual (32650-90875)

468 Chapter8
Command Definitions (HPMERGEEND-LOGSTATUS)
HPVOLINFO
38 & 39 Free space distribution sectors per range
Function = MPE/iX: DISCFREE, MPE V: FREE5
Returns the free space distribution sectors per range.
The caller passes an array that specifies a series of ranges. For each range
specified in the array, the intrinsic returns the total free space for free
areas found in that range.
Refer to Items 36 and 37 for the format of the free space distribution array
passed to the intrinsic and for the format of the returned array.
40 & 41 Total free space
Function = MPE/iX: DISCFREE , MPE V: FREE5
Returns the total free space on a volume or a group of volumes.
Item 40 returns a 64-bit signed integer containing the total free space in
sectors.
Item 41 returns a 64-bit real.
When the specifier is 1 or 4, the total free space consists of the total free
space on the volume whose LDEV or volume name was specified.
When the specifier is 2 or 3, the total free space on the volumes that make
up the volume set or class is returned.
42 & 43 Largest contiguous free space area
Function = MPE/iX: DISCFREE , MPE V: FREE5
Returns the largest contiguous free space area on a volume or a group of
volumes.
Item 42 returns a 64-bit signed integer containing the largest contiguous
free space area in sectors.
Item 43 returns a 64-bit real.
When the specifier is 1 or 4, the largest contiguous free space consists of
the largest contiguous free space on the volume whose LDEV or volume
name was specified.
When the specifier is 2 or 3, the largest contiguous free space on the
volumes that make up the volume set or class is returned.
For example, for specifiers 2 or 3, if a volume set is composed of LDEVs 2,
3, and 4, and the largest contiguous free space on these volumes are 37785,
56528, and 56171, respectively, the value returned is 56528.
Table 8-2. Variable Conventions
Convention Meaning
I16 16-bit signed integer
I32 32-bit signed integer