AudioCodes Media Pack MP-11x, Руководство пользователя

Страница: 96 / 650

User's Manual 96 Document #: LTRT-65432
MP-11x & MP-124
8.1.2 Configuring Table ini File Parameters
The table ini file parameters allow you to configure tables, which include multiple
parameters (
columns ) and row entries ( indices ). When loading an ini file to the device, it's
recommended to include only tables that belong to applications that are to be configured
(dynamic tables of other applications are empty, but static tables are not).
The table ini file parameter is composed of the following elements:

Title of the table: 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, $$, 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 double dollar sign ($$) in a Data line indicates the default value for the parameter.

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.