NDF_HFIND

Find an NDF history record by date and time

Description:

The routine searches the history component of an NDF to identify the first history record which was written after a specified date and time. The record number is returned. A value of zero is returned if no suitable record exists.

Invocation

CALL NDF_HFIND( INDF, YMDHM, SEC, EQ, IREC, STATUS )

Arguments

INDF = INTEGER (Given)
NDF identifier.
YMDHM( 5 ) = INTEGER (Given)
The year, month, day, hour and minute fields of the required date and time, in that order, stored as integers (the month field starts at 1 for January).
SEC = REAL (Given)
The seconds field of the required date and time.
EQ = LOGICAL (Given)
If a .TRUE. value is given for this argument, then a history record whose date and time exactly matches that specified may be returned. Otherwise, the record must have been written strictly later than specified.
IREC = INTEGER (Returned)
The record number of the required history record, or zero if no suitable record exists.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:

The last history record written before a specified date and time may be found by subtracting 1 from the record number returned by this routine (or using the final record if this routine returns zero).