User's Guide - Installing the NetRexx translator

NetRexx User's Guide, version 2.02 Copyright (c) IBM Corporation, 2001. All rights reserved. © | Draft of 22 May 2001
[previous | contents | next]

## Installing the NetRexx translator

The NetRexx package includes the NetRexx translator – a Java application which can be used for compiling, interpreting, or syntax-checking NetRexx programs. The procedure for installation is briefly as follows (full details are given later):

1. Make the translator visible to the Java Virtual Machine (JVM):
   - If you are running Java 1.2 or later, copy the file `NetRexx\lib\NetRexxC.jar` to the `jre\lib\ext` directory in the Java installation tree. The JVM will automatically find it there and make it available.
   - If you are using an earlier Java version (1.1.2 through 1.1.8) instead add the full path and filename of the `NetRexx\lib\NetRexxC.jar` to the CLASSPATH environment variable for your operating system.
   Note: if you have a NetRexxC.zip in your CLASSPATH from an earlier version of Rexx, remove it (NetRexxC.jar replaces NetRexxC.zip).
2. Copy all the files in the `NetRexx\bin` directory to a directory in your PATH (perhaps the `\bin` directory in the Java installation tree). This is not essential, but makes shorthand scripts and a test case available.
3. If you are running Java 1.2 or later, make the file `\lib\tools.jar` (which contains the `javac` compiler) in the Java tree visible to the JVM. You can do this either by adding its path and filename to the CLASSPATH environment variable, or by moving it to the `jre\lib\ext` directory in the Java tree.
4. Test the installation by making the `\bin` directory the current directory and issuing the following two commands exactly as written:

         java COM.ibm.netrexx.process.NetRexxC hello
         java hello

   The first of these should translate the test program and then invoke the `javac` compiler to generate the class file (`hello.class`) for the program. The second should run the program and display a simple greeting.

If you have any problems or errors in the above process, please read the detailed instructions and problem-solving tips that follow.

[previous | contents | next]