MPE/iX Intrinsics Reference Manual (32650-90875)

198 Chapter5
Command Definitions (FCONTROL - FLOCK)
FGETINFO
• If the file is ASCII, the value is negative and the size is in bytes.
Maintained for backward compatibility with MPE V/E-based systems.
MPE V/E block size limits are imposed when FGETINFO returns block size
information on all file types (STD, KSAM, RIO, CIR, MSG). If the block
size of the specified file exceeds MPE V/E limits, 0 is returned. Use
itemnum =68 of the FFILEINFO intrinsic or itemnum =31 of the FLABELINFO
intrinsic to get valid MPE/iX block size data if the block size exceeds
MPE V/E limits.
(ASC) Not valid for asynchronous device files.
extsize 16-bit unsigned integer by reference (optional)
Maintained to provide backward compatibility with MPE V/E-based
systems.
(ASC) Not valid for asynchronous device files.
numextent 16-bit signed integer by reference (optional)
Maintained to provide backward compatibility with MPE V/E-based
systems.
(ASC) Not valid for asynchronous device files.
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.
(ASC) Not valid for asynchronous device files.
creatorid character array (optional)
An unqualified form of the file owner's name is returned as the value of
this parameter. The file owner is not necessarily the file's creator. File
ownership may be changed using the :ALTFILE command.
A symbolic zero (ASCII 48 in decimal) is returned as the file owner for root
directories, accounts, and MPE groups created prior to the POSIX release.
If the file is not located in the account in which the file owner is a member,
a blank file owner name is returned.
(ASC) Not valid for asynchronous device files.
labaddr 32-bit signed integer by reference (optional)
Returns a zero. Maintained for backward compatibility with
MPE V/E-based systems.
(ASC) Not valid for asynchronous device files.
Operation Notes
Returns access and status information about a file located on any device. The file must be