Using KSAM/XL and KSAM 64 (32650-90886)

Chapter 9 101
KSAM Intrinsics
FGETINFO
FGETINFO
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.
foption 16-bit unsigned integer by reference (optional)
Returns seven different file characteristics by setting corresponding bit
groupings. The file characteristics are those specified for
foptions in the
FOPEN intrinsic.
aoption 16-bit unsigned integer by reference (optional)
Returns up to seven different access options represented by bit groupings
as described for the
aoptions parameter of FOPEN.
lrecsize 16-bit signed integer by reference (optional)
Returns the logical record size associated with the file:
• If the file was created as a binary file, this value is positive and
expresses the size in halfwords.