AIF_ANTMP - Annul a locator to a temporary object, thereby erasing the object

Description:

The routine annuls a locator to a temporary object created by AIF_TEMP, thereby causing the associated object to be erased and the file space associated with it to be released. If data are mapped to the object via HDS, then they are first unmapped.

Invocation:

CALL AIF_ANTMP( LOC, STATUS )

Arguments:

LOC = CHARACTER $*$ ( $*$ ) (Given and Returned)

HDS locator to the temporary object to be annulled. The character variable supplied is reset to a blank string by this routine.

STATUS = INTEGER (Given and Returned)

The global status.

Notes:

• This routine attempts to execute even if STATUS is set on entry. However, no additional error report is made if it subsequently fails under these circumstances.