Procedure

     SPKUEF ( SPK Kernel, Unload ephemeris file )

     ENTRY SPKUEF ( HANDLE )

Abstract

     Unload an ephemeris file so that it will no longer be searched by
     the readers.

Required_Reading

     SPK

Keywords

     EPHEMERIS
     FILES

Declarations

    INTEGER               HANDLE

Brief_I/O

     VARIABLE  I/O  DESCRIPTION
     --------  ---  --------------------------------------------------
     HANDLE     I   Handle of file to be unloaded

Detailed_Input

     HANDLE   is the integer handle assigned to the file upon loading.

Detailed_Output

     None.

Parameters

     None.

Exceptions

     1)  Unloading a file that has not been loaded is a no-op.
         No error is signaled.

Files

     The file referred to by HANDLE is unloaded.

Particulars

     A file is removed from consideration by the readers by a call to
     SPKUEF.

     The file table entry corresponding to the file referenced by
     HANDLE, is removed. Any segment table entry which came from the
     specified file is also deleted.

     If the file specified by HANDLE is not currently loaded in the
     SPK system, no action is taken.

Examples

     See $Examples in SPKBSR.

Restrictions

     None.

Literature_References

     None.

Author_and_Institution

     N.J. Bachman       (JPL)
     J. Diaz del Rio    (ODC Space)
     J.M. Lynch         (JPL)
     H.A. Neilan        (JPL)
     W.L. Taber         (JPL)
     R.E. Thurman       (JPL)

Version

    SPICELIB Version 4.1.2, 17-JUN-2021 (JDR)

        Updated the header to comply with NAIF standard.

        Removed the reference to SPK required reading from
        $Literature_References section. Extended $Particulars
        section.

    SPICELIB Version 4.1.1, 15-MAR-2017 (NJB)

        Corrected various spelling errors within comments.

    SPICELIB Version 4.1.0, 08-SEP-2005 (NJB)

        Updated to remove non-standard use of duplicate arguments
        in MOVED call.

    SPICELIB Version 4.0.0, 28-DEC-2001 (NJB)

        Bug fixes:

        1) This routine now calls RETURN() on entry and
           returns if so directed.

        Also, the flags indicating validity of those re-use intervals
        whose data comes from the unloaded file are set to .FALSE.


    SPICELIB Version 3.0.0, 14-AUG-1995 (WLT)

        An interim fix to a bug in SPKBSR was made. The parameters
        STSIZE and BTSIZE were increased to be much larger than before
        (from 100 and 20 to 2000 and 40 respectively). This should
        keep the boundary errors experienced by Cassini users from
        occurring again. Version 4.0.0 with a real fix to the
        boundary problem should be installed in SPICELIB by
        October 1995

    SPICELIB Version 2.0.0, 25-NOV-1992 (JML)

        A bug in the way that SPKLEF and SPKUEF clean up the body
        tables after a file is unloaded was fixed.

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

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

    SPICELIB Version 1.1.0, 02-MAY-1990 (RET)

        If unloading a file causes all segments in the list for a
        body to go away, delete that body from the body list.

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

        Literature references added to the header.

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