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

Chapter 9 233
Intrinsics Reference (cont)
FGETINFO
FGETINFO
Returns access and status information about a file.
Syntax
I6V CA U16 U16
FGETINFO(filenum, formaldesignator , foptions , aoptions ,
I16 I16 U16 U16
, devtype , ldevnum , hdaddr ,
I16 I32 I32 132 I32
filecode , lrecptr , EOF , filelimit , logcount ,
I32 I16 U16 I16
physcount , blksize , extsize , numextents ,
I16 CA I32
userlabels , creatorid , labaddr );
Use
The FGETINFO intrinsic returns access and status information about
a file located on any device. The file must be opened by the calling
process at the time of the FGETINFO call. When using this intrinsic
you need only specify those parameters that return the information
options you want. The default in all cases is that information that is not
explicitly requested is not returned.
Only those parameters that return information that applies to
asynchronous devices are described below. For an explanation of all the
parameters, you should see the MPE/iX Intrinsics Reference Manual.
Parameters
filenum 16-bit signed integer by value (required)
The file number of the file about which information is
required.
formaldesignator character array (optional)
Returns the actual designator of the file being
referenced in the following format:
filename.groupname.accountname
The
formaldesignator array must be at least
28 bytes in length. When the actual designator is
returned, unused bytes in the array are filled with