Asynchronous Serial Communications Programmer's Reference Manual (32022-90052)

230 Chapter9
Intrinsics Reference (cont)
FFILEINFO
FFILEINFO
Provides information about the characteristics of a file.
Syntax
I16V I16V *
FFILEINFO(filenum[, itemnum,item
[, itemnum,item
[, itemnum,item
[, itemnum,item
[, itemnum,item ]]]]]);
Use
The FFILEINFO intrinsic returns information about a file located on
any device. The file must be opened by the calling process at the time of
the FFILEINFO call. You specify the type of information you want to
access by using an item number that corresponds to that information as
the value of
itemnum . The file information requested is then returned
to your program in the
item parameter that constitutes the other half
of the
itemnum/item pair.
The
itemnum and item parameters must always be specified in pairs.
You can retrieve up to 5 types of information in one FFILEINFO call by
specifying 5
itemnum/item pairs.
Table 9-1 shows some of the information options available through a
call to FFILEINFO. Only the subset of options most applicable to files
in asynchronous devices are listed here. For a complete list of available
options, see the MPE/iX Intrinsics Reference Manual.
Parameters
filenumn 16-bit signed integer by value (required)
The file number of the file about which information is
requested.
itemnum 16-bit signed integer by value (optional)
Passes the item number (in any order) of an
information option. You can request up to 5 options in
one call.
item type varies (optional)
Returns information about the file as pertains to the
option specified in the related filenum.