Logger and Appender Object Language Reference |
Specifies whether to pass a log event only to the appender that
is associated with the logger or to the appenders in the logger's hierarchy.
Applies to: |
logger object
|
object.ADDITIVITY = "TRUE" | "FALSE";
|
- object
-
specifies the name of the logger object.
- "TRUE" | "FALSE"
-
determines whether a log event is processed by the appenders
that exist in the specified logger's hierarchy.
By default, each log event is passed to the appenders that are associated
with the logger and to the appenders that are associated with the logger's
hierarchy. This is the meaning of the term appender additivity.
For example, assume that you have a logger, CONSOLE. The output of a
log event of logger CONSOLE goes to all of the appenders that are in CONSOLE
and its ancestors. However, if an ancestor of logger CONSOLE, say FILE, has
the additivity flag set to FALSE, then CONSOLE's output is directed to all
of the appenders that are in CONSOLE and its ancestors up to and including
FILE, but not to the appenders that are in any of the ancestors of FILE.
Note: You can also specify the logger additivity in the logger's constructor
by using the DECLARE statement. For more information, see DECLARE Statement, Logger Object. ![[cautionend]](../../../../common/63294/HTML/default/images/cautend.gif)
The following code sets the additivity attribute to FALSE.
data _null_;
if _n_ = 1 then do;
declare logger logobj("mylog");
end;
logobj.additivity="false";
run;
Alternatively, you can set the additivity attribute in the DECLARE statement.
data _null_;
if _n_ = 1 then do;
declare logger logobj("mylog", additivity:"false");
end;
run;
Copyright © 2010 by SAS Institute Inc., Cary, NC, USA. All rights reserved.