IBM Support

How to enable time measurements in a Target Deployment Port

Question & Answer


Question

What information do you need to implement in theTarget Deployment Port (TDP) of IBM Rational Test RealTime to have time measurements?

Cause

In the following cases you need to enable the clock interface in your TDP.

  • You want to perform Performance Profiling.

  • You want to have time measurements in the runtime tracing report.

Answer

Look first in the documentation for your target to discover if a clock is available. If a clock is available, discover how to access it. Then determine the clock's precision. Once you got this information, open your TDP and select the section.



  1. Click Library Settings > Clock interface. Then change RTRT_CLOCK to RTRT_USR.


  2. Specify the data type to store the value of the clock in the tab Clock Type.

    Some targets just use a long int, others use a structure with fields for seconds and microseconds.


  3. Write the code in the tab usr_clock.

    The code reads the clock on your target and storesthe code in the address. Parameter p points to the address.


  4. Write code in the tab usr_clock_init to measure the clock resolution.

  5. OPTIONAL
    Write code in that tab, if your clock returns just "ticks". Then you can convert "ticks" into seconds.


  6. Provide macros in the Unit Type tab to convert the time that usr_clock reads into a value that you can display in the reports.

    The TDP documentation explains what to put in each of these fields.


REMARKS


Leave the last two tabs Time Type\ and usr_sleep as they are. Only the SystemTesting component uses them.


Read the documentation for the "Clock Interface", provided in the TDP editor, to fully understand how you need to enter the information about the clock into the TDP.

[{"Product":{"code":"SSSHUF","label":"Rational Test RealTime"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Target Deployment Port","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.5;7.5.0.1;7.5.0.2;7.5.0.3;7.5.0.4;7.5.0.5;7.5.0.6;8.0;8.0.0.1;8.0.0.2","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21430750