Guardian Procedure Calls Reference Manual

numfrag
output
INT(32) .EXT:ref:1
is the number of individual free space fragments.
biggest
output
INT(32) .EXT:ref:1
is the size, in pages, of the largest free space fragment.
drivekinds
output
STRING .EXT:ref:16
identifies the kinds of drives on which the volume is mounted. The value contains two fields of
ASCII data:
The product number of the primary drive[0:7]
The product number of the mirror drive[8:15]
If information is unavailable for a drive (because it is inaccessible or not configured), its
corresponding field will be blank. Drive models 4110 and 4120, which cannot be distinguished
by software, are returned as "4110". Similarly, drive model 4106 is returned as "4105",
4111 as "4110", and 4115 as "4114".
The last four characters of the product-number fields sometimes contain either blanks or modifiers
used to distinguish between different versions of a product. Also, for the 4105 model, an "M"
or "F" modifier refers to the moving-head part or the fixed-head part of the drive.
drivecaps
output
INT(32) .EXT:ref:2
are the formatted capacities of the primary and mirror drives, in pages. These values account
for the space taken up for data protection (such as spare sectors), but not for other uses. If the
information is unavailable for a drive (because it is inaccessible or not configured), its
corresponding value is zero. These values are provided for cases in which different model
drives are mirrored and thus must be labeled with the smaller of the two formatted capacities.
Returned Value
INT
A file-system error code that indicates the outcome of the call.
Considerations
You should always supply at least one output parameter when calling DISKINFO. If you supply no
output parameters, the returned error value might vary with different device types of name and
with different versions of the operating system.
Example
NAME ':=' " " & NAME FOR 11;
NAME ':=' "$SYSTEM";
ERR := DISKINFO (NAME ,, FREE ,, BIG );
IF ERR <> 0 THEN ... !handle error
DISKINFO Procedure (Superseded by FILE_GETINFOLISTBYNAME_ Procedure) 321