- 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.
Printable version
