Unpacking the NetRexx package

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

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.