Page History
9.147 MESSAGE_COLLECTOR
| Note |
|---|
| Note: Built-In Function Rules |
...
| Usage Options |
Nominates a function as a "message collector".
Arguments
No Argument Values.
Return Values
No Return Values
Technical Notes
This Built-In Function allows a function to nominate itself as a "message collector". This means that most messages that it causes to be subsequently issued (from functions that it calls, I/O modules it invokes, or triggers it fires) will be routed directly to it. Normally they would be routed up the invocation stack as each object involved completes execution.
This Built-In Function is a definition function. Its presence anywhere in a function causes the function to be added to the collector stack at entry, and removed at termination.
Because the MESSAGE_COLLECTOR Built-In Function is a definition function, not an executable function, you cannot make code like this work:
...
if ( ....... )
...
use MESSAGE_COLLECTOR
...
endif
This code will become a message collector regardless of the IF condition.
Normally a USE MESSAGE_COLLECTOR command would immediately follow a FUNCTION command at the beginning of the function.
This Built-In Function has been designed to be used in interactive functions and batch functions that are "sitting at the top" of a very complex and "deep" series of function calls and triggers. It is not usually required in mainstream applications.
This Built-In Function has been designed to speed up this special type of application, not to alter its processing logic or architecture in any way.
| Warning |
|---|
Warnings:
|