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

Unpacking the NetRexx package

The NetRexx package is shipped as a collection of files compressed into the file NetRexx.zip.

You probably know how to handle .zip files, but a word of caution: the packages contain directory structures, and files with ‘long names’ (that is, not of 8.3 maximum length names) which are case-sensitive. Many utilities, including some Windows versions of unzip, can lose case information, truncate names, or fail to restore directories.

Unpacking the NetRexx.zip file

The most common utilities for ‘unzipping’ are Info-ZIP, WinZip, and PKZIP. An unzip command is also included in most Linux distributions. You can also use the jar command which comes with all Java development kits.

Choose where you want the NetRexx directory tree to reside, and unpack the zip file in the directory which will be the parent of the NetRexx tree. Here are some tips:

After unpacking, the following directories should have been created:[1] 

NetRexx

Root of the tree, which should contain the file read.me.first, which contains quick installation instructions

NetRexx\browse

The directory which contains documentation and sample programs and applets. To view these, point your web browser at NetRexx\browse\netrexx.html. You can also go straight to this User's Guide by browsing NetRexx\browse\nrusers.html.

NetRexx\lib

Contains the NetRexx compiler/interpreter classes (in NetRexxC.jar).

NetRexx\runlib

Contains the NetRexx runtime classes (in NetRexxR.jar). These are included in the NetRexxC.jar, so are not normally needed.

NetRexx\netrexx\lang

Contains the NetRexx runtime class files for access by a browser while running the applet samples.

NetRexx\bin

Contains sample scripts making it easier to use the compiler/interpreter. The simple test case hello.nrx is also included.


Footnotes:
[1] On Unix and Linux systems, the directory separator will be ‘/’ instead of ‘\’.

[previous | contents | next]