(Page 3 of 6 in this chapter)


4.2 AG Configuration File Structure

The active region of an AG configuration file begins with the string [AGBOARD] on a line by itself and ends with the end of the file or another word or phrase in square brackets on a line by itself. Any text outside that region is ignored.

The AG configuration statements are typically grouped into sections which determine their scope. Any statement not part of an explicit section is part of an implicit common section and applies to all boards.

Each section has as its scope a set of AG boards. Each statement within that section refers to precisely that set of boards. The board or boards in the scope of a section will also be referred to as the "current board(s)".

A section begins with a Board statement (e.g., Board n or Board All) and is terminated by any of the following:

Typically, the [AGBOARD] section begins with a common section (Board All) that pertains to all the AG boards in the system, followed by board-specific sections.

White space, such as indentation and space around the equals sign, is ignored but is useful for clarity. Case is ignored for OS/2 and Windows NT. Case is important for filenames for UnixWare, SCO, and Solaris operating systems. The pound sign (#) and semicolon (;) are both comment delimiters. agmon ignores any text that follows a comment delimiter character on the same line.

Settings of later statements override settings of earlier statements. Use this characteristic to define a default setting for all boards in the common section, then to specify a different setting for a specific board(s) later in the file.

4.2.1 Statement Syntax

This section provides detailed information about the statements that an AG configuration file may contain. An AG configuration file statement has the general syntax:

   keyword = value
The AG configuration file syntax recognizes various special words as values (shown in all upper case letters in the following AG configuration file statement descriptions). Keywords and special words are not case-sensitive.

The syntax to describe an AG configuration file statement uses brackets ([ ]) to signify that a value is optional and a vertical bar ( | ) to signify that there is a choice of more than one value.

4.2.2 Outline of an AG Configuration File

A typical format of an AG configuration file is:
[AGBOARD]

Start of active region

Board All

Interrupt = 12

End Board

Start of common section (optional)

Common statements

End of section (optional)

Board 1..2

LineCode = AMI

End Board

Start of a range-specific section

Range-specific statements

End of section (optional)

Board 0

Address = 2C0

End Board

Start of a board-specific section

Board-specific statements

End of section (optional)

Board 1

Address = 2A0

End Board

Start of a board-specific section

Board-specific statements

End of section (optional)

Board 2

Address = 280

End Board

Start of a board specific section

Board-specific statements

End of section (optional)

# EOF

end of active region




(Page 3 of 6 in this chapter)


Tech_Support@nmss.com
Copyright © 1996, Natural MicroSystems, Inc. All rights reserved.