4: Configuration Using XML
Record, Group, Item, and Value Tags
A <configgroup> is a logical grouping of configuration parameters and must contain one or more <configitem> elements. It must have a name attribute and may have an instance attribute.
A <configitem> is a specific grouping of configuration parameters relevant to its parent group. An item takes the name attribute and must contain one or more value elements. For example, the line group might have parameters such as baud rate, data bits, and parity.
A value may specify the value of a configuration parameter. It may contain the name attribute. In this example, a value of 9600 might be specified for baud rate; 7 may be specified for data bits, and even may be specified for parity.
A name attribute identifies the group, item, or value. It is always quoted (as are all XML attributes). For example, a group that contains serial port parameters has the name "line".
An instance attribute identifies which of several instances is being addressed. It is always quoted. For example, the serial port name (in the line configgroup) has the instance "1" to indicate serial port 1 or "2" to specify serial port 2.
The following figures show examples of XML configuration records and the use of the <configrecord>, <configgroup>, <configitem>, and <value> XML elements.
Figure 4-3 XML Example
<configgroup name="arp"> <configitem name="arp delete">
<value name="ip address"/> </configitem>
Figure 4-4 XML Example of Multiple Named Values
<configgroup name="cp group" instance="Line1_Modem_Ctl_In"> <configitem name="cp" instance="3">
<value name="bit">0</value> <value name="type">input</value> <value name="assert low">enable</value>
</configitem>
<configitem name="state"> <value>disable</value>
</configitem>
</configgroup> <configrecord version="0.1.0.0T0">
<configgroup name="host" instance="3"> <configitem name="name">
<value/>
</configitem>
<configitem name="protocol"> <value>Telnet</value>
</configitem>
<configitem name="ssh username">
XPort® Pro Lx6 Embedded Device Server Command Reference | 16 |
