DASURI ( DAS, update record, integer )
ENTRY DASURI ( HANDLE, RECNO, FIRST, LAST, DATAI )
Update DAS integer physical records.
INTEGER DATAI ( * )
Variable I/O Description
-------- --- --------------------------------------------------
HANDLE I Handle of DAS file.
RECNO I Record number.
LAST I First and last indices of range within record.
DATAI I Integer data to write to record.
HANDLE is the handle of a DAS file opened for writing.
RECNO is the number of a record in a DAS file.
LAST are the first and last indices of a range of
elements to be updated in the indicated record.
The record contains NWI integers; these have
indices ranging from 1 to NWI.
DATAI is an integer array to be written to elements FIRST
through LAST of the specified record. The array
element DATAI(1) is placed in record element FIRST,
the array element DATAI(2) is placed in record
element FIRST+1, and so on; the array element
DATAI(LAST-FIRST+1) is placed in the record element
None. See $Particulars for a description of the action of this
BUFSZI is the number of records in the integer record
1) This routine may be used to update only records that have
already been written by DASWRI or that already exist in the
file designated by HANDLE. Attempting to update a record
that hasn't yet been written will cause the read operation
performed by this routine to fail.
If a read operation attempted by this routine fails for this
or any other reason, the error will be diagnosed by routines
called by this routine. The indicated record will not be
2) If a write operation attempted by this routine fails, the
error will be diagnosed by routines called by this routine.
The status of the DAS file written to is uncertain in this
case. Note that the file written to may be different than
the file designated by HANDLE if multiple DAS files are open
3) If the input file handle is invalid, the error will be
diagnosed by routines called by this routine. The indicated
record will not be modified.
4) If FIRST or LAST is not in the range [1, NWI], the error
SPICE(INDEXOUTOFRANGE) will be signalled. The indicated
record will not be modified.
5) If FIRST > LAST, this routine will return without modifying
the indicated record.
See the description of the argument HANDLE in $Detailed_Input.
Routines outside of SPICELIB will normally have no need to call
This routine can be used to update any existing record in a DAS
file that is open for writing, or any record that has been
`written' by DASWRI, whether or not that record has yet been
physically written to the file it belongs to. Records that have
never been written cannot be updated.
Because the DAS system buffers records that are written, multiple
updates of parts of a record can be made without incurring a
large number of file reads and writes.
This routine should be used to update only records that contain
1) Update the 10th through 100th integers in record number 9
in a DAS file designated by HANDLE.
INTEGER DATAI ( 100 )
DO I = 1, 91
DATAI = I
CALL DASURI ( HANDLE, 9, 10, 100, DATAI )
K.R. Gehringer (JPL)
N.J. Bachman (JPL)
W.L. Taber (JPL)
SPICELIB Version 1.0.2, 03-NOV-1995 (NJB)
Removed weird spaces from ENTRY statement.
SPICELIB Version 1.0.1, 28-OCT-1993 (KRG)
Removed references to specific DAS file open routines in the
$ Detailed_Input section of the header. This was done in order
to minimize documentation changes if the DAS open routines ever
SPICELIB Version 1.0.0, 30-JUN-1992 (NJB) (WLT)