User`s manual

H.323 User's Manual 11. Advanced System Capabilities
Version 5.0 305 December 2006
11.5.5 Using the ini File to Configure Parameter Tables
You can use the ini file to add / modify parameter tables. When using tables, Read-Only
parameters are not loaded, as they cause an error when trying to reload the loaded file.
Therefore, Read-Only parameters mustn’t be included in tables in the ini file.
Consequently, tables are loaded with all parameters having at least one of the following
permissions: Write, Create or Maintenance Write.
Parameter tables (in an uploaded ini file) are grouped according to the applications they
configure (e.g., NFS, IPSec). When loading an ini file to the gateway, the recommended
policy is 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 ini file includes a Format line that defines the columns of the table to be modified (this
may vary from ini file to ini file for the same table). The Format line must only include
columns that can be modified (parameters that are not specified as Read-Only).
An exception is Index-fields that are always mandatory. In the example provided in Table
11-1, all fields except for the ‘Time Connected’ field are loaded.
11.5.5.1 Structure of Parameter Tables in the ini File
Tables are composed of four elements:
 The title of the table: The name of the table in square brackets (e.g.,
[MY_TABLE_NAME]).
 A 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 names of
the Indices fields, and an equal sign '='. After the equal sign the names of the
columns are listed.
• Items must be separated by a comma ','.
• The Format line must end with a semicolon ';'.
 Data line(s): Contain the actual values of the 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 fields.
• Items 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]).
Figure 11-4 displays an example of the structure of a parameter table in the ini file.
Figure 11-4: Structure of a Parameter Table in the ini File
; Table: Items Table.
; Fields: Item_Name, Item_Serial_Number, Item_Color, Item_weight.
; NOTE: Item_Color is not specified. It will be given default value.
[Items_Table]
; Fields declaration
Format Item_Index = Item_Name, Item_Serial_Number, Item_weight;
Items_Table 0 = Computer, 678678, 6;
Items_Table 6 = Computer-screen, 127979, 9;
Items_Table 2 = Computer-pad, 111111, $$;
[\Items_Table]