Using KSAM/XL and KSAM 64 (32650-90886)

Chapter 9 103
KSAM Intrinsics
FGETINFO
filelimit 32-bit signed integer by reference (optional)
Returns a number representing the last logical record that could exist in
the file (the physical limits of the file). If the file does not reside on disk,
this value is zero.
logcount 32-bit signed integer by reference (optional)
Returns the total number of logical records passed to and from the
program during the current file access.
physcount 32-bit signed integer by reference (optional)
Returns the total number of physical I/O operations performed within the
process, against the file, since the last FOPEN/HPFOPEN call.
blksize 16-bit signed integer by reference (optional)
Returns the file block size:
• If the file is binary, the value is positive and the size is in halfwords.
• If the file is ASCII, the value is negative and the size is in bytes.
extsize 16-bit unsigned integer by reference (optional)
Maintained to provide backward compatibility with MPE V/E-based
systems.
numextent 16-bit signed integer by reference (optional)
Maintained to provide backward compatibility with MPE V/E-based
systems.
userlabels 16-bit signed integer by reference (optional)
Returns the number of user labels defined for the file during creation. If
the file is not a disk file, this number is zero. When an old file is opened for
overwrite output, the value of
userlabels is not reset, and old user labels
are not destroyed.
creatorid character array (optional)
Returns the name of the file creator (8-character array). If the file is not a
disk file, blanks are returned.
labaddr 32-bit signed integer by reference (optional)
Returns a zero. Maintained for backward compatibility with
MPE V/E-based systems.
Operation Notes
Returns access and status information about a file located on any device. The file must be
opened by the calling process at the time of the FGETINFO call.