Product Documentation

FairCom RTG COBOL Edition User's Guide

Previous Topic

Next Topic

<startonread>

Enables "Start on Read" logic to improve performance of applications that perform a large number of START operations all followed by READ sequential operations, such as READ NEXT or READ PREVIOUS.

Accepted Values

Value

Effect

Synonyms

yes

FairCom RTG does not execute the START operations until the subsequent READ sequential operation (READ NEXT or READ PREVIOUS).

y, true, on, 1

no

Disables this logic.

n, false, off, 0

Example

To enable start on READ logic:

<startonread>yes</startonread>

Notes

In FairCom RTG V3 and later, the <startonread> configuration option improves performance of COBOL applications that perform a large number of START operations all followed by READ sequential operations, such as READ NEXT or READ PREVIOUS.

When <startonread> is enabled, FairCom RTG does not execute the START operations immediately. Instead, it waits for the subsequent READ sequential operation (READ NEXT or READ PREVIOUS). The effect is that START operations return immediately but never fail even if the specified key is not valid. It is the subsequent READ sequential operation that executes the START operation and eventually returns the error. For this reason, we do not recommend using this option unless the user understands the risks.

If the FairCom RTG server does not support <startonread>, the FairCom RTG client fails and logs error message "server does not support <startonread> configuration."

TOCIndex