NDF_UNMAP - Unmap an NDF or a mapped NDF array

Description:

The routine unmaps an NDF, or a individual NDF array which has previously been mapped for READ, UPDATE or WRITE access.

Invocation:

CALL NDF_UNMAP( INDF, COMP, STATUS )

Arguments:

INDF = INTEGER (Given)

NDF identifier.

COMP = CHARACTER $*$ ( $*$ ) (Given)

Name of the NDF component to be unmapped: 'AXIS', 'DATA', 'QUALITY', 'VARIANCE' or '$*$'. The last value acts as a wild card, causing all mapped arrays to be unmapped.

STATUS = INTEGER (Given and Returned)

The global status.

Notes:

• This routine attempts to execute even if STATUS is set on entry, although no further error report will be made if it subsequently fails under these circumstances.

• A component name of 'AXIS' will act as a partial wild card, unmapping any axis arrays which are mapped, but leaving other components unchanged. The routine NDF_AUNMP may be used to unmap individual axis arrays.

• A comma-separated list of component names may also be given, in which case each component will be unmapped in turn.

• An error will be reported if a component has not previously been mapped for access, except in the case where a value of '$*$' is given for COMP, or where 'AXIS' is used to unmap axis arrays.