MPE/iX Intrinsics Reference Manual (32650-90905)
Chapter 5 167
Command Definitions (FCONTROL - FLOCK)
FFILEINFO
2 U16 File options:
Returns file characteristics (refer to the
foption
figure). The record format
extension bit is returned as the
foption
(1:1) bit. Byte stream record format is
represented as a record format extension of one with a variable record format
foption
(8:2) bits equal to 01.
Directories, symbolic links, device links, pipes and FIFO's can not be
represented by
foptions
. If the object referenced by
filenum
is one of these
objects, a CCL condition code is returned. Calling FCHECK for
filenum
after this
error occurs will will return FSERR399
3 U16 Access options:
Returns file access information (refer to the
Faoption
figure).
4 I16 (CM) Record size:
Returns the logical record size associated with the file:
• If the file was created as a binary file, this value is positive and is in half
words.
• If the file was created as an ASCII file, this value is negative and is in bytes.
For message files, when there is call to FCONTROL with
controlcode
=46, the
value returned is the size of the data records, including the 4 byte header.
Maintained for compatibility with MPE V/E-based systems only. CM record
sizes are imposed when FGETINFO returns record size information on all file
types. If the record size exceeds the limits, a zero is returned.
Note: If a zero is returned, use item 67.
5 I16 Device type/subtype:
Returns the type and subtype of the device being used for a KSAM, RIO,
circular, or message file, or devices such as a tape drive, printer, or terminal
where bits (0:8) indicate the device subtype, and bits (8:8) indicate the device
type.
If the file is not spooled or is opened as a spoolfile through the logical device, the
actual value is returned. If an output file is spooled and was opened by device
class name, the type and subtype of the first device in its class is returned. (This
may be different from the device actually used.)
Table 5-2. FFILEINFO Itemnum/Item Values
Itemnu
m
Item
Type
Item Description