MPE/iX Intrinsics Reference Manual (32650-90905)

Chapter 4 107
Command Definitions (ABORTSESS - FCLOSE)
FCHECK
FCHECK
NM and CM callable.
Returns specific details about error conditions that occurred when a file system intrinsic
returns a condition code indicating an I/O error. FCHECK applies to files on any device.
Syntax
I16V I16 I16 I32 I16
FCHECK(
filenum,fserrorcode,translog,blocknum,numrecs );
Parameters
filenum 16-bit signed integer by value (optional)
Passes the file number of the file for which error information is to be
returned. If
filenum is set to zero or if it is not specified, error information
is returned about the last failed FOPEN call.
fserrorcode 16-bit signed integer by reference (optional)
Returns a file system error code indicating the type of error that occurred.
translog 16-bit signed integer by reference (optional)
Returns the number of half words read or written if an I/O error occurred.
(This value is recorded in the transmission log.)
blocknum 32-bit signed integer by reference (optional)
Returns the physical record count for a nonspoolfile or the logical record
count for a spoolfile:
• For fixed-length and undefined-length record files, the physical count is
the number of physical records transferred to or from the file since
FOPEN.
• For variable-length record files, the physical count is the last rewind,
rewind/unload, space forward or backward to tape mark.
numrecs 16-bit signed integer by reference (optional)
Returns the number of logical records in the bad block (blocking factor).
(ASC only) This parameter is not meaningful for asynchronous devices.
Error Code Description
0 Successful or end-of-file (EOF)
1
Illegal DB register setting
2 Illegal capability
3 Required parameter missing