Procedure

     PCKUOF ( PCK, unload binary file )

     ENTRY PCKUOF ( HANDLE )

Abstract

     Unload a binary PCK file so that it will no longer be searched by
     the readers.

Required_Reading

     DAF
     PCK

Keywords

     FILES
     PCK

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 PCK 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 PCK file is removed from consideration during a search by the
     readers by a call to PCKUOF.

     The file table entry corresponding to the file referenced by
     HANDLE is removed and the file is closed. 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
     PCK system, no action is taken.

Examples

     See $Examples in PCKBSR.

Restrictions

     None.

Literature_References

     None.

Author_and_Institution

     N.J. Bachman       (JPL)
     J. Diaz del Rio    (ODC Space)
     E.D. Wright        (JPL)
     K.S. Zukor         (JPL)

Version

    SPICELIB Version 4.1.3, 09-JUL-2020 (JDR)

        Edited the header to comply with NAIF standard.

        Improved documentation of $Detailed_Input and $Particulars
        sections.

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

        Corrected various spelling errors within comments.

    SPICELIB Version 4.1.1, 03-JAN-2014 (EDW)

        Minor edits to $Procedure; clean trailing whitespace.
        Removed unneeded $Revisions section.

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

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

    SPICELIB Version 1.1.0, 08-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 1.0.0, 16-MAR-1994 (KSZ)