Processing math: 100%

ndgModifyProv

Modify the information stored for a particular ancestor

Description:

This function modifies the information stored for a given ancestor in the supplied provenance structure. The new values to store are supplied in an Ast KeyMap such as returned by ndgGetProv.

Invocation

void ndgModifyProv( NdgProvenance prov, int ianc, AstKeyMap km, int status )

Arguments

prov
An identifier for a structure holding the provenance information as returned by ndgReadProv or ndgReadVotProv.
ianc
The index of the ancestor NDF for which information should be modified. A value of zero will result in information being modified for the NDF from which the the supplied provenance structure was read. Otherwise, the "ianc" value is used as an index into the ANCESTORS array. An error is reported if "ianc" is too large.
km
A pointer to an AST KeyMap containing the values to store. Entries with the following keys are recognised:
  • "PATH": A string holding the path of the ancestor NDF.

  • "DATE": A string holding the formatted UTC date and time at which the provenance information for the ancestor NDF was recorded.

  • "CREATOR": A string identifying the software that created the ancestor NDF.

  • "MORE": A KeyMap containing extra information to store with the ancestor.

If the "DATE", "CREATOR" or "MORE" components are missing then corresponding item of information will be deleted from the provenance extension. An error is reported if the supplied KeyMap has no "PATH" entry. Note, the PARENTS list and HISTORY information stored with the specified ancestor cannot be modified (any "PARENTS" or "HISTORY" component in the supplied HDS structure will be ignored).

status
The global status.