Building with Ant

Apache Ant is a Java-based build tool and is part of the Apache Jakarta Project

It can be found at the following link:

http://jakarta.apache.org/ant/index.html

Please refer to the Ant Documentation

http://jakarta.apache.org/ant/manual/index.html

You can obtain the current sources here:

• Sources
• Nightly CVS Tarball
• Anonymous CVS Repository Access

cvs -d:pserver:anonymous@cvs.tn5250j.sourceforge.net:/cvsroot/tn5250j login

cvs -z3 -d:pserver:anonymous@cvs.tn5250j.sourceforge.net:/cvsroot/tn5250j co tn5250j
           

1. Create a base directory to place source

2. Create two directories beneath the base directory called lib and src for example your directory structure should look like the following:

base directory
   |
   + - lib
   |
   + - src
            

3. Unzip and place all source files from tn5250j source zip file that was downloaded into src directory.

4. Place the included build.xml file into the base directory.

5. Place the extra .jar files used for mailing in the lib directory.

You can download the e-mail api's from sun. You will need two packages:

• http://java.sun.com/products/javamail/
• http://java.sun.com/products/javabeans/glasgow/jaf.html

JavaMail jar files:

• activation.jar
• mail.jar
• mailapi.jar
• smtp.jar

6. Now execute ant using one of the methods described in the ant documentation (simple typing ant should work here) or use the sample bat file for windows below:

c:\basedirectory>build all
            

Sample Windows build.bat that I use on windows

@echo off

rem this batch-file can be used to override the java_home or ant_home
rem environment or to set a special classpath and so on...
set ANT_HOME=D:\jakarta-ant-1.4.1
set JAVA_HOME=C:\jdk1.3.1

call %ANT_HOME%\bin\ant -buildfile build.xml %1 %2 %3 %4 %5 %6 %7 %8 %9

For more information on the command line parameters that the build process supports execute the following:

>ant -projecthelp
    

The build process does not include SSL support as default. To compile the files that are associated with SSL you must use the -DSSL=true flag when executing the build process.

Example

    >ant -DSSL=true all
    

A special process will have to be followed to allow the code base to interact with 1.3 and 1.4 version at the same time. This is a temporary solution for now until the build process can test for the different versions.

• Set the JAVA_HOME variable to version 1.3

>export JAVA_HOME=/path/to/java1.3

• Execute the build process

>ant all

• Set the JAVA_HOME variable to version 1.4

>export JAVA_HOME=/path/to/java1.4

• Execute the compile target of the build

>ant -DSSL=true compile

• To build the .jar file execute the package target of the build

>ant package

You will now have a .jar file that works for versions 1.3 and 1.4 of the jdk. All will work except for allocating a Secure Socket if using a version of 1.3. However if the JVM that is executing the emulator happens to be 1.4 then the SSL code will loaded correctly to allocate the Secure Socket.