AST_EXEMPT

Exempt an Object pointer from AST context handling

Description:

This routine exempts an Object pointer from AST context handling, as implemented by AST_BEGIN and AST_END. This means that the pointer will not be affected when AST_END is called and will remain active until the end of the program, or until explicitly annulled using AST_ANNUL.

If possible, you should avoid using this routine when writing applications. It is provided mainly for developers of other libraries, who may wish to retain references to AST Objects in internal data structures, and who therefore need to avoid the effects of AST_BEGIN and AST_END.

Invocation

CALL AST_EXEMPT( THIS, STATUS )

Arguments

THIS = INTEGER (Given)
Object pointer to be exempted from context handling.
STATUS = INTEGER (Given and Returned)
The global status.

Applicability

Object
This routine applies to all Objects.