### DAT_ANNUL

Annul locator

#### Description:

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.

#### Invocation

CALL DAT_ANNUL( LOC, STATUS )

#### Arguments

##### LOC = CHARACTER $\ast$ ( DAT__SZLOC ) (Given and Returned)
Object locator. A value of DAT__NOLOC is returned.
##### 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. 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.