Cancel the association between a locator and an object. Any primitive value currently mapped to the locator is automatically unmapped. If the last primary locator associated with a container file is annulled, then the container file will be closed.

CALL DAT_ANNUL( LOC, STATUS )

LOC = CHARACTER $\ast$ ( DAT__SZLOC ) (Given and Returned)

STATUS = INTEGER (Given and Returned)

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. 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.