Show TOC Start of Content Area

Function documentation Hierarchical Severity Inheritance  Locate the document in its SAP Library structure

Use

Normally, there are numerous source objects in your program, and the task can become very hard if severity has to be assigned individually to each of them. Thus, you have to follow the requirements and specify proper hierarchical names when creating a location or a category. For more information, see Identifying the Output Source: Location or Category.

Features

Interfere Inheritance

Severity, assigned to the parent element, will be effective for its children and all descendants. But there is more that enables you to control the inheritance behavior. Descendants do not need to inherit the severity from the parent in the following three ways:

...

       1.      Explicit severity setting (default: Severity.NONE)

As long as severity is assigned to the child object, this works and is not affected by the severity assignment of its ascendants:

This graphic is explained in the accompanying text

static final Location loc = Location.getLocation(com.sapmarkets.foo);

      loc.setEffectiveSeverity(Severity.INFO);

 

If the parent com.sapmarkets is assigned with Severity.FATAL, this has no influence on the com.sapmarkets.foo – the latter still have a Severity.INFO assigned.

By the same token, you can easily deduce descendants (without explicit severity assignment). This will inherit the severity from the closest ascendants that are assigned an explicit effective severity.

Example

For example, using the above example, what will be the severity of com.sapmarkets.foo.child1FATAL or INFO? – All descendants of com.sapmarkets.foo will inherit severity from com.sapmarkets.foo.

       2.      Define a severity floor limit – minimum severity (default: Severity.ALL). The assigned severity must not be lower than this.

       3.      Define a severity ceiling limit – maximum severity (default: Severity.NONE). The assigned severity must not be greater than this.

You can specify the floor and ceiling thresholds individually or together. These two define the valid severity range for a source object. Therefore, by default, it does not restrict any inherited severity, because it must fall within the default minimum severity ALL and maximum severity NONE.

 

See also:

Hierarchical Severity Inheritance – Example

Hierarchical Destination Inheritance

 

End of Content Area