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

84 Chapter9
KSAM Intrinsics
FFILEINFO
14 I16 Block size: 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.
Maintained for compatibility with MPE V/E-based systems only. CM block size
limits are used when FGETINFO returns block size information on all file types
(STD, KSAM, RIO, CIR, MSG). If the block size of the specified file exceeds the
limits, zero is returned.
NOTE If a zero is returned, use item 68.
15 I16 Extent size: Returns the extent size; for compatibility with MPE V/E-based
systems only.
NOTE If a zero is returned, use item 69. If extent size is specified or the
maximum number of extents is specified at file creation, the size
and number of extents are determined by the operating system and
the item values are not actual values; they are calculated using
system defaults.
16 U16 Maximum number of extents:
If the extent size or maximum number of extents is specified as zero at file
creation, then the size and number of extents are determined by the system. In
that case, these item values are calculated using system defaults defaults and do
not reflect actual values.
17 I16 User labels: 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 is not reset and the old user label is not destroyed.
18 CA Creator: Returns the name of the file creator (at least 8 bytes). If the file does not
reside on disk, blanks are returned.
An unqualified form of the file owner's name is returned as the value of this
itemnum . The file owner is not neccessarily the file's creator. File ownership may
be changed using (see engineer).
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. Item number 85 should be used to obtain the full file
owner name instead of item 18.
19 I32 Label address: Returns a zero. For compatibility with MPE V/E-based systems
only.
Table 9-2. FFILEINFO Itemnum/Item Values
Item
num
Item
Type
Item Description