MPE/iX Intrinsics Reference Manual (32650-90875)

192 Chapter5
Command Definitions (FCONTROL - FLOCK)
FGETINFO
FGETINFO
NM and CM callable.
Returns access and status information about a file.
NOTE FGETINFO is provided for compatibility with MPE V/E-based systems only. It
is recommended that FFILEINFO be used to access data.
Syntax
I16V CA U16 U16
FGETINFO(
filenum , formaldesig,foption,aoption
I16 I16 U16 U16 I16
lrecsize,devtype,ldevnum,hdaddr,filecode,
I32 I32 I32 I32 I32 I16
lrecptr,eof,filelimit,logcount,physcount,blksize,
U16 I16 I16 CA I32
extsize,numextent,userlabels,creatorid,labaddr);
Parameters
filenum 16-bit signed integer by value (required)
Passes the file number of the file for which information is requested.
formaldesig character array (optional)
Returns the actual designator of the file being referenced, in the following
format:
filename.groupname.accountname
The formaldesig array must be at least 28 bytes in length. When the
actual designator is returned, unused bytes in the array are filled with
blanks on the right. A nameless file returns an empty string.
The fully qualified name of the file referenced by
filenum is returned as
the value of this parameter. Only names which can be expressed using
MPE-only semantics are returned. If the name of the object referenced by
filenum can not be expressed using MPE-name semantics, a CCL
condition code is returned. Calling FCHECK after this error will return
FSERR391.
foption 16-bit unsigned integer by reference (optional)
Returns seven file access characteristics by setting bit groupings as
follows:
Bits Value/Meaning
14:2
Domain