Procedure

     DVPOOL ( Delete a variable from the kernel pool )

     ENTRY DVPOOL ( NAME )

Abstract

     Delete a variable from the kernel pool.

Required_Reading

     KERNEL

Keywords

     CONSTANTS
     FILES

Declarations

    CHARACTER*(*)         NAME

Brief_I/O

     VARIABLE  I/O  DESCRIPTION
     --------  ---  --------------------------------------------------
     NAME       I   Name of the variable to be deleted.

Detailed_Input

     NAME     is the name of the kernel pool variable to delete.
              The name and associated values are removed from the
              kernel pool, freeing the occupied space.

              If a watches are set on the variable designated by
              NAME, the corresponding agents are placed on the list
              of agents to be notified of a kernel variable update.

Detailed_Output

     None.

Parameters

     None.

Exceptions

     1)  If the specified variable is not present in the kernel pool,
         this routine simply returns. No error is signaled.

Files

     None.

Particulars

     This routine enables users to selectively remove variables from
     the kernel pool, as opposed to having to clear the pool and
     reload it.

     Note that it is not necessary to remove kernel variables in order
     to simply update them; this routine should be used only when
     variables are to be removed.

Examples

     1)  Remove triaxial radii of Jupiter from the kernel pool.

            CALL DVPOOL ( 'BODY599_RADII' )

Restrictions

     None.

Literature_References

     None.

Author_and_Institution

     N.J. Bachman       (JPL)
     J. Diaz del Rio    (ODC Space)
     B.V. Semenov       (JPL)
     W.L. Taber         (JPL)

Version

    SPICELIB Version 8.3.1, 17-AUG-2021 (JDR)

        Edited the header to comply with NAIF standard.

        Moved example from $Restrictions to $Examples section.

    SPICELIB Version 8.3.0, 30-JUL-2013 (BVS)

        Updated to increment POOL state counter.

    SPICELIB Version 8.2.0, 19-MAR-2009 (NJB)

        Watcher update code was re-written for compatibility
        with new watcher system implementation.

    SPICELIB Version 8.1.0, 22-DEC-2004 (NJB)

        Bug fix: corrected logic for determining when a
        conflict resolution list is non-empty.

        Corrected an in-line comment relating to finding the
        head node of the conflict resolution list for NAME.

    SPICELIB Version 8.0.0, 04-JUN-1999 (NJB) (WLT)

        Added the entry points PCPOOL, PDPOOL and PIPOOL to allow
        direct insertion of data into the kernel pool without having
        to read an external file.

        Added the interface LMPOOL that allows SPICE
        programs to load text kernels directly from memory
        instead of requiring a text file.

        Added the entry point SZPOOL to return kernel pool definition
        parameters.

        Added the entry point DVPOOL to allow the removal of a variable
        from the kernel pool.

        Added the entry point GNPOOL to allow users to determine
        variables that are present in the kernel pool