Asynchronous Serial Communications Programmer's Reference Manual (32022-90052)

Chapter 8 157
Intrinsics Reference
FCHECK
FCHECK
Used to request specific details about file input/output errors.
SYNTAX
I16V I16 I16 I32 I16
FCHECK( filenum , fserrorcode,translog,blocknum,numrecs );
Use
You can use the FCHECK intrinsic to obtain specific details about an
error that occurred during execution of a file system intrinsic. If an
intrinsic returns a condition code of CCL or CCG, FCHECK should be
used to determine the error code associated with the problem that
occurred. You can then use FERRMSG to display the message
associated with that error code.
You can determine the error condition of a failed FOPEN call when no
file number was returned by setting the filenum parameter to 0. In
this case only, fserrorcode returns valid information.
Do not use FCHECK to determine error conditions of failed calls to
HPFOPEN. Error conditions associated with failed HPFOPEN calls are
returned in the HPFOPEN status parameter.
Parameters
filenum 16-bit signed integer by value (optional)
The file number of the file for which error information
is to be returned. If you do not specify filenum, or if
you specify 0, FCHECK assumes you want error
information concerning 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. A return value of 0 indicates that
the previous operation was successful or an EOF was
encountered. Default: The error code is not returned.
translog 16-bit signed integer by reference
(optional)
Returns the transmission log value that indicates the
number of halfwords that were actually read or written.
Default: The transmission log value is not returned.