Procedure

     DAFBNA ( DAF, begin new array )

     ENTRY DAFBNA ( HANDLE, SUM, NAME )

Abstract

     Begin a new array in a DAF.

Required_Reading

     DAF

Keywords

     FILES

Declarations

    IMPLICIT NONE

    INTEGER               HANDLE
    DOUBLE PRECISION      SUM     ( * )
    CHARACTER*(*)         NAME

Brief_I/O

     VARIABLE  I/O  DESCRIPTION
     --------  ---  --------------------------------------------------
     HANDLE     I   Handle of DAF.
     SUM        I   Summary of new array.
     NAME       I   Name of new array.

Detailed_Input

     HANDLE   is the handle of a DAF opened for write access
              by a previous call to DAFOPW or DAFOPN.

     SUM      is the summary of a new array to be added to the
              specified file. The addresses (the final two integer
              components) need not be filled in.

     NAME     is the name of the new array.

Detailed_Output

     None.

Parameters

     None.

Exceptions

     1)  If the input handle is not that of a DAF that is open for
         writing, an error is signaled by a routine in the call tree of
         this routine. These files are implicitly of the native binary
         file format.

     2)  If the input array name is too long to fit in the number
         of characters allowed by the summary format of the DAF
         designated by HANDLE, the excess characters are truncated.
         No error is signaled.

     3)  If there is not enough room in the state table to add
         the DAF associated with HANDLE, the error SPICE(STFULL)
         is signaled.

Files

     See argument HANDLE, above.

Particulars

     Only one array can be added to a DAF at any one time, so
     calling DAFBNA cancels any addition to the file specified
     by HANDLE that may be in progress. No warning is issued.

Examples

     See $Examples in DAFANA.

Restrictions

     None.

Literature_References

     None.

Author_and_Institution

     N.J. Bachman       (JPL)
     J. Diaz del Rio    (ODC Space)
     H.A. Neilan        (JPL)
     W.L. Taber         (JPL)
     F.S. Turner        (JPL)
     I.M. Underwood     (JPL)

Version

    SPICELIB Version 3.1.0, 06-JUL-2021 (JDR)

        Added IMPLICIT NONE statement.

        Edited the header to comply with NAIF standard.

    SPICELIB Version 3.0.0, 16-NOV-2001 (FST)

        Updated DAFBNA to support changes made to the DAF
        system that utilize the new handle manager. See
        the $Revisions section of DAFANA for a detailed
        discussion of the changes.

    SPICELIB Version 2.0.1, 10-MAR-1992 (WLT)

        Comment section for permuted index source lines was added
        following the header.

    SPICELIB Version 2.0.0, 04-SEP-1991 (NJB) (WLT)

        Modified to support simultaneous writes to multiple DAFs.

    SPICELIB Version 1.0.1, 22-MAR-1990 (HAN)

        Literature references added to the header.

    SPICELIB Version 1.0.0, 31-JAN-1990 (IMU)