next up previous
Next: NDF_HINFO - Obtain information about an NDF's history component
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_HEND - End NDF history recording for the current application

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).



next up previous
Next: NDF_HINFO - Obtain information about an NDF's history component
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_HEND - End NDF history recording for the current application


Starlink User Note 33
R.F. Warren-Smith
11th January 2000
E-mail:rfws@star.rl.ac.uk

Copyright © 2000 Council for the Central Laboratory of the Research Councils