Configuring Table ini File Parameters

Table ini file parameters allow you to configure tables, which include multiple parameters (columns) and row entries (indices). The table ini file parameter is composed of the following elements:

■

Table title: The name of the table in square brackets, e.g., [MY_TABLE_NAME].

■

Format line: Specifies the columns of the table (by their string names) that are to be configured.

●

The first word of the Format line must be "FORMAT", followed by the Index field name and then an equal "=" sign. After the equal sign, the names of the columns are listed.

●

Columns must be separated by a comma ",".

●

The Format line must only include columns that can be modified (i.e., parameters that are not specified as read-only). An exception is Index fields, which are mandatory.

●

The Format line must end with a semicolon ";".

■

Data line(s): Contain the actual values of the columns (parameters). The values are interpreted according to the Format line.

●

The first word of the Data line must be the table’s string name followed by the Index field.

●

Columns must be separated by a comma ",".

●

A Data line must end with a semicolon ";".

■

End-of-Table Mark: Indicates the end of the table. The same string used for the table’s title, preceded by a backslash "\", e.g., [\MY_TABLE_NAME].

The following displays an example of the structure of a table ini file parameter:

[Table_Title]
; This is the title of the table.
FORMAT Index = Column_Name1, Column_Name2, Column_Name3;
; This is the format line.
Index 0 = value1, value2, value3;
Index 1 = value1, value 2, value3;
; These are the data lines.
[\Table_Title]
; This is the end-of-the-table-mark.

■

The table ini file parameter formatting rules are listed below:

■

Indices (in both the Format and the Data lines) must appear in the same order. The Index field must never be omitted.

■

The Format line can include a subset of the configurable fields in a table. In this case, all other fields are assigned with the pre-defined default values for each configured line.

■

The order of the fields in the Format line isn’t significant (as opposed to the Index fields). The fields in the Data lines are interpreted according to the order specified in the Format line.

■

The order of the Data lines is insignificant.

■

Data lines must match the Format line, i.e., it must contain exactly the same number of Indices and Data fields and must be in exactly the same order.

■

A row in a table is identified by its table name and Index field. Each such row may appear only once in the ini file.

■

Table dependencies: Certain tables may depend on other tables. For example, one table may include a field that specifies an entry in another table. This method is used to specify additional attributes of an entity, or to specify that a given entity is part of a larger entity. The tables must appear in the order of their dependency (i.e., if Table X is referred to by Table Y, Table X must appear in the ini file before Table Y).

The table below displays an example of a table ini file parameter:

[ SNMPUsers ]
FORMAT Index = Username, AuthProtocol, PrivProtocol, AuthKey, PrivKey, Group;
SNMPUsers 0 = "John", 0, 0, "$1$rIE=", "$1$rIE=", 1;
SNMPUsers 1 = "Sue", 0, 0, "$1$rIE=", "$1$rIE=", 1;
[ \SNMPUsers ]