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

Chapter 9 83
KSAM Intrinsics
FFILEINFO
6 U16 Logical device number: Returns the logical device number of the device where the
disk file label resides.
• If the file is a disk file, the LDEV is the location of the file label. (File data can
reside on the same device as the file label.)
• If the file is spooled, the LDEV is a virtual device number that does not
correspond to the system configuration I/O device list.
• If the file is located on a remote computer, linked by a DS point-to-point or
X.25 link, the left eight bits (0:8) are the LDEV of the distributed system (DS)
device.
• If the file is located on a remote computer, linked by NS 3000/XL, the left eight
bits (0:8) are the remote environment of the connection. The right eight bits
(8:8) are the LDEV of the device on the remote computer where the file label
resides.
• If the DS device for the RFA or the LDEV is 0, then a zero is returned.
NOTE If a zero is returned, use item 50.
7 U16 Hardware device address: Returns 2048. Maintained to provide backward
compatibility with MPE V/E-based systems.
8 I16 File code: Returns the file code of a disk file (refer to FFILEINFO for file codes).
9 I32 Current logical record pointer: Returns the current logical record pointer setting.
This value is the displacement in logical records from record number 0 in the file
and identifies the record that would be accessed next by FREAD or FWRITE.
10 I32 EOF: Returns the pointer setting of the last logical record currently in the file
(equivalent to EOF). If the file does not reside on disk, the value is zero. For
message files, when a call is made to FCONTROL with itemnum =46, the number of
records returned includes open, close, and data records.
11 I32 File limit: Returns a number representing the last logical record that can exist in
the file (equivalent to the file limit). If the file does not reside on disk, the value is
zero.
12 I32 Log count: Returns the logical records passed to and from the program during the
current file access.
13 I32 Physical count: Returns the number of buffered physical I/O operations performed
since the last FOPEN/HPFOPEN call (records).
Table 9-2. FFILEINFO Itemnum/Item Values
Item
num
Item
Type
Item Description