Using KSAM/XL and KSAM 64 (32650-90886)
88 Chapter9
KSAM Intrinsics
FFILEINFO
79 I16 File's pending disposition
0 = No change, the disposition is the same as before the file was opened
1 = Permanent
2 = Temporary (tape files rewound)
3 = Temporary (same as 2 except tape files not rewound)
4 = Released (purged)
5 = Temporary (but the file was previously a permanent file)
80 This
itemnum
returns a null-terminated POSIX-syntax system absolute
pathname for the file or directory referenced by
filenum
. On input the first four
bytes of this buffer are interpreted as a 32-bit unsigned integer specifying the
maximum buffer size in bytes. This maximum buffer size does not include the four
bytes used to represent this size. On output the first four bytes of the buffer
represent the pathname length excluding the null-terminator as an unsigned
integer. The pathname is returned in the bytes following the pathname length.
Bytes beyond the null-terminator should be considered undefined. If the
maximum buffer length is incorrect on input, variables allocated near the buffer
may be overwritten or a bounds violation may occur. A zero pathname length is
returned for unnamed new files and when an error occurs. Zero is the mininum
buffer length on input for this
itemnum
.
81 32-bit unsigned integer by reference. The current number of hard links to the file.
82 32-bit signed integer by reference. Time of last file access in clock format. The bit
assignments are:
Bits 0 7 hours
Bits 8 15 minutes
Bits 16 23 seconds
Bits 24 31 tenths of seconds
83 32-bit signed integer by reference. Time of last file status change. (Clock format -
See item 82 for a description of the format).
84 16-bit unsigned integer by reference. Date of last file status change in calendar
format. The bit assignements are:
Bits 0 - 7 Year of the century
Bits 8 - 15 Day of the year
85 32-byte character array by reference. File Owner:
The full file owner name. Unused characters are blank filled. 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.
Table 9-2. FFILEINFO Itemnum/Item Values
Item
num
Item
Type
Item Description