MPE/iX Intrinsics Reference Manual (32650-90875)

168 Chapter5
Command Definitions (FCONTROL - FLOCK)
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.
Table 5-2. FFILEINFO Itemnum/Item Values
Itemnu
m
Item
Type
Item Description