THIS IS THE README FILE FOR UNDERTOW IV  RELEASE REV 4.4.1
THIS IS BETA SOFTWARE!!!!


It is provided as a no charge upgrade to Veritools
customers of Undertow II and Undertow III who have
purchased maintenance.               
 

	Please send information on bugs that you have found to:
	schop@veritools.com
	Subject:Undertow bugs
	Send requests on new features to:
	the same mail address,
	Subject: Suggested New Features
	______________________________________

	December 19, 1993	

		This program and its documentation is the property
	of Veritools Inc. and is protected by copyright. All rights 
	reserved.

			Veritools Inc.
			161 San Antonio, Suite 6A	
			Los Altos, CA 94022
			(415)-941-5050
			(415)-941-5552 fax number
			E-Mail schop@veritools.com

		Welcome to Undertow IV, the fastest and most complete 
	waveform display program for viewing Verilog Value Change Files.
	Directions for installing Undertow are found below. The directions for
	running Undertow are found in the ut.man file. If you have any 
	questions while installing Undertow ask your system administrator 
	or call the above number for support.

	CONTENT OF FILES:
	_________________

	The files that you have in this directory are the following:
	
	HELP          pli_routines  ut.lpr        ut.run
	REV_HISTORY   UNdertow      ut            ut.man        vdump

	README, this file
	HELP, a directory that holds all of the online help information
	REV_HISTORY, a file that lists bug fixes at each rev level and also
		the known bugs and work arounds at this latest level.
	ut, the executable code for Undertow
	ut.run, a loader script for ut that will not allow ut to
		start unless there is sufficient memory
	ut.man, the man pages for Undertow. In order to get a hard copy
		of this on line man file issue the following command:
		%nroff -man ut.man | lpr,  where lpr is the command to your printer. 
	UNdertow, a file which holds default values for the different
		attributes of Undertow. See ut.man on how to use this file.
	vdump, a utility that builds the fast file format.
	pli_routines, the routines that you would use in order to limit
		the size of your dump files and to produce a connectivity file
		that will allow you to see the gate level detail of your design.
	ut.lpr,  a readable version of the nroff version of ut.man
	
	In addition, this distribution contains these directorys and 
	files.

HELP: This is the directory for the "Help" files.
README                       connectivity_inputs.help
alias.help                   display.help
aux.help                     fast.help
bundle.help                  open.help
bundle.help%                 print.help
choose.help                  reduce.help
connectivity.help            test_analyzer.help
connectivity_analyzer.help   text.help
connectivity_hierarchy.help  ut.help
connectivity_history.help

 pli_routines, the routines that you would use in order to limit
        the size of your dump files and to produce a connectivity file
        that will allow you to see the gate level detail of your design.

	
_________________________________NOTE__NOTE__NOTE_______________________________

NOTE: If you want to use the pli routines, then you must have in your
environment a path to utdmp, a program that works in comjunction with
$utLimitVCD, the system call that limits your dump file size. Just insert
the path where you have utdmp to the "set path =" line that you have in
your .cshrc file and then source this file.
_______________________________________________________________________________

Cadence_Verilog_XL  fintronic_finsim    utdmp
README              pli_example_files

pli_routines/Cadence_Verilog_XL:
README_PLI       README_PLI_USER  utpli.o          veriuser.c

pli_routines/fintronic_finsim:
README      qtest.v     utpli.o     veriuser.c

pli_routines/pli_example_files:
README              qtest.dump          qtest.v
qtest.connectivity  qtest.dump.fast     qtest.v~

	Note: Insert ut.man in /usr/man/man1 as ut.1 
	
	A QUICK START GUIDE FOR UNDERTOW
	________________________________

	To run Undertow with this example file, just type "ut.run".

		%   ut.run

	or 	%   ut  if you know that you have enough memory to run Undertow.


	
	If at this point a message comes up which says "feature not 
	configured" or the undertow wave display window does not come up, there
	may be a problem with the license server. Go to the license directory 
	and read the README file and the TROUBLESHOOTING_GUIDE for installing
	and starting the license manager. The first thing you should check is 
	that the license.dat for your system is either in the default path,
	/usr/local/flexlm/licenses or that the environmental variable has been
	set for the path to your license.dat file.  The next thing that 
	you should check is that the paths in the README file are consistent
	for the paths in the various files for the license manager. 


	When the Undertow "OPEN" window comes up, select a Verilog VCD file
	or Powermill, Timemill file to open.  NOTE: At any time if you
	have a question on what to do next or on the operation of the
	current window, just press the Help button that appears in the
	current window. If you want to see an explaination of all of The 
	features in Undertow select the Help button under the File Menu
	The following steps will take you through a simple example for the
	verilog.dump file which is on the Veritools' ftp site:


		Select the "Choose" button. Note, when this button is
	pushed, the Signal Selection window will appear.
		
	When the signal selection window comes up;

		Select the module name "ioboard" in the module window.

	At this point signal names will appear in the variable window for 
	the module "ioboard".

		Select several of the variables at random.

		Select the "Display" button (to bring back the wave
		display window).

	The wave display window should now appear for the selected signals.

	Now you are ready to cut and paste signals, do save and restore,
	zoom and set time cursers as defined by the various buttons on the 
	menu line as described in ut.man and by the "Help" buttons found on
	nearly every window.

