This section describes the tags used in the XML file and includes a DTD file that supports the XML file.

XML

The XML file of the Diameter agent contains the following tags:

<diameter-protocol>

The XML file starts with a diameter-protocol declaration.

The name attribute is optional and specifies the diameter protocol name.

The diameter-protocol tag can contain the following tags:

• <avp>

• <command>

<avp>

The AVP tag defines an AVP.

Each AVP tag requires an ID and a name. The ID is the AVP code allocated by IANA for this AVP. The name identifies this AVP in grouped AVPs or commands. The vendor attribute is optional and sets the ID of the AVP vendor.

The AVP tag must contain the following tag.

• <flag-rules>

The AVP tag must contain one of the following tags.

• <simple-type>

• <enumeration>

• <layout>

The AVP tag may contain the following tag.

• <may-encrypt>

<flag-rules>

The flag-rules tag is required for the AVP tag and defines the AVP flags with a number of flag-rule definition tags.

<flag-rule>

The flag-rule tag defines the value for one of the valid AVP flags.

The flag-rule tag has two required attributes. The name attribute is the flag name, either mandatory or protected. The rule attribute defines the flag value and can be must, may, should_not or must_not.

<may-encrypt>

The may-encrypt tag defines if this AVP is to be encrypted or not.

<simple-type>

<simple-type> with its name attribute defines the AVP type as any of the following types:

• Unsigned32

• Unsigned64

• Signed32

• Signed64

• Float32

• Float64

• DiameterIdentity

• UTF8String

• Address

• OctetString

• Time

• DiameterURI

• IPFilterRule

<enumeration>

The enumeration tag defines AVPs of type Enumerated and can have any number of <enumerator> sub-tags.

<enumerator>

The enumerator tag defines an element in an Enumerated AVP type. It has two required attributes called name and value. For an example of the syntax see the section above, <enumeration>.

<layout>

The layout tag defines AVPs of type Grouped. A grouped AVP consists of a sequence of AVPs. It is also possible to nest grouped AVPs, that is to include a grouped AVP within a grouped AVP

<fixed>

The fixed tag defines the fixed AVPs included in a grouped AVP. For an example of the syntax see the layout syntax example in the section above, <layout>.

The fixed tag can contain the following tag.

• <avp-ref>

<required>

The required tag defines the required AVPs included in a grouped AVP. For an example of the syntax see the example, layout syntax in the section above, <layout>.

The required tag can contain the following tags.

• <avp-ref>

• <any-avp>

<optional>

The optional tag defines the optional AVPs included in a grouped AVP. For an example of the syntax see the example, layout syntax in the section above, <layout> .

The optional tag can contain the following tags.

• <avp-ref>

• <any-avp>

<avp-ref>

The avp-ref tag contains a reference to an AVP that should be included in a grouped AVP. The tag has a required attribute called name. It holds the name of the referenced AVP. The optional attributes min and max set the qualifiers for the AVP. For an example of the syntax, see the example, layout syntax, in the section above, <layout>.

<any-avp>

The any-avp tag defines that a grouped AVP in the group list can have any number of AVPs of any kind.

<command>

The command tag defines a command.

The required attribute id is the command code allocated by IANA for this command. The optional attribute application sets the command application ID.

The command tag requires one of the following tags.

• <answer>

• <request>

<answer>

This tag defines an answer command. The attribute name is required.

The answer tag can contain the following tags.

• <header-bits>

• <layout>

<header-bits>

This tag defines the header bits of a command.

The header-bits tag can contain the following tags.

• <header-bit>

<header-bit>

This tag defines a command header bit. For an example of the syntax, see the example, header-bits syntax, in the section above, <header-bits>.

The header-bit tag has two required attributes. name is the header bit name and can be request, proxiable or error. The value is the bit value (0 or 1). Any other value will cause the XML aborter to abort with an error message.

DTD

diameter.dtd supports the XML file in the section above, XML.