Product Site

5.4.25.3. collector= (Class Method)

The class attribute collector controls whether created traceObjects get collected or not. If its value is set to .nil (default) then traceObjects are not collected.

Sets the class attribute collector to the supplied object. If object is not .nil then from that moment on the new method will send newly created traceObjects using the APPEND message to the collector object.

Note

At the time of this APPEND message, the traceObject will only have the entries "NUMBER", "OPTION", and "TIMESTAMP" set. All other entries will be added to the traceObject while the current trace gets processed further, such that accessing traceObjects after the trace will have all entries set. Should there be a need for full real-time access to all entries of a traceObject, then one needs to use the NOTIFY class attribute instead.

Note

Any OrderedCollection class understands the APPEND message such that one can use e.g. the OrderedCollection classes Array or List for collecting the traceObjects.