uready
Informs the connector whether it needs to continue searching through the preferred index
short uready(uc)
struct uctrl *uc;
Parameters
uc—address of the current control block.
Return Values
The return values are:
- 0—the connector must continue searching
- <>0—the connector can stop searching
Description
uready informs the connector whether
it needs to continue searching through the preferred index. It can
only be used in combination with uhitchk. uready uses the ordering imposed by
the preferred index to stop searching as soon as possible.
The following
example is an extension of the example provided for the uhitchk service function.
long SelectRecords ( struct uctrl *ControlBlock )
{
long Hits = 0;
unsigned char *PRABuffer;
short Ready;
do
{
... /* Select record. Allocate and fill PRABuffer with*/
/* PRA if appropriate. */
...
Ready = uready ( ControlBlock );
Hits += uhitchk ( ControlBlock, 0, PRABuffer );
/* Increased ’Hits’ when the record is a hit. */
...
if ( Ready )
{
return ( Hits );
}
} while ... /* Calculate stop criterion based on */
/* ’ControlBlock->umode’, */
/* ’ControlBlock->umaxhits’ and ’Hits’. */
return ( Hits );
}
