System Testing Report Generator - atsmerge

Syntax

atsmerge <file> {[, <file> ]} [<options>]

where:

  1. <file> lists the .rio intermediate result files generated during the virtual tester execution phase and the .tdc correspondence table files generated during compilation.

    <options> is a list of options described below.

Description

The system generates a .rod result file for each .rio file, which is saved in the rio directory. The .rod filename uses the .rio filename with a .rod extension.

If one of the files cannot be found, the Report Generator produces a fatal error. The Report Generator does not support spaces in a filename.

The Report Generator produces a warning message each time it encounters any incorrect data.

If the report contains any synchronization errors between the .tdc and the .rio file, the Report Generator produces a fatal error.

Options

The options can be in any order. They may be upper or lower case and written in an incomplete form, provided the selected option is clear.

-TIME

This option enables you to merge reports that do not contain structure instructions. Structural instructions are beginning and ending block instructions (scenario, initialization, exception, termination).

If the .rio and .tdc files come from different test scripts, the -TIME option is enabled.

-RDD = <RDD report filename>

This option enables you to specify the output report filename.

By default, the report is names atsrdd.rdd and generated in the current directory.

-RA [=ERR | =TEST]

This option specifies the form of the report generated.

With -RA = TEST, only variables that are in a failed test are displayed.

With -RA = ERR, no variables are displayed.

In both cases, if the test is correct, only general information on this test is displayed.

The default option is -RA (with no parameters), which provides a full report of all variables for each test.

-VA =EVAL | NOEVAL | COMBINE

This option lets you specify the way in which initial and expected values of each variable is displayed in the test report.

  1. With -VA = EVAL, the initial, expected value of each variable evaluated during execution is displayed in the report. This option is only visible for variables whose initialization or expected value is not reduced in the test script.

Note: For structures in which one of the fields is an array, this evaluation is not given for the initial values. For expected values, it is only given for incorrect elements.

  1. With -VA = NOEVAL, for each variable, the report generator displays in the test report the initial and expected values described in the test script.

    Use -VA = COMBINE to combines the previous two options, that is, for each variable, the report generator displays in the test report the initial and expected values described in the test script as well as the initial and expected values evaluated during execution.

By default -VA = EVAL is used.

-SUMMARY | NOSUMMARY

This option produces a summary of the test execution in the test report.

This option gives a quick overview of the execution of the set of test scenarios. It only summarizes the execution of the test scenarios.

The default option is -NOSUMMARY.

-COMMENT | -NOCOMMENT

In the System Testing Language, the COMMENT keyword displays a comment in the test report. You can use -NOCOMMENT to disable these comments, and -COMMENT to make them visible.

By default comments are displayed.

 

-STUDIO_LOG

This option is for internal usage only.

Log File

-LOG | -NOLOG

With the -LOG option, errors found during analysis of .rio and .tdc files are displayed on screen. Use the -NOLOG option to disable this behavior.

By default the -LOG option is used.

Example

atsmerge fic01.rio fic02.rio fic01.tdc fic02.tdc ...

Return Codes

After execution, the program exits with the following return codes:

 

Code

Description

0

End of execution with no errors

3

End of execution with one or more warning messages

5

End of execution with one or more errors

7

End of execution because of fatal error

9

End of execution because of internal error

 

All messages are sent to the standard error output device.