MPE/iX Intrinsics Reference Manual (32650-90875)

196 Chapter5
Command Definitions (FCONTROL - FLOCK)
FGETINFO
0 Access in file's native mode
1 Access as standard sequential file
0:3 Reserved for the operating system.
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)