Output Resulting from Relative Severity (SAP Library

Show TOC

Output Resulting from Relative Severity

Use

Use the table below to elaborate (EffectiveSeverity).

Example

Produce Log Messages with Respect to a Location

This graphic is explained in the accompanying text

Category cat = Category.getCategory("Objects/Management");

Location loc = Location.getLocation("com.sapmarkets.xxx.a");

cat.warningT(loc, methodname, "Error registering object {0}.");

Regular: cat.setEffectiveSeverity(<severity>)	With Relative: cat.setEffectiveSeverity(loc, <severity>)	Output enabled by relative ‘loc’ cat.warningT(loc, ….)
FATAL	<…not set…>	NO
<…not set…>	INFO	YES
FATAL	INFO	YES
INFO	ERROR	YES

Produce Traces Messages with Respect to a Category

This graphic is explained in the accompanying text

Category cat = Category.getCategory("Objects/Management");

Location loc = Location.getLocation("com.sapmarkets.xxx.a");

loc.warningT(methodname, messageCode);

loc.warning(cat, methodname, messageCode);

Regular: loc.setEffectiveSeverity (<severity>)	With Relative: loc.setEffectiveSeverity (cat, <severity>)	Result, output enabled (without relative ‘cat’)? loc.warningT( ………..)	Output enabled by relative ‘cat’ loc.warning(cat, .…..)
FATAL	<…not set…>	NO	NO
<…not set…>	INFO	NO	YES
FATAL	INFO	NO	YES
INFO	ERROR	YES	YES

● When the output methods API denote a relative (or relatives), the logging framework tries to output the message simultaneously to both the log controller and its relative(s). The evaluations are independent and done separately. The outputs shown in the tables concern the log controller itself.

● Whether the output is enabled at the relative depends on the configuration set by the relative itself, which at the same time evaluates the severity with respective to the log controller. If no explicit relative severity is configured by the relative, the situation becomes similar to the conditions listed in the table below.

Regular: cat.setEffectiveSeverity (<severity>)	With Relative: cat.setEffectiveSeverity (loc, <severity>)	Output enabled for cat? cat.warningT(loc, ….)	Output enabled by relative ‘loc’ (no explicit severity setting)
FATAL	<…not set…>	NO	NO
<…not set…>	INFO	YES	NO
FATAL	INFO	YES	NO
INFO	ERROR	YES	NO

● In case the relative severity is also specified at the relative loc (assuming its own severity remains the default Severity.NONEvalue), consider the following data:

Regular: cat.setEffectiveSeverity (<severity>)	With Relative: cat.setEffectiveSeverity (loc, <severity>)	At loc: loc.setEffectiveSeverity (cat, <severity>)	Output enabled by relative ‘loc’
FATAL	<…not set…>	<…not set…>	NO
<…not set…>	INFO	INFO	YES
FATAL	INFO	WARNING	YES
INFO	ERROR	ERROR	NO