Components of an AOC file

Use this generic description of the structure of an AOC to help you write new AOC files and understand existing AOC files.

AOC components

The major components of the AOC and descriptions of the components are provided below.
  • Name of the active object class (active object)
  • Super class (super_class)
  • Instantiate rule (instantiate_rule)
  • Icon used in GUI to represent the device class

Name

In the active object attribute, you declare the name of the current class.

You can specify any unique text string between the double quotes. The entire AOC file is contained within the first pair of curly brackets. A semicolon follows the final bracket to terminate the AOC.

active object 'Linux'
{
        super_class = 'EndNode';
          
          instantiate_rule = "EntityOID = '1.3.6.1.4.1.2021.250.10' OR
              EntityOID = '1.3.6.1.4.1.8072.3.2.10' OR
              EntityOID = '1.3.6.1.4.1.1575.1.5'";
              
          visual_icon = 'EndNode';
};

Super class

You can configure the Super class to define the name of the AOC from which the current class inherits.

The name between the double quotes must be the name of an already-defined AOC. In the AOC hierarchy, Core is the only class that has an unassigned super_class. When editing any other class, the super_class must never be left empty.

super_class = "Core";

Instantiate rule

You code the instantiate rule as a logical test against the attributes of the entity. The most specific class that matches the test defines the class the object belongs to. The test is done by first testing the Core.aoc class and then its subclasses in turn.

If an object meets the instantiation criteria for more than one class, it automatically instantiates to the lowest leftmost class in the hierarchy. The following example shows a specification of the rule that instantiates everything by default.

instantiate_rule = "EntityOID like '.*'"; 

Visual icon

You can assign icons to device classes. These icons represent devices of that class in the network visuulization GUIs, including the Network Views and the Network Hop View.