next up previous 229
Next: Additional Features
Up: Simple use of TRANSFORM Routines
Previous: Example 5. Transforming a cursor position.


Clearing Up and Closing Down

When a compiled mapping is no longer required, the resources associated with it should be released. This is done by calling TRN_ANNUL (annul compiled mapping), thus:

CALL TRN_ANNUL( ID, STATUS )

This causes the compiled mapping to be deleted and the ID value to be reset to TRN__NOID.3Finally, before an application finishes, the statement:

CALL TRN_CLOSE( STATUS )

should be executed. Calling TRN_CLOSE will first annul any compiled mappings which are still active and will then close the TRANSFORM facility down, recovering any resources associated with it.

Both of these cleaning up routines will attempt to execute regardless of the value of their STATUS argument.



next up previous 229
Next: Additional Features
Up: Simple use of TRANSFORM Routines
Previous: Example 5. Transforming a cursor position.

TRANSFORM Coordinate Transformation Facility
Starlink User Note 61
R.F. Warren-Smith
12th January 2006
E-mail:starlink@jiscmail.ac.uk

Copyright © 2000 Council for the Central Laboratory of the Research Councils