Product Documentation

FairCom RTG COBOL Edition User's Guide

Previous Topic

Next Topic

<recordcheck>

The recordcheck option specifies whether to check that the record length of the file being open matches the record length definitions of the calling application.

If this option is set to "yes", an error is returned at file open time if the record minlen or maxlen does not match the application-defined minlen or maxlen. This is the default option.

If this option is set to "no", an error is returned at file open time only if the record minlen or maxlen is less than the application-defined record minlen or maxlen.

This option is must useful for a table that has been expanded with new fields using the RTG alter table operation. Existing runtimes might not be immediately able to be recompiled, and this option allows file opens from these existing applications as they don't care and are unaware of any new fields that have been added.

Note: recordcheck is performed at the time the file is opened, to validate the application-defined record maximum and minimum lengths. This is in contrast to the maxlencheck option which validates only the maximum length each time a record is read, to ensure that variable length records are compatible.

Accepted Values

Value

Effect

Synonyms

yes

Return an error if the application-defined record lengths do not match the file's record lengths. This is the default value.

y, true, on, 1

no

Return an error only if at least one of the application-defined record lengths is greater than the file's corresponding record length.

n, false, off, 0

Example

<recordcheck>no</recordcheck>

See Also

-alter

<maxlencheck>

TOCIndex