1 xacli, 1 accessing xacli, 2 root commands – TANDBERG MPS API Interface D13639 User Manual

Page 20: 3 addressing

Advertising
background image

TANDBERG MPS API

User Guide

18

2.1 XACLI

2.1.1 Accessing XACLI

XACLI can be accessed through Telnet via the LAN interface or through RS-232 by connecting
a serial cable to the serial interface connector, referred to as the Dataport.
48 Telnet sessions can be active at the same time in addition to the RS-232 connection.

2.1.2 Root commands

For each of the XML documents supported by the system, there is a corresponding XACLI root
command. The root command has the same name as the corresponding XML document,
except that the root command is prefixed by an “x”:

XML document

XACLI root command

status.xml xstatus
history.xml xhistory
configuration.xml xconfiguration
directory.xml xdirectory
command.xml xcommand

The information in the TANDBERG XML engine is divided into three main types: Status
Information, Configuration Information
and Command Information, ref. the documentation of the
TANDBERG XML API.

As there is a fundamental difference in these three main types of information, there is also three
different ways of working with the information using XACLI.

2.1.3 Addressing

XACLI supports XPath for addressing Status Information and Configuration Information.
In addition there is support for the proprietary TANDBERG SimplePath notation. With
SimplePath notation an element or a group of elements are addressed by supplying a space
separated list of element names (elemName) and optional element instance numbers (item):

<elemName> [item] <elemName> [item] ...

If the instance number of a given element is omitted, the expression addresses all instances of
this element


Example 2.1

To address the BaudRate sub-element of SerialPort 2:

XPath:

SerialPort[2]/BaudRate

SimplePath:

SerialPort 2 BaudRate



To address the BaudRate sub-element of all SerialPort elements:

XPath:

SerialPort/BaudRate

SimplePath:

SerialPort BaudRate

Advertising