TiniTools Paths
New January 12, 2001 - Tutorials are moving
All the tutorials are now at http://www.systronix.com/tutor/top.htm
(These old pages will be left for a while until all the new tutorials are complete)

The last piece of the path puzzle is telling TiniTools where to put its output on your PC, and configuring TiniTools.

The .class file which JBuilder creates can be executed on the PC, but needs to be converted to a format acceptable to TINI before it can be executed by TINI.

You must have TiniTools installed to follow along with this example.


Adding a .tini file to a JBuilder Project

Reopen the paths.jpr project in the previous JBuilder Project Paths tutorial. In the projects pane, select the paths.jpr file and right click on it.

Click on Add to project, then add file. We want the .tini file to be in the same folder as the .class file output. In the add file dialog box, browse to the /PackageOne/classes folder and enter a .tini filename, including the extension. Click on Open.

In this case, the file hello.tini does not exist so JBuilder asks if you wish to create it. Hmm, looks like a typo there too - "..file does not exists." Click OK.

 

Now in the project file there is a hello.tini file located in a subfolder /PackageOne of the Sample1/classes folder.


Configuring a .tini file, converting and uploading

Right click on the hello.tini folder and select Properties. Note the entries for Tini Convert and FTP Put, these are placed there by TiniTools.

Uncheck the telnet open and login telnet options. At the time of this writing, the automatic login only works the first time you connect in a session, so I find it more convenient to login manually all the time.

In the host tab, set your TINI IP address and click OK.

In the host tab, set your TINI IP address and click OK. Save all to save these settings in the project file. Now in the JBuilder project pane, right click on the hello.tini file and select Tini Convert. If all is well, you should see "Converting..." and "FTP: ..." messages in the Messages Window.


All is not well, I don't see the "Conversion complete" message

If you see the "Converting..." message but never see the "Conversion complete" message, even after 10-20 seconds, this is most likely due to TiniTools not being able to find the tini.jar file which has the convert utility in it. What's happening is that JBuilder can't find the TiniConvert class in tini.jar, for TiniTools to use. So TiniTools tries to start the conversion but it never finishes. It would be nice if TiniTools gave you a message that it can't find the file (Brad? is this possible?).

1) You need to have the tini.jar and tiniclasses.jar as required libraries in your project, do you?

2) Then the jbuilder35\bin folder, file jdk.config must have the tini.jar "addpath" line added:

# Add JPDA and the "tools" JAR to the path since the JDK
# doesn't do so automatically
... there may be other addpaths already here, leave them alone ...
addpath e:/tinibeta2.2/tini.jar

This is discussed in more detail in the previous lesson on setting up & configuring TiniTools.

You will need to stop and restart JBuilder for this change to take effect.

Both 1) and 2) above are necessary, just having one of the two isn't enough. I had this problem when I first tried a conversion, and it was because I had 1) but not 2) in my system.


Connecting to TINI with TiniTools telnet

Since we've come this far we may as well connect to TINI with Telnet. To do this, double click on hello.tini in the project pane. A hello.tini telnet window will open in the JBuilder source pane. Click on the connect button. You should see a TINI login prompt. You may need to enlarge the telnet window to see all of it, it does not size itself to the available space quite the way it should. Here I typed ls -l to see a file listing and there is hello.tini.

Notice that hello.tini is in the root folder on TINI. At the moment there's no other option.

We could execute hello.tini but it is just a template and would generate no output. See the section "Your First TINI Program" for a program which actually does something interesting.

 


End of Lesson

Previous Lesson

Tutorial Home

Next Lesson