NDG_REMOVEPROV - Remove one or more ancestors from a provenance structure

Description:

This routine removes one or more ancestors from the supplied provenance structure. The direct parents of the removed ancestor are assigned to the direct children of the removed ancestor. Note, any history records stored in the removed ancestors are lost.

Invocation:

CALL NDG_REMOVEPROV( IPROV, NANC, IANC, STATUS )

Arguments:

IPROV = INTEGER (Given)

An identifier for a structure holding the provenance information read from an NDF, as returned by NDG_READPROV.

NANC = INTEGER (Given)

The length of the ANC array.

ANC( $*$ ) = INTEGER (Given)

An array holding the indices of the ancestor NDFs to be removed. Each supplied value must be at least 1, and must be no more than the number of ancestors in the provenance extension (as returned by NDG_COUNTPROV). An error is reported otherwise. The supplied list is sorted into decreasing order before use so that the highest index ancestor is removed first.

STATUS = INTEGER (Given and Returned)

The global status.