|
|
|||
In this document you can find answers to a number of questions that first-time users of Together may encounter. You can find additional information specific to Together 2.x at http://www.togetherj.com/tj-faq.htm. Each topic in this document contains one or more keywords in [ brackets ] that relate to the subject of the question. While not comprehensive, if you use your browser's search/find function you may be able to locate information more quickly. For a complete list of all questions covered here, click the Contents link above. | ||||
|
What
product download options are available and what should I know about them?
DOWNLOAD: Together (NT/95 INSTALLER)
DOWNLOAD VMs directly from manufactures:
What should I know about Virtual Machines?If you have Together/J 1.0, Together/J 2.0, or Together 2.x you need to install a Java virtual machine (VM) or Java Development Kit (JDK). To see what VMs are currently supported, see readme.html. Here are some things you should know about specific VMs and/or JDKs: Microsoft's, IBM's, Sun Solaris', and Linux ports.Sun JDK 1.2Sun has recently released JDK 1.2 Release Candidate 2. It's still under testing. Together runs under Sun's JVM 1.2 on the following operating systems: Windows NT, Windows 95, Solaris.To successfully run, you should modify the shipped startup file (bin/Together.bat or bin/Together.sh):
Microsoft ® JVM:Microsoft ® VM for Java is distributed separately or as a part of Internet Explorer 4 or within SDK for Java. However, you need to update your version of MS JVM to version 5.00.2925. (Build 2339 is also acceptable).Normally, you can check the version of your MS VM by invoking jview in command shell:
Here's an example of console output:
http://www.microsoft.com/support/winnt/nt4sp3.asp. Some configurations created from different or improper installations may mix jview and Java itself of different builds. You can follow the more complex procedure to make sure which build of Java is actually invoked when you start any Java application, e.g. Together:
Microsoft ® JVM and Windows 98:Microsoft ® Windows 98 is distributed with Internet Explorer 4 and Java VM already built-in into the system. The version of JVM usually is greater than one used in Windows 95 or NT. So you don't need to upgrade JVM with the supplied installer.However, Together has been tested in Windows 98 with the build 2424 of JVM. Make sure that you have the appropriate build. Refer to the previous paragraph for the information on how to know the build number.
ftp://service.boulder.ibm.com/ps/products/os2/fixes/v4warp/english-us/ to obtain FixPack 5 for OS/2. http://service.boulder.ibm.com/asd-bin/doc/en_us/java116/f-feat.htm to obtain JDK 1.1.6 for OS/2 Warp. ftp://ftp.hursley.ibm.com/pub/java/fixes/os2/11/116/
JDK or JRE 1.1.5 JDK or JRE 1.1.6 - to run under this version you should use the patch to awt. Read about Scrollbars jitter bug below. Visit the "Java Runtime Environment for Solaris" web page at http://www.sun.com/solaris/jre/index.html
JDK 1.1.5 v7 or 1.1.6 v5 ported by Randy Chapman and Steve Byrne. JDK 1.1.4 and 1.1.6 ported by Sergey Nikitin JDK 1.1.6 v1 ported by Randy Chapman and Steve Byrne. TYA since 0.7 by Albrecht Kleine. Available via http://www.blackdown.org, Linux-Java Tools page. It works with JDK 1.1.5 v7. Earlier versions are not acceptable. Visit the Java Linux project site at http://www.blackdown.org/java-linux.html
"Installation failed" message using pure Java installer?You logged in without Administrative privileges. This is known issue of InstallShield Java Edition:"Installation failed" message appears after installation on Windows NT systems when end user is not logged on as an administrator. I now run the Sun VM. I hear Microsoft's is faster, but what happens to my apps if I install MS JVM? Together runs ALMOST 2.5 TIMES FASTER with Microsoft's VM, compared with running on Sun's VM. If you have a need for speed, choose this VM. Your Java apps will run as before unless you yourself choose to configure them to run with the MS VM.
|
What documentation
is provided with Together ?
Together provides on-line documentation in HTML format. You can use your Web browser to view and print documentation files. The default path for these files is: $TOGETHER_HOME$/help/ and subfolders below. The main documentation subfolders are: Getting Started:
HowTo:
User's Guide:
There is also an example project: Families. This is a visual example of what you can achieve using Together. It provides a ready-made project that includes several of the most common UML diagrams. Open ./help/Families/families.html. For a complete Table of Contents for all on-line documentation, see ./help/index.html. References:
Known problems, etc.Refer to problems.txt for the list of known problems, limitations, workarounds and helpful tips.[ Documentation ] [ Help ] [
information ]
|
Where
can I get product information and support?
This varies depending upon where you are located. For the most up to date information refer to addresses mentioned in Getting Help of the readme.html file. [ Support ] [ Help ] [
information ]
|
Together
ran out of memory
Large projects require a lot of memory in fact. Working with Sun VM
you can control a memory allocation. Together.bat file (in installation's
bin directory) contains by default the keys (-ms/-mx) that tell Java Machine
to immediately allocate a large, 32MB heap. This provides benefit in performance
in comparison with allocating-on-demand.
Other hand, you can increase these parameters for better performance on large projects. You should an appropriate powerful computer; otherwise the effect may be negative. Note: we know of no such options for the Microsoft VM. See also: Excessive hard drive accesses
I used the pure Java installer under NT/95. I don't see Together on my Start menu... how do I start the program? Run the Together.exe file found in the bin directory under your Together installation. Moreover, you can simply drag-and-drop the Together.exe file icon to the Start button on the Windows Task bar to create a program item. [ Windows ][ NT ][ Installation ][ Install
][ start ]
In Windows, images are displayed in the wrong palette. You are working in 256-colors mode, switch to the High or True color mode. In Control Panel, open Display. On the Settings tab in Color Palette, choose pallete with number of colors more than 256. [ Windows ][ color ][ 256 ][ High Color][
palette ]
I'm having trouble printing. Printing problems can stem from any number of things unrelated to a particular application program. One problem frequently reported by Together users stems from the page size set in the system printer being set to a different size than that specified in Together's print options. Make sure the correct page size is set in both the system printer properties and in the Print tab of the Global Options dialog. If you override Global print options in individual diagrams, make sure the correct page size is set in both the system printer properties and in the Print tab of the Diagram Options dialog. There are known printing problems on the Windows platform with different
printer drivers. The diagram image is scaled up on the paper and doesn't
match visual boundaries. This problem was reported with the Sun JVM version
1.1.5 and 1.1.6 under Windows (both 95 and NT). They constantly occur with
the MS JVM build 2829 (SDK 3.0) and build 2925 (SDK 3.1).
print.dpi=72in the ./lib/config.properties file. In builds prior 374 it was commented by default. Since 374, it is 72 by default. This provides a better work in the most cases. However, if you experience printing problems as described, try to adjust the value or comment the property at all. For each test, modify and save config.properties file, then call Edit | Reload Options, if Together is running. Then invoke File | Print for a diagram. Compare print-out with the diagram image (it's useful to switch on Show Print Grid option). If you failed to resolve the problem, ask support. Notice your system configuration, installed printers, JVM. Important for Whiteboard users: see the next question. [ Virtual Machines ] [ Sun ] [
Printing ]
I can't do any configuration. The documented config.properties files is missing and Reload Options... command in the Edit menu is always disabled. You probably have a limited edition. User-configurable system properties are disabled in some kinds of editions (e.g. freely downloaded) and the config.properties file is not installed. If you've got a full commercial edition, try running Together again. If your config.properties was missing for some reason, Together generates a new one with default configurations. [ Properties ] [
Configuration ] [ Customizing ]
The commands on my Help menu don't work under Solaris. There is a file called 'associations' in Together's bin directory. This file specifies the path to the web browser used to display Help. The default setting is 'netscape'. If you don't run Netscape Navigator, or it is not in your search path, the Help menu commands are not invoked unless you point the associations file to your browser. [ Help ] [ Solaris
] [ Browser ]
Together crashes when I run a tool launch command under Linux . Specific to Linux port of JDK 1.1.4 only: If you create a tool (Edit | Global Options | Tools) and check the Use oistart and Wait for Update options, then start that tool and try to select Edit | Global options, Together crashes because of unexpected xlib reply. This is a problem in the Linux port of JDK 1.1.4. Workaround: Do not use it. [ Linux ] [ Tool
]
Scrollbars jitter under JDK 1.1.6 and Sun Solaris JDK 1.1.6 Production Release has an error in working with scrollbars
under Solaris.
[ JDK 1.1.6 ] [
Solaris ] [ Scrollbar ]
Together does not start under Java 1.2 You need to specify parameter -noverify for java in the command line. [ JDK 1.2 ] [
noverify ]
|
Why
my changes in the Text editor do not propagate to other related places?
I rename a class in the Text editor, switch to diagram and see that constructors have the old class name. I rename a class in the Text editor and it lost incoming links. I change C++ operation's declaration in the Text editor, switch to diagram and notice that the linkage with operation's definition is lost. This is because the Text editor in Together is only an auxiliary tool. It serves either small changes or implementations. The update in the mentioned cases is one-way, from the source code to the diagrams. A user is fully responsible for the correctness and synchronization of changes made in the Text editor. For careful update and propagating changes all over the model, we recommend to use diagram or inspector. Also recommended to make sure that all the diagrams deep in the package tree are opened. To do it, call Tools | Scan all diagrams from the main menu. [ Editing ] [ Text editor ] [ Update ] [ Propagate ] Why can't I enter Attribute/Operation declarations in-place as they display? With in-place editing of Attribute and Operation names, you have a choice:
For example, in a Java project you you might see an attribute displayed on a Class icon like so: +attr1:int When you click to activate the in-place editor,
the editable text displays as: attr1
[ Editing ] [ Properties] [ Attribute ] [ Operation ] Why can't I import classes from <default> directory for another Together project? I want to import classes from other Together projects but encounter the following problem: I want to import classes from c:\samples\project1; I include c:\samples\project1 in source/class path; No files appear in the Import dialog, since only packages are listed there (no root directory for ANOTHER project, only <default> for current one). It's possible to see the desired files in the Import dialog by shortening source/class path of the project to c:\samples. However, then you'll see a project1 item in the listbox of the Import dialog, and see classes you want to import, but the classes won't be imported since they have no package statement. This is because of importing classes with Package statements is inconsistent
with the path to file relative to the source/class path.
How can I reach operation's definition in C++ projects? Together knows about operations' and static attributes' definitions,
if they are available in the current project. It loads the corresponding
definition source code into the Text editor, if you Shift-click the item.
In addition, if you Shift-click the class that has already at least one
operation with definition, the corresponding source file will be loaded
into the editor.
[ C++ ] [ Defintion ] [ Navigation ] |
GO TO TOP | HOW TO | USERS GUIDE | HELP CONTENTS |