Welcome
Test Execution Specialist Guide
This guide describes tasks that you can perform to test application code in HCL OneTest™ Embedded for Eclipse IDE. This guide is intended for testers or test execution specialists.
Testing with HCL OneTest™ Embedded for Eclipse IDE
Read these topics to learn how to use the product.
Application monitoring
With HCL OneTest™ Embedded for Eclipse IDE you can monitor the global variables of cyclic executive applications and apply user actions.
Prerequisites to monitoring applications
Before you can monitor a cyclic executive application, you must import your project to HCL OneTest™ Embedded for Eclipse IDE, configure HCL OneTest Embedded for Eclipse IDE and your application, and build your project.
Enabling monitoring in your application
You must enter a dedicated pragma command in the main loop of your application that is cyclically called to enable the monitoring requests between HCL OneTest™ Embedded for Eclipse IDE and the target application.

Release Notes
This document contains information about new features and enhancements for HCL OneTest™ Embedded and links to useful information about the products.
System Requirements
This document includes information about hardware and software requirements for HCL OneTest™ Embedded.
Getting Started Guide
This guide provides an overview of HCL® OneTest™ Embedded. You can find the information to get you started with HCL OneTest Embedded. This guide is intended for new users.
Administrator Guide
This guide describes how to install the HCL® OneTest™ Embedded software.
Test Execution Specialist Guide
This guide describes tasks that you can perform to test application code in HCL OneTest™ Embedded for Eclipse IDE. This guide is intended for testers or test execution specialists.
- Testing with HCL OneTest™ Embedded for Eclipse IDE
  Read these topics to learn how to use the product.
  - Getting started with HCL OneTest™ Embedded for Eclipse IDE
    HCL OneTest™ Embedded for Eclipse IDE is designed to integrate into your existing Eclipse-based tool chain. Use this section as a guide to a typical workflow for testing and evaluating your C source code in the Eclipse CDT environment.
  - Importing C projects
    You can either create a new C project with the Eclipse CDT tools or you can import your existing C source files or Eclipse projects into your HCL OneTest™ Embedded workspace.
  - Importing HCL OneTest™ Embedded examples
    HCL OneTest™ Embedded is provided with several sample projects to help you get started.
  - Analyzing source code
  - Coupling Analysis overview
    Coupling Analysis consists of Control Coupling and Data Coupling.
  - Application Profiling
    Application Profiling is gathering the main features that provide profiling information at the application level: the Worst Stack Size feature and the Worst performance (coming soon) feature.
  - Testing software components
  - Application monitoring
    With HCL OneTest™ Embedded for Eclipse IDE you can monitor the global variables of cyclic executive applications and apply user actions.
    - Prerequisites to monitoring applications
      Before you can monitor a cyclic executive application, you must import your project to HCL OneTest™ Embedded for Eclipse IDE, configure HCL OneTest Embedded for Eclipse IDE and your application, and build your project.
      - Importing a monitoring project example
        A sample project is provided with HCL OneTest™ Embedded to help you get started with monitoring.
      - Enabling monitoring in your application
        You must enter a dedicated pragma command in the main loop of your application that is cyclically called to enable the monitoring requests between HCL OneTest™ Embedded for Eclipse IDE and the target application.
      - Configuring the build and the monitoring settings
        To monitor your cyclic executive application with HCL OneTest™ Embedded, you must enable the compilation and monitoring build settings and configure some parameters related to the communication and libraries that are used to monitor your application.
      - Building a project for monitoring
        After you configure HCL OneTest™ Embedded for Eclipse IDE and your application, you must clean and build your project to instrument the source code of the application with the new configuration settings.
    - Recording a monitoring script
      With HCL OneTest™ Embedded for Eclipse IDE, you can monitor a cyclic executive application that is running on a target computer and connected to HCL OneTest Embedded for Eclipse IDE. You can apply user actions while you monitor the application and see the results in a dynamic graph.
    - Modifying the recorded data in a monitoring script
      You can modify the user actions and the input values that are recorded in a monitoring script and that persist as the default values in the script. When you run the updated monitoring script, the new input values and user actions are used as reference data to monitor the application.
    - Monitoring script files: Edits and updates
      When you monitor an application in HCL OneTest™ Embedded, multiple files are created. You can find important information about each file, its use, its format and the parameters that you can use to update the editable files.
    - Test automation commands for running monitoring scripts and creating reports
      You can run automatic monitoring scripts with commands by using a .jar file that contains libraries. You must set several parameters to run a monitoring script and generate a report.
    - HTML monitoring reports
      When you run a monitoring script while running your application, all events are recorded in an HTML report, which automatically opens when the script is complete. The .HTML report file is saved in the Project Explorer view.
- Testing with Studio
Test Manager Guide
This guide applies only to HCL OneTest™ Embedded for Eclipse IDE.
Troubleshooting
This guide describes how to analyze and resolve some of the common problems that you might encounter while you work with HCL OneTest™ Embedded.
Reference Guide
This guide describes the additional topics to gain more knowledge about HCL® OneTest™ Embedded.
All Guides (PDF)
You can find the link to view or download the content of the release notes, system requirements, getting started tutorial and persona guides of HCL® OneTest™ Embedded as a PDF file.
Notices
This document provides information about copyright, trademarks, terms and conditions for the product documentation.

Enabling monitoring in your application

You must enter a dedicated pragma command in the main loop of your application that is cyclically called to enable the monitoring requests between HCL OneTest™ Embedded for Eclipse IDE and the target application.

About this task

In the identified cyclic function of your application, enter the following line at the appropriate location:

#pragma attol mnt_insert mnt_exec_request();

This function can have the following characteristics:

Called in a timer interrupt
Located in the main loop of your application
Any regularly called function in your application

The call frequency of this function becomes the basis frequency used to refresh the cyclic data in the monitor view.