next up previous
Next: NDF_VALID - Determine whether an NDF identifier is valid
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_TYPE - Obtain the numeric type of an NDF array component

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.



next up previous
Next: NDF_VALID - Determine whether an NDF identifier is valid
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_TYPE - Obtain the numeric type of an NDF array component


Starlink User Note 33
R.F. Warren-Smith
11th January 2000
E-mail:rfws@star.rl.ac.uk

Copyright © 2000 Council for the Central Laboratory of the Research Councils