*************************************
*   NuMega TrueTime Java Edition    *
*          Beta 3 Release           *
*************************************


Thank You! 
What's New? 
Contacting NuMega Lab Technical Support 
Installing TrueTime 
Hardware and Software Requirements 
Before Installing 
Installing 
Removing an Installation 
TrueTime Online Help 
Getting Started 
What is TrueTime? 
What Does TrueTime Profile? 
What Makes TrueTime Different? 
What Happens When You Instrument and Run Your Application 
Up and Running in 10 Seconds 
Frequently Asked Questions about Advanced Features 
FYI 
Known Anomalies 



Thank You!
----------
Thank you for purchasing TrueTime, the newest tool in NuMega's 
line of award winning development tools. TrueTime is a performance evaluation 
tool that collects data about your application. You can use 
this data to pinpoint performance problems and increase the efficiency of 
your code. We look forward to your constructive feedback.



What's New? 
----------- 
We have added or fixed the following items since Beta 2. 

* The Address column has been added to the Function List tab. 

* TrueTime now shows performance data for initialization of instance variables 
  in the presence of user provided constructors. 

* TrueTime can now groups classes by package in the Filter pane. This feature 
  is only available for session files created with the Beta 3 release or later. 



Contacting NuMega Lab Technical Support
---------------------------------------

For Technical Issues
====================
NuMega Lab Technical Support can assist you with all your technical problems, 
from installation to troubleshooting. 

Before contacting technical support, please read the relevant sections of 
the documentation and the Readme files.

You can contact Technical Support by e-mail. Include your serial number 
and send as many details as possible to ttJava@numega.com

Before contacting Technical Support, please obtain and record the following 
information:
* Product name (or edition), version, or service pack
* Product serial number
* Your system configuration: operating system, network configuration, amount 
  of RAM, environment variables, and paths
* The details of the problem; settings, error messages, stack dumps, and the 
  contents of any diagnostic windows
* If the problem is repeatable, the details of how to create the problem
* The name and version of your compiler and linker and the options you used 
  in compiling and linking



Installing TrueTime

Hardware and Software Requirements
----------------------------------
It is a good idea to backup your system before you install the product. The 
following items are required to install and run TrueTime.
* PC-compatible Intel Pentium system or above
* Microsoft Windows NT 4.0, Microsoft Windows 95, or Microsoft Windows 98 
  (Release Candidate). If you are installing on Windows NT 4.0, you must have 
  administrative privileges on the machine.
* RAM: 32 MB minimum 
* Disk: 10 MB for full installation
* Microsoft Virtual Machine (VM) Version 4.79.0 build 2339 or later 


Before Installing
-----------------
* Uninstall any previous versions of TrueTime that are on your system before 
  you install this release.


Installing
----------
1 Close all open programs. 
2 Insert the TrueTime CD into your CD-ROM drive. If you have CD auto-run enabled, 
  the installation starts automatically. If you have CD auto-run disabled, open 
  Explorer, and navigate to the root drive of your CD-ROM and double click on 
  SETUP.EXE.
3 Follow the prompts to install TrueTime.  

NOTE: If you install multiple versions of TrueTime (VB, VC, Java), 
      you must install them in the same directory. 


Removing an Installation
------------------------
To remove TrueTime, use the Add/Remove Programs applet in Control Panel. Remove 
TrueTime performs the following actions.
* Deletes TrueTime files from the TrueTime installation directory and 
  sub-directories
* Removes TrueTime registry entries
* Deletes the TrueTime program folder and items



TrueTime Online Help 
==================== 
The TrueTime Visual Java Edition Online Help is largely complete, with the 
exception of the tutorial. Before contacting support, check the online help 
for information. 



Getting Started

What is TrueTime?
-----------------
TrueTime is a performance analysis tool that collects and displays performance 
data for application sessions. The performance data includes information about 
images, source files, and lines of source code. You can use this data to 
identify performance problems and examine relationships among functions. 


What Does TrueTime Profile?
---------------------------
In addition to gathering session data about your source code, TrueTime gathers 
data about calls made to external components. For example, if your application 
calls a system or third-party DLL, TrueTime can gather performance information 
about the functions that your application calls in the DLL. TrueTime also gathers 
session data for ActiveX functions, even if you do not have the source code.


What Makes TrueTime Different?
------------------------------
When you instrument and run your application with TrueTime, you can configure 
TrueTime to use Quantum technology. Quantum technology distinguishes 
between time spent in threads of your application and time spent in threads of 
other running applications. Session data collected with Quantum technology 
enabled contains time measurements only for time spent in threads of your 
application. This helps TrueTime generate accurate, reproducible results that 
are independent of outside influences.


What Happens When You Instrument and Run Your Application
---------------------------------------------------------
Anytime you use TrueTime to run a Java application or applet compiled with 
Full Debug Information (/g), TrueTime gathers performance data. TrueTime is 
called when your Java application or applet calls to Microsoft Virtual Machine 
(VM). TrueTime instruments by returning a new copy of your byte code to the VM 
that contains instructions that TrueTime uses to collect performance data in 
the background while your application is running. The VM runs this byte code 
in place of your original byte code. TrueTime does not save the instrumented 
byte code; it caches it and removes it when you close your application.

TrueTime uses Quantum technology to remove time spent in other threads from the 
resulting data.





Up and Running in 10 Seconds
----------------------------
1. Start TrueTime.
2. On the File menu, select Open. 
3. Select the class file that contains the main entry point for the application 
   or the HTML file that runs the applet and click Open.
4. On the Program menu, select Start.
   TrueTime instruments your application or applet runs it with JVIEW. When 
   you close your application, TrueTime displays a session file that contains  
   the performance information for that session. 
5  On the File menu, select Save to save this session file as part of the 
   active project. You can use various session files to compare different 
   performance scenarios. 

See the TrueTime Online Help System more information on using TrueTime, including 
information about the command line interface (NMJVIEW).





Frequently Asked Questions about Advanced Features
--------------------------------------------------
Q. What is the [Program Start] entry in the Function Details and Function List tab? 
A. This entry represents the beginning of the program. All functions listed as 
children of a Program Start were called during program initialization. 

Q. What are the [Thread Start - thread ID] entries in the Function Details and 
   Function List tab? 
A. These entries represent the beginning of a thread. All functions listed as 
children of a Thread Start were called during thread initialization. 

Q. What are the hexadecimal address entries in the Function Details and 
   Function List tab? 
A. These entries represent functions for which TrueTime cannot find enough symbol 
information to identify the functions.

Q. What are the #number[image name] entries in the Function Details and 
   Function List tab?
A. These entries represent unnamed functions exported from DLLs as ordinal values.

Q. Can I run TrueTime Java edition with any Java virtual machine (VM)? 
A. No. You must use the Microsoft VM with TrueTime.

Q. How can I get performance data on my ActiveX controls that are used in Internet 
   Explorer or another client application?
A. There are two ways to get the performance data after you have instrumented your 
control. The first is to run Internet Explorer, or your client application, 
and start using it so that your control gets loaded. When your control is loaded, 
TrueTime displays an icon in your task bar and collects performance data. Or, you 
can instrument your application and select the Program menu Settings option in 
TrueTime. In the Program Info tab, enter the name of the application you want to 
run in Executable for Session. 
   NOTE: If you use Internet Explorer 4.0 with the Active Desktop feature 
   enabled, you must specify the -new option when you start Internet Explorer. 



FYI 
--- 
* You must compile your application or applet with the Full Debug Information (-g) 
  option so that TrueTime can collect data for the Source tab. 

* For applets, you can open the HTML file that runs the applet or class file that 
  contains the main entry point. If you open the class file for the applet, you 
  must specify the Execute AppletViewer (/a) option in TrueTime Settings (on the 
  Program menu, select Settings). 

* TrueTime requires the Microsoft Virtual Machine (VM) Version 4.79.0 build 2339 
  or later. 

* TrueTime runs with the Microsoft Visual J++ 6.0 Technology Preview release. 

* When you quit a Java application or applet that loads an instrumented OCX or 
  DLL developed in Visual Basic, TrueTime reports an error in the Visual Basic 
  run time as the OCX or DLL unloads. Click OK to continue and view session data. 
  This issue does not affect TrueTime's data collection. 



Known Anomalies
---------------
* On Windows NT, you must have administrative privileges to use Quantum technology.

* When you run an instrumented control in Internet Explorer 4.0 with the Active 
  Desktop feature enabled (for example, with an ActiveX .dll or .exe), you must 
  start Internet Explorer with the -new option to get performance data. 
  Use the following command. 
         iexplore.exe -new <file-name> 

* TrueTime does not instrument class initializers (static initializers). 

* When you use a constructor, TrueTime attributes time spent in the Super class 
  to the function that called Super class. 










