Installation of NetRexx for OS/2


Here's what you need to install NetRexx for OS/2, and how to install it.

You need

  OS/2 Warp         -- [or Warp Connect, Warp Server, etc.]
  an HPFS disk      -- with at least 1MB free space
                       [Long name support is *required* for NetRexx and Java]
  Java for OS/2     -- the Java for OS/2 package, installed and running
                       [either the beta or the JDK 1.0 are OK]
  UNZIP.EXE         -- Info-ZIP's version 5.12, August 1994, or later
                       [you need this even if you downloaded the .tar.gz
                       version of the package]
  Hardware          -- a 486-class machine with 12MB+ RAM is recommended

Installation procedure

  1. Ensure that you have a program called UNZIP.EXE in a directory on your PATH. The NetRexx translator will use this for accessing the Java classes held in the Java Development Kit Zip file (lib\classes.zip).

    Info-ZIP's UNZIP is recommended for running the NetRexx translator as it is much faster than PKUNZIP at locating classes in Zip files.

  2. Copy the 'nros2.zip' or 'nros2.tar.gz' package file from the NetRexx documentation directory to the Java home directory (for example, D:\JAVAOS2), using the original name.
  3. With the Java home directory as your current directory, unpack the package, following the instructions in "Unpacking NetRexx packages" above.

    This should add files to two directories:

      bin      -- NetRexxC.cmd -- the NetRexx compiler command
                  nrc.cmd      -- shorter name for NetRexxC
                  NetRexxT.exe -- the NetRexx translator program
                  hello.nrx    -- a simple NetRexx program for testing
    

    classes -- Classes that NetRexx needs to run with Rexx support. These will be placed in the subdirectory classes\netrexx\lang (in Java-speak, these form the package netrexx.lang.*).

  4. To check installation, change directory to the Java BIN directory, then:

    You can also carry out both these steps with the single command:

      netrexxc -run hello
    

    This package also includes a 'trivial' nrc.cmd file that simply passes on its arguments to NetRexxC; 'nrc' is just a shorter name that saves typing, so for the last example you could type:

      nrc -run hello
    

    You could also edit the nrc.cmd and add your favourite 'default' NetRexxC options there (if you do this, keep a backup copy, so that if you install a new version of the NetRexx package you won't overwrite your changes).

If, when you installed Java for OS/2, you added the JAVAOS2\BIN directory to your OS/2 path, the NetRexxC and nrc commands should work from any directory.

Note there is a restriction at present: for NetRexxC to find the JavaOS2 home directory, the JAVAOS2\BIN directory must be in your PATH.


[ previous section | contents | next section ]

From 'nrinst.doc', version 0.50.
Copyright(c) IBM Corporation, 1996. All rights reserved. ©