NetRexx User's Guide, version 2.05 Copyright (c) IBM Corporation, 2005. All rights reserved. © | Draft of 14 Jan 2005
[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:

- Ensure that you are unzipping to a disk that supports long file names (for example, an HPFS disk or equivalent on OS/2 or Windows).
- Info-ZIP: use version 5.12 (August 1994) or later. The syntax for unzipping NetRexx.zip is simply

        unzip NetRexx

  which should create the files and directory structure directly.
- WinZip: all versions support long file names.
- PKZIP: use a version that supports long file names. The syntax for unzipping NetRexx.zip is

        pkunzip -d NetRexx

  which should create the files and directory structure directly. The ‘`-d`’ flag indicates that directory structure should be preserved.
- Linux unzip: use the syntax: `unzip -a NetRexx`. The ‘`-a`’ flag will automatically convert text files to Unix format.
- jar: The syntax for unzipping NetRexx.zip is

        jar xf NetRexx.zip

  which should create the files and directory structure directly. The ‘`x`’ indicates that the contents should be extracted, and the ‘`f`’ indicates that the zip file name is specified. Note that the extension (`.zip`) is required.

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]