User's Guide - Installing on an EBCDIC system

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

## Installing on an EBCDIC system

(Many thanks to Mark Cathcart and John Kearney for the details in this section.)

The NetRexx binaries are identical for all operating systems; the same NetRexxC.jar runs everywhere. However, during installation it is important to ensure that binary files are treated as binary files, whereas text files (such as the accompanying HTML and sample files) are translated to the local code page as required.

The simplest way to do this is to first install the package on a workstation, following the instructions above, then copy or FTP the files you need to the EBCDIC machine. Specifically:

- The NetRexxC.jar file should be copied ‘as-is’, that is, use FTP or other file transfer with the BINARY option. The CLASSPATH should be set to include this NetRexxC.jar file.
- Other files (documentation, etc.) should be copied as Text (that is, they will be translated from ASCII to EBCDIC).

In general, files with extension `.au`, `.class`, `.gif`, `.jar`, or `.zip` are binary files; all others are text files.

For specific hints and tips for installing on OS/390, see Mark Cathcart's web site at `http://www.ibm.com/servers/corner` which includes a presentation that describes OS/390 Java and NetRexx installation. Setting the classpath might look like this:

      export CLASSPATH=$CLASSPATH:/u/j390/j1.1.8/lib/NetRexxC.jar

[previous | contents | next]