FCHECK

Requests details about file input/output errors.

 

               IV        I     I      D       I     O-V 

   FCHECK(filenum,errorcode,tlog,blknum,numrecs);

When a file intrinsic returns a condition code indicating a physical input/output error, additional details may be obtained by calling FCHECK. This intrinsic applies to files on any device.

FCHECK accepts zero as a legal filenum parameter value. When zero is specified, the information returned in errorcode reflects the status of the last call to FOPEN. When an FOPEN fails, there is no file number that can be referenced in filenum. Therefore, when an FOPEN fails, a filenum of zero can be used in the FCHECK intrinsic call to obtain the errorcode only. If the tlog, blknum, or numrecs parameters are specified, a zero value is returned to these parameters. If a filenum of zero is used for a file which has been opened but not yet closed, the returned errorcode is meaningless.

PARAMETERS

filenum

integer by value (required)

A word identifier supplying the file number of the file for which error information is to be returned.

errorcode

integer (optional)

A word to which is returned the error code specifying the type of error that occurred. If no error occurred errorcode is set to zero. (Refer to Table 4-3 “FCHECK errorcode Parameter Format” for the errorcode values.) The intrinsic FERRMSG returns a displayable message that corresponds to the value of errorcode.

Default: The error code is not returned.

tlog

integer (optional)

A word to which is returned the transmission log value recorded when an erroneous data transfer occurs. This word specifies the number of words not read or written (those left over) as the result of an input/ output error.

Default: The transmission log value is not returned.

blknum

double (optional)

A double word to which is returned the relative number of the block involved in the error.

Default: The block number is not returned.

numrecs

integer (optional)

A word to which is returned the number of logical records in the bad block.

Default: The number of logical records is not returned.

CONDITION CODES

CCE: Request granted.
CCG: Not returned by this intrinsic.
CCL: Request denied because filenum was invalid and errorcode is 72, or a bounds violation occurred while processing this request and errorcode is 73.

SPECIAL CONSIDERATIONS

Split stack calls permitted.

Table 4-3 FCHECK errorcode Parameter Format

FCHECK

Technical documentation

» Table of Contents

PARAMETERS

CONDITION CODES

SPECIAL CONSIDERATIONS