Dictionary

The dictionary file contains a list of dictionary translations that the Mobile AAA server will use to parse incoming requests and to generate outgoing responses. All transactions are composed of attribute-value pairs. For more information about A-V pairs, see Chapter 10 Attribute-Values.




	IMPORTANT: Configuration files have a maximum input line length of 255 characters. No checking is done to insure that a configuration statement has not exceeded this limit. In addition, all configuration files must end with a new line.

You can track different versions of the dictionary file by adding the following line to the file:

%DICTID Version-String

Version-String: The version information, this string will appear in diamstatus output.

Attribute Entries

Syntax

ATTRIBUTE Attribute-name Integer-encoding Type # comment




	NOTE: Vendor-specific attribute identifier strings are defined in the vendors file and may be used in place of the default string ATTRIBUTE.

Attribute-name

Unique name of an attribute.

Integer-encoding

The actual attribute number code used in the A-V pair data format.

Type

One of the following data types for the attribute:

ipaddr: 4 octets in network byte order
integer32
unsigned32
integer64
unsigned64
float32
float64
octetstring
grouped
enumerated (derived from integer32)
DiameterIdentity (derived from octetstring)
time (derived from unsigned32)
UTF8String (derived from octetstring)
IPFilterRule (derived from octetstring)
QosFilterRule (derived from octetstring)

# comment

Any string that provides a note or other information may follow the # character.

Value Entries

Syntax

VALUE Attribute-name Value-name Integer-encoding # comment




	NOTE: Vendor-specific value identifier strings are defined in the vendors file and may be used in place of the default string VALUE.

Attribute-name: Name of the attribute that this value is associated with.
Value-name: Name of the value.
Integer-encoding: Actual value code used in the A-V pair data format.
# comment: Any string that provides a note or other information may follow the # character.

Member Entries

Syntax

MEMBER Group-name {Member-name|Other-AVPs} {Min-Max|Min-|Exact} FIXED # comment

Group-name

Name of the grouped attribute that this member belongs to.

Member-name

Name of the member.

The keyword Other-AVPs may be used for a member entry to indicate that any A-V pair not explicitly associated with Group-name can still appear in Group-name as an optional member. When the Other-AVPs keyword is used, the {Min-Max|Min-|Exact} and FIXED options cannot be specified.

{Min-Max|Min-|Exact}: Limit to the number of instances that this member may appear in Group-name when a Diameter message includes Group-name. You may specify a minimum/maximum range (Min-Max), a minimum number (Min-), or specify an exact number (Exact).
FIXED: Identifies the member as fixed. It must appear with other fixed members at the beginning or end of Group-name.
# comment: Any string that provides a note or other information may follow the # character.

Grouped Attributes

In the Diameter protocol, a grouped attribute contains a sequence of member A-V pairs. The dictionary must first define group and member attributes with Attribute entries. Members entries associate members with a group attribute. These member entries must be listed in the dictionary in following order:

Any fixed A-V pairs that must appear at the beginning member sequence for a group attribute in a Diameter message to be valid
Any unordered A-V pairs that can appear in any order as long as they appear between the first and last set of fixed members
Any fixed A-V pairs that must appear at the ending member sequence for a group attribute in a Diameter message to be valid
Any A-V pairs that must not appear in a group attribute in a Diameter message (with an Exact option set to 0.)

When defining grouped A-V pairs:

An A-V pair can only be listed as a MEMBER of a group one time.
Grouped attributes can be nested (maximum nesting level of five).
A grouped attribute cannot have itself as a member.
Grouped and member A-V pair names must be unique across vendors.

Examples

The following example shows how a grouped attribute and its members are defined.

# define the individual A-V pairs
HP.Attr  Sample-Group       990  grouped
HP.Attr  Member-AVP1        991  octetstring
HP.Attr  Member-AVP1        992  octetstring
HP.Attr  Member-AVP1        993  octetstring
HP.Attr  Member-AVP1        994  octetstring
HP.Attr  Member-AVP1        995  octetstring
#specify the members of Sample-Group
MEMBER Sample-Group  Member-AVP1  1-3 FIXED # 1 to 3 instances must be present first
MEMBER Sample-Group  Member-AVP2  1-        # 1 or more must be present in any order
MEMBER Sample-Group  Member-AVP3  0-1       # 0 or 1 may be present in any order
MEMBER Sample-Group  Other-AVPs             # allow other AVPs
MEMBER Sample-Group  Member-AVP4  1  FIXED  # 1 must be present last
MEMBER Sample-Group  Member-AVP5  0         # must be excluded

Dictionary

Technical documentation

» Table of Contents

» Index

Attribute Entries

Syntax

Value Entries

Syntax

Member Entries

Syntax

Grouped Attributes

Examples