ACATS 3.1 User's Guide
Title Page
Contents   Index   References   Previous   Next 

4.3.2 Modern Naming

The name of a modern ACATS test is composed of seven or eight characters. Foundation code has a name composed of seven characters. The use of each character position is described below. The first column indicates the character position(s) starting from the left, and the second column indicates the kind of character allowed, and the third column gives the corresponding meaning:
PositionKindMeaning
1LetterTest class; foundations are marked 'F'
2AlphanumericIf other than an 'x', the section of the Ada Standard describing the feature under test. An 'x' indicates that the test includes one or more features from an annex of the Ada Standard
3AlphanumericCore clause or annex letter identifier (either core or Specialized Needs Annex); clauses are a hexadecimal value
4AlphanumericSub-clause (if a core test), or clause (if an annex test); a number if less than 10, otherwise a letter with 10='A', 11='B', and so on
5AlphanumericFoundation identifier (alphabetic, unless no foundation is required, in which case a '0')
6-7DecimalSequence number of this test in a series of tests for the same clause; foundation code will have "00".
8Alphanumericoptional – Compilation sequence identifier — indicates the suggested or required compilation order of multiple files that make up a single test (0 is compiled first). This position is used only if the test comprises multiple files.
The convention is illustrated below.
Modern File Name Convention
Modern File Name Convention
The file name extension is a one or two character file name extension. There are six extensions:
.a
A file that contains only Ada code (except for configuration pragmas in the case of some Specialized Needs Annex tests). It does not require any processing to prepare it for compilation (unless configuration pragmas must be handled separately). It is normally submitted directly to the implementation for determination of test results.
.am
A file that contains the main subprogram for a multi-file test. Generally, this extension is used for only one file of a test. In rare cases (some Annex E tests), a multi-file test may have more than one file containing a "main" subprogram; in such cases, the correct testing procedure is described in the Special Requirements section of the test prologue.
.au
A file that contains only Ada code that contains characters outside of the 7-bit ASCII character set. These files are provided in UTF-8 format with a starting byte-order mark. For ACATS 3.1, these tests can be converted to another format acceptable to the compiler if necessary; then the test must be compiled and run as all other tests of its test class. (Note that [Ada2012] requires compilers to be able to process UTF-8 files, so future ACATS versions will eliminate this permission to convert UTF-8 source code.)
.ftn
A file that contains Fortran language code and must be compiled by a Fortran compiler. These files are used by tests that check a foreign language interface to Fortran.
.c
A file that contains C language code and must be compiled by a C compiler. These files are used by tests that check a foreign language interface to C.
.cbl
A file that contains Cobol language code and must be compiled by a Cobol compiler. These files are used by tests that check a foreign language interface to Cobol. 
A test that depends on foundation code has an alphabetic character in the fifth position of its name. The required foundation will have the same characters in the second through fifth positions of its name. For example, C123Axx depends on F123A00.

Contents   Index   References   Previous   Next