NAME¶
amsxml - CCSDS Asynchronous Message Service MIB initialization XML file
DESCRIPTION¶
The Management Information Base (MIB) for an AMS communicating entity (either
amsd or an AMS application module) must contain enough information to
enable the entity to initiate participation in AMS message exchange, such as
the network location of the configuration server and the roles and message
subjects defined for some venture.
AMS entities automatically load their MIBs from initialization files at startup.
When AMS is built with the -DNOEXPAT compiler option set, the MIB
initialization file must conform to the
amsrc syntax described in
amsrc(5); otherwise the
expat XML parsing library must be linked
into the AMS executable and the MIB initialization file must conform to the
amsxml syntax described below.
The XML statements in the MIB initialization file constitute
elements of
MIB update information, each of which may have one or more
attributes.
An element may also have sub-elements that are listed within the declaration
of the parent element, and so on.
Two types of elements are recognized in the MIB initialization file: control
elements and configuration elements. A control element establishes the update
context within which the configuration elements nested within it are
processed, while a configuration element declares values for one or more items
of AMS configuration information in the MIB.
For a discussion of the recognized control elements and configuration elements
of the MIB initialization file, see the
amsrc(5) man page.
NOTE,
though, that all elements of an XML-based MIB initialization file
must
be sub-elements of a single sub-element of the XML extension type
ams_load_mib in order for the file to be parsed successfully by expat.
EXAMPLE¶
<?xml version="1.0" standalone="yes"?>
<ams_mib_load>
<ams_mib_init continuum_nbr="2" ptsname="dgr"/>
<ams_mib_add>
<continuum nbr="1" name="apl" desc="APL"/>
<csendpoint epspec="beaumont.stepsoncats.com:2357"/>
<application name="amsdemo" />
<venture nbr="1" appname="amsdemo" authname="test">
<role nbr="2" name="shell"/>
<role nbr="3" name="log"/>
<role nbr="4" name="pitch"/>
<role nbr="5" name="catch"/>
<role nbr="6" name="benchs"/>
<role nbr="7" name="benchr"/>
<role nbr="96" name="amsd"/>
<role nbr="97" name="amsmib"/>
<role nbr="98" name="amsstop"/>
<subject nbr="1" name="text" desc="ASCII text"/>
<subject nbr="2" name="noise" desc="more ASCII text"/>
<subject nbr="3" name="bench" desc="numbered msgs"/>
<subject nbr="97" name="amsmib" desc="MIB updates"/>
<subject nbr="98" name="amsstop" desc="shutdown"/>
<unit nbr="1" name="orbiters"/>
<unit nbr="2" name="orbiters.near"/>
<unit nbr="3" name="orbiters.far"/>
<msgspace nbr="2"/>
</venture>
</ams_mib_add>
</ams_mib_load>
SEE ALSO¶
amsrc(5)