NetRexx User's Guide, version 2.02
Copyright (c) IBM Corporation, 2001. All rights reserved. ©
|Draft of 22 May 2001
|[previous | contents | next]
This section gives a detailed procedure for installing NetRexx using a
Java 1.1 development kit. The steps are as follows:
Locate the Java home directory.
The name of the Java home directory will vary depending on the operating
system you are using. Some possibilities are:
It will contain directories such as bin and
Note: if your Java home directory is on a CD-ROM, or on an unwritable
shared disk, you'll need to leave the NetRexx files elsewhere and set up
CLASSPATH and PATH environment settings to refer to them.
Consult your Java toolkit and operating system documentation for details
on how to do this.
Add the NetRexxC.jar file to the CLASSPATH.
For Java to be able to find the NetRexx classes, you must update the
CLASSPATH environment variable by adding the full path and name of the
NetRexxC.jar file to the CLASSPATH setting. There will often already be
a CLASSPATH variable set, possibly including a path to the standard Java
classes.zip file. Specify or add the full path (disk, directories, and
file specification) for NetRexxC.jar, making sure that the case of every
letter is exactly right (Java is very case-sensitive). The
full path might be something like:
Note: if you have a NetRexxC.zip in your CLASSPATH from an earlier
version of Rexx, remove it (NetRexxC.jar replaces NetRexxC.zip).
The procedure for setting the CLASSPATH variable depends on your
operating system (and there may be more than one way), as described in
the Setting the CLASSPATH section .
Copy the executables.
Copy all the files in the NetRexx\bin directory to a directory
which is in your search PATH (perhaps the \bin directory below
the Java home directory). This will allow them to be invoked simply by
typing their name at a command prompt.
The files in the bin directory should be:
hello.nrx -- a simple NetRexx program for testing
NetRexxC.cmd -- the NetRexx compiler command in Rexx
NetRexxC.bat -- similar NetRexx compiler batch script (Windows .bat)
NetRexxC.sh -- similar NetRexx compiler shell script for Linux and Unix
nrc.cmd -- shorter name for NetRexxC.cmd
nrc.bat -- shorter name for NetRexxC.bat
nrc -- shorter name for NetRexxC.sh
The .cmd files are simple Rexx scripts for making it easier to
use the translator. You don't have to use these, but they save some
typing. They should require little modification to run under the Rexx
interpreter for your platform; for details of Rexx interpreters,
Under Windows, the .bat files should serve the same
purpose they are not as flexible as the Rexx .cmd files,
but will save typing.
Similarly, under Linux or other Unix systems, the NetRexxC.sh and nrc
script simplify use of the translator. You may need to indicate these
are executable, using (for example) the commands: chmod 751
NetRexxC.sh and chmod 751 nrc and (unless you used
the unzip -a command to unpack them) you may need to run dos2unix
on both of them (this converts CRLF to LF).
As an alternative to copying the files, the NetRexx\bin directory
could be added to the PATH environment setting.
NetRexx installation is now complete. Now would be a good time to check
that it works, as described in the Testing the NetRexx
[previous | contents | next]