Welcome to the Frightening World of Java/Perl interoperability! See 'Changes' files for the latest & greatest! See below for instructions on how to install on a Windows box running ActiveState Perl. Version 2.x of JavaServer & Java.pm are NOT backwards compatible!!! You MUST use a 2.x version of JavaServer with a 2.x version of Java.pm & same for 1.x versions! Check out the 'Changes' file for new stuff in the 2.1 version of the Java code bundled with Java-2.1 - basically addition of static start & stop methods to allow JavaServer to be 'hooked' into your current applications easier. Thanks to Andreas Leue! There are two parts to this: 1. The 'Backend' - which is contained in 'JavaServer.jar'. The backend must be running for the 'Frontend' (part #2) to work. Run 'install_java_server.pl' to get this part going. The 'main' Java class is called 'JavaServer' so you end up running the thing as 'java -classpath JavaServer' JavaServer listens on a port for incoming connexions from Frontends - you can alter the default port of 2000 by specifying it on the command line like: java -classpath JavaServer 8000 Will start the server listening on port 8000. You would then need to tell the Java Perl module to connect to port 8000 instead of the default like: my $java = new Java(port => 8000); More on this below. 2. The 'Frontend' - which is the Perl module 'Java.pm' which you install as any other Perl module. First be sure to run 'install_java_server.pl' to get your JavaServer environment set up and happy. Make sure 'JavaServer' is up and running before you try to run any tests! Basically you just need to add 'JavaServer.jar' to your classpath on the 'java' command line (which unfortunately forces you to also add in classes.zip manually). Run the 'install_java_server.pl' and it will create a shell or batch file for you (most likely) - or at least tell you what you need to to. Please see the javadoc on Java for LOTS more information. JavaServer Tested On Matrix: JVM 1.1.8 1.2 Platorm ------- NetBSD Yep Solaris Yep Yep Windows '98 Yep Yep Linux Yep Yep In theory - according to 'Write Once Run Anywhere' that is! - JavaServer should run no problem under any 1.1+ JVM. It doesn't really do anything too fancy. The 'SwingEventListener' does need Swing to be loaded (or accessible) to the JVM to use Swing events & of course Swing classes. You can run JavaServer just fine if Swing isn't available - it'll automatically detect that Swing isn't available and use 'EventListener' rather than 'SwingEventListener'. That gets ya all the plain old AWT events. 'SwingEventListener' subclasses 'EventListener' & just adds all them bizzare Swing events. A great place to look is the 'test.pl' script and in the 'examples' directory. ACTIVESTATE USERS Thanks to John Z. for this info: 1. to install under activeperl, users needs to download nmake15. and use the nmake instead of make on the usual perl install. location of nmake15.exe is under ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe instrtuction on how its used with activestate modules is www.activestate.com/Products/ActivePerl/docs/faq/ActivePerl-faq2.html