- 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 half words.
If the file was created as an ASCII file, this value is negative and
expresses the size in bytes.
For interprocess communication (IPC), when there is a call
to FCONTROL with controlcode=46 , the value
returned in lrecsize is the size of the data records, including the
4-byte header.
Maintained to ensure backward compatibility with MPE V/E-based systems.
MPE V/E record size limits are imposed when FGETINFO returns
record size information on all file types (STD, KSAM, RIO, CIR, MSG).
If the record size of the specified file exceeds MPE V/E limits, a zero
is returned. Use itemnum 67 of the FFILEINFO intrinsic
or itemnum 30 of the FLABELINFO intrinsic to obtain valid
MPE/iX record size data if the record size exceeds MPE V/E limits.
- devtype
16-bit signed integer by reference (optional)
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 device subtype,
and bits (8:8) indicate device type. For standard disk files,
bits (8:8)=00000011 and bits (0:8)=00001000 (indicate a 7933/35 disk
drive).
If the file is not spooled or is opened as a spoolfile through the logical
device, the returned devtype is actual. If an output file is spooled
and was opened by device class name, devtype contains the type and
subtype of the first device in its class. (This may be different from the
device actually used.)
- ldevnum
16-bit unsigned integer by reference (optional)
Returns the logical device number (ldev) associated with the
device where the file label resides:
If the file is a disk file, ldevnum is the location of
the file label. (File data may reside on the same device as the
file label.)
If the file is spooled, ldevnum is a virtual device number that
does not correspond to the system configuration I/O device list.
If the file is located on a remote computer, linked by a DS
point-to-point or X.25 link, the left eight bits (0:8) are the logical
device number of the distributed system (DS) device.
If the remote computer is linked by NS 3000/XL, the left eight bits (0:8)
are the remote environment of the connection. The right eight
bits (8:8) are the LDEV of the device on the remote computer where the
file label resides.
If the DS device for the RFA or the LDEV is 0, then ldevnum returns
a 0.
- hdaddr
16-bit unsigned integer by reference (optional)
Returns 2048. Maintained to provide backward compatibility with
MPE V/E-based systems.
- filecode
16-bit signed integer by reference (optional)
Returns the file code of a disk file.
(ASC) Not valid for asynchronous device files.
- lrecptr
32-bit signed integer by reference (optional)
Returns the current logical record pointer setting. This value is
the displacement in logical records from record number 0 in the file
and identifies the record that would be accessed next by
an FREAD or FWRITE call.
(ASC) Not valid for asynchronous device files.
- eof
32-bit signed integer by reference (optional)
Returns the pointer setting of the last logical record currently in
the file (equivalent to the number of logical records currently in the
file). If the file does not reside on disk, this value is zero. For
interprocess communication (IPC), when a call to FCONTROL with
itemnum=46 is in effect, the number of records returned
in eof includes open, close, and data ecords.
(ASC) Not valid for asynchronous device files.
- filelimit
32-bit signed integer by reference (optional)
Returns a number representing the last logical record that could
exist in the file (the physical limits of the file).
If the file does not reside on disk, this value is zero.
(ASC) Not valid for asynchronous device files.
- logcount
32-bit signed integer by reference (optional)
Returns the total number of logical records passed to and from the
program during the current file access.
- physcount
32-bit signed integer by reference (optional)
Returns the total number of physical I/O operations performed
within the process, against the file, since the
last FOPEN/HPFOPEN call.
- blksize
16-bit signed integer by reference (optional)
Returns the file block size:
If the file is binary, the value is positive and the size is in half words.
If the file is ASCII, the value is negative and the size is in bytes.
Maintained for backward compatibility with
MPE V/E-based systems.
MPE V/E block size limits are imposed when FGETINFO returns
block size information on all file types (STD, KSAM, RIO, CIR, MSG).
If the block size of the specified file exceeds MPE V/E limits,
0 is returned. Use itemnum=68 of the FFILEINFO intrinsic
or itemnum=31 of the FLABELINFO intrinsic to get valid
MPE/iX block size data if the block size exceeds
MPE V/E limits.
(ASC) Not valid for asynchronous device files.
- extsize
16-bit unsigned integer by reference (optional)
Maintained to provide backward compatibility with
MPE V/E-based systems.
(ASC) Not valid for asynchronous device files.
- numextent
16-bit signed integer by reference (optional)
Maintained to provide backward compatibility with
MPE V/E-based systems.
(ASC) Not valid for asynchronous device files.
- userlabels
16-bit signed integer by reference (optional)
Returns the number of user labels defined for the file during creation.
If the file is not a disk file, this number is zero.
When an old file is opened for overwrite output, the value
of userlabels is not reset, and old user labels are not destroyed.
(ASC) Not valid for asynchronous device files.
- creatorid
character array (optional)
An unqualified form of the file owner's name is returned as the
value of this parameter. The file owner is not necessarily the
file's creator. File ownership may be changed using the
:ALTFILE command.
A symbolic zero (ASCII 48 in decimal) is returned as the file owner
for root directories, accounts, and MPE groups created prior to the
POSIX release.
If the file is not located in the account in which the file owner is
a member, a blank file owner name is returned.
(ASC) Not valid for asynchronous device files.
- labaddr
32-bit signed integer by reference (optional)
Returns a zero. Maintained for backward compatibility with
MPE V/E-based systems.
(ASC) Not valid for asynchronous device files.