Cancel the association between a locator
object. Any primitive value currently mapped to the locator is automatically unmapped. If the last
locator associated with a container file is annulled, then the container file will be
CALL DAT_ANNUL( LOC, STATUS )
LOC = CHARACTER
DAT__SZLOC ) (Given and Returned)
Object locator. A value of DAT__NOLOC is returned.
STATUS = INTEGER (Given and Returned)
The global status.
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. In particular, it will fail if the locator
supplied is not valid, but this will only be reported if status is set to SAI__OK on entry.
Copyright © 2019 East Asian Observatory