The routine annuls the array identifier supplied so that it is no longer recognised as a valid identifier by the ARY_ routines. Any resources associated with it are released and made available for re-use. If the array is mapped for access, then it is automatically unmapped by this routine.

CALL ARY_ANNUL( IARY, STATUS )

IARY = INTEGER (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 identifier supplied is not initially valid, but this will only be reported if STATUS is set to SAI__OK on entry.

• An error will result if an attempt is made to annul the last remaining identifier associated with an array which is in an undefined state (unless it is a temporary array, in which case it will be deleted at this point).