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)