RIO_ANNUL - Annul a file descriptor and close the file

Description:

This routine closes the file associated with the file descriptor FD, resets the file descriptor and removes the association with the ADAM parameter. It does not cancel the ADAM parameter though. This allows the value of the ADAM parameter to be reused.

Invocation:

CALL RIO_ANNUL( FD, STATUS )

Arguments:

FD = INTEGER (Given)

The file descriptor

STATUS = INTEGER (Given and Returned)

The global status.

Notes:

• If STATUS is not SAI__OK on input, then the routine will still attempt to execute, but will return with STATUS set to the import value.