CVG_WPROV

Writes general provenance records to the current FITS header

Description:

This creates headers in the current FITS header that record the supplied provenance information.

The tabulated indexed headers below, all with string values, are written for each ancestor NDF. The keyword index n is the provenance identifier for each NDF, starting at 0 corresponding to the current NDF. All have value <unknown > if the information could not be found, except for MORE information; the PRVMn header is omitted if there is no MORE information to record.

Keyword Comment

where <nth > is the appropriate ordinal string, e.g. 1st, 2nd, 3rd, 4th.

The above headers are prefaced by a blank header and a title " Provenance:" comment. There is a blank header between each set for improved legibility.

Invocation

CALL CVG_WPROV( IPROV, FUNIT, STATUS )

Arguments

IPROV = INTEGER (Given)
The identifier of the PROVENANCE that is to be written to the FITS headers. If NDG__NULL is supplied, this function returns without action.
FUNIT = INTEGER (Given)
The logical unit number of the output FITS file.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:

Prior Requirements

The FITS file must already be open. The current HDU in the FITS file should be the primary and the standard headers should have been written.