Product Documentation

c-treeRTG 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

c-treeRTG 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 c-treeRTG 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, c-treeRTG 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 c-treeRTG server does not support <startonread>, the c-treeRTG client fails and logs error message "server does not support <startonread> configuration."

TOCIndex