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 in your CLASSPATH from an earlier version of Rexx, remove it (NetRexxC.jar replaces
  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 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]