Using the NetRexx compiler


The installation instructions for the NetRexx compiler describe how to use the package you installed to compile and run a simple NetRexx program. This section explains more of the options available to you.

Invoking the compiler

The compiler is a Java program (class) called netrexx.process.NetRexxC (NetRexxC for short). This can be invoked using the Java interpreter, for example, by the command:

  java netrexx.process.NetRexxC

or by using a system-specific command (such as 'NetRexxC' or 'nrc'). In either case, the compiler invocation is followed by one or more program names (the program files to be compiled). NetRexxC will add the extension '.nrx' to input program names (file specifications) if no extension was given.

So, for example, to compile 'hello.nrx', you can use any of:

  java netrexx.process.NetRexxC hello
  java netrexx.process.NetRexxC hello.nrx
  NetRexxC hello.nrx
  nrc hello

(the first two should always work, the last two require that the system-specific command be available). The resulting .class file is placed in the current directory.

As well as file names, you can also specify various option words, which are distinguished by the first character of the word being '-'. These may be any of the option words allowed on the NetRexx OPTIONS instruction (see the NetRexx language documentation), prefixed with '-'. These options words can be freely mixed with file specifications.

The netrexx.process.NetRexxC compiler also implements some additional option words:

Here are some examples:

  java netrexx.process.NetRexxC hello -keep -strictargs
  java netrexx.process.NetRexxC -keep hello wordclock
  java netrexx.process.NetRexxC -keep hello wordclock -nocompile

If you are using the provided NetRexxC or nrc scripts, then two additional options are available:

Some possible compiler invocations using these commands might be:

  nrc hello
  nrc hello.nrx
  nrc hello -run
  nrc -keep Spectrum -runpm
  nrc hello -binary -verbose1
  nrc -noverbose hello -format -keep

Option words may be specified in lowercase, mixed case, or uppercase. File specifications are platform-dependent and may be case sensitive, though NetRexxC will always prefer an exact case match over a mismatch.


[ previous section | contents | next section ]

From 'nrinst.doc', version 0.75.
Copyright(c) IBM Corporation, 1996. All rights reserved. ©