intn DFSDwriteref(char *filename, uint16 ref)
filename
IN:
Name of the HDF file
ref
Reference number for next add or put operation
Purpose
DFSDwriteref determines the reference number of the dataset to overwritten next by DFSDputdata or DFSDadddata, after checking for its existence.
Return value
Returns SUCCEED (or 0) if successful and FAIL (or -1) otherwise.
Description
If a non-existent reference number is specified, an error code will be returned.
As this routine alters data in a destructive manner, DFSDwriteref should be used with caution.
FORTRAN
integer function dswref(filename, ref)
character*(*) filename
integer ref