IBM
Contents Index Previous Next



Getting Started with TTCN Access


Setting Up the TTCN Access Environment

When building applications using TTCN Access, the compiler will need to find a few files, the ITEXAccessClasses.hh include file and the libaccess.a library file. Normally these files are found in the .../itex/include/CC and .../itex/lib/CC directory respectively. The include file must be included in every TTCN Access application and the library libaccess.a must be used when linking.

Note:

For further information, contact your system administrator.

TTCN Access operates on the TTCN Suite data bases. These data bases must have passed analysis and be saved before using TTCN Access. If the data base contains a TTCN test suite that is not analyzed, the TTCN Access application can not reach into the fields of the tables. The default behavior of TTCN Access is to simply skip those fields that are not analyzed. De-referencing a particular field in an non-analyzed data base, will result in undefined behavior.

TTCN test suite data bases are managed by the AccessSuite object, which has member functions for opening and closing the TTCN Suite data bases and also for starting traversing. From an AccessSuite object it is also possible to access tables in a random manner via the symbol table manager.

Using Example Applications

TTCN Access is delivered with some simple example applications. To compile the examples, the installation directory, where the ITEXAccessClasses.hh and libaccess.a files reside, must be known to the makefiles. Do this by setting the environment variable ACCESS or by explicitly filling in the local variable ACCESS in every makefile or using make with the syntax make ACCESS=$telelogic/itex/access.

Starting an TTCN Access Application

You have to retrieve the TTCN Access license when you start the TTCN Suite. To do this, start the TTCN Suite from the command line with the switch -access.

Then you can execute TTCN Access applications from the command line or from the window manager.

You can also select Start Application in the Access menu in the Browser. This will open a dialog in which you may change settings and start the TTCN Access application.

Figure 181 : The Start Application dialog

Save selection first

Select this to save the current selection in the Browser before executing the TTCN Access application.

Switches

Switches may be passed to the chosen TTCN Access application. The switches are written as free text. As the last argument is the name of the the TTCN Suite database passed. This name is always passed to the TTCN Access application.

Note:

Observe that it is the name of the (working) database file and not the name of the test suite that is passed to the TTCN Access application.

Filter

Sets the filter for the files that will be displayed in the Suites list. There are no predefined naming conventions for TTCN Access applications.

For example the name filter *.acc will cause only those files whose names end with .acc to be displayed.

Access application

Displays the selected application.


http://www.ibm.com/rational
Contents Index Previous Next