VMS Help LBR Routines, LBR$DELETE_DATA  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The LBR$DELETE_DATA routine deletes the module header and data
    associated with the specified module.

    Format

      LBR$DELETE_DATA  library_index ,txtrfa

1 - Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

    Longword condition value. Most utility routines return a
    condition value in R0. Condition values that this routine can
    return are listed under Condition Values Returned.

2 - Arguments

 library_index

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference
    Library control index returned by the LBR$INI_CONTROL routine.
    The library_index argument is the address of the longword that
    contains the index.

 txtrfa

    OpenVMS usage:vector_longword_unsigned
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference
    Record's file address (RFA) of the module header for the module
    you want to delete. The txtrfa argument is the address of the 2-
    longword array that contains the RFA. You can obtain the RFA of a
    module header by calling LBR$LOOKUP_exit KEY or LBR$PUT_RECORD.

3 - Description

    If you want to delete a library module, you must first call
    LBR$DELETE_KEY to delete any keys that point to it. If no library
    index keys are pointing to the module header, LBR$DELETE_DATA
    deletes the module header and associated data records; otherwise,
    this routine returns the error LBR$_STILLKEYS.

    Note that other LBR routines may reuse data blocks that contain
    no data.

4 - Condition Values Returned

    LBR$_ILLCTL        Specified library control index not valid.
    LBR$_INVRFA        Specified RFA not valid.
    LBR$_LIBNOTOPN     Specified library not open.
    LBR$_STILLKEYS     Keys in other indexes still point at the
                       module header. Therefore, the specified module
                       was not deleted.