Procedure

     CKUPF ( CK, Unload pointing file )

     ENTRY CKUPF ( HANDLE )

Abstract

     Unload a CK pointing file so that it will no longer be searched
     by the readers.

Required_Reading

     CK
     DAF

Keywords

     POINTING

Declarations

    INTEGER               HANDLE

Brief_I/O

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

Detailed_Input

     HANDLE   is the integer handle assigned to the CK 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

     Unloading a file with CKUPF removes that file from consideration
     by the CK readers. In doing so, it frees up space for another
     file to be loaded.

Examples

     See $Examples in CKBSR.

Restrictions

     None.

Literature_References

     None.

Author_and_Institution

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

Version

    SPICELIB Version 4.3.2, 16-JUL-2020 (JDR)

        Updated the header to comply with NAIF standard.

    SPICELIB Version 4.3.1, 30-JAN-2017 (NJB)

        Corrected various spelling errors within comments.

    SPICELIB Version 4.3.0, 24-FEB-2011 (NJB)

        Bug fix: the null pointer test used to determine eligibility
        for segment list deletion now uses the .LE. operator instead
        of the .EQ. operator.

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

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

    SPICELIB Version 4.1.0, 20-NOV-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 4.0.0, 17-FEB-2000 (WLT)

        Added the Entry point CKHAVE.

    SPICELIB Version 3.0.0, 03-MAR-1999 (WLT)

        The parameter STSIZE was increased from 1000 to 4000 to
        avoid the buffering error that exists in the CKBSR.

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

        A bug in the way that CKLPF and CKUPF clean up the instrument
        tables after a file is unloaded was fixed.

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

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

    SPICELIB Version 1.0.0, 07-SEP-1990 (RET) (IMU)