OPTIONS instruction


Syntax:

  OPTIONS option-word-list

Sets processor-dependent translator options. The OPTIONS instruction applies to the whole program, and must come before the first CLASS instruction (or any instruction that starts a class). The allowed option words, which are case-insensitive, are:

  BINARY       -- assign literals binary (primitive) or String types,
                  rather than Rexx types, and use native binary
                  operations to implement operators.  When NOBINARY is
                  in effect, terms in expressions are converted to Rexx
                  types before use by operators.
  CROSSREF     -- display cross-reference listings of variables, by
                  class.
  DIAG         -- display diagnostic information (for development use
                  only).
  FORMAT       -- format the output file for better readability.  Note
                  that if this option is in effect, line numbers from
                  the input file will not be preserved (so run-time
                  errors and exception tracebacks may show incorrect
                  line numbers).
  REPLACE      -- allow replacement of the output (.java) file.  The
                  default, NOREPLACE, prevents an existing .java file
                  being accidentally overwritten.
  STRICTARGS   -- require that method invocations always specify
                  parentheses, even when no arguments are supplied.
  STRICTASSIGN -- only allow exact type matches in assignments (this is
                  stronger than Java requirements).  This also applies
                  to the arguments in method calls.
  STRICTCASE   -- require that name matches be exact in case.
  STRICTSIGNAL -- require that uncaught checked exceptions be treated as
                  an error.
  TRACE        -- enables tracing (use NOTRACE to prevent tracing
                  overheads, even if TRACE appears in program).
  VERBOSEn     -- set the 'noisiness' of the processor (n=0 to 5; if
                  omitted, n=3).  NOVERBOSE and VERBOSE0 both suppress
                  all informative messages.

Prefixing any of the above with 'NO' turns the selected option off. For example:

  options binary nocrossref nostrictassign strictargs

The default settings of the various options are:

  nobinary crossref nodiag noformat noreplace nostrictargs
  nostrictassign nostrictcase trace verbose3

Multiple OPTIONS instructions are allowed. When an option word is repeated (in the same instruction or not) then the last use of the word determines the state of the option.

All option words may also be set as command line options when invoking the processor, by prefixing them with '-', for example:

  netrexxc -format -verbose4 foo.nrx

In this case, the options may come before or after file specifications. Options set with the OPTIONS instruction override command-line settings. For more information, see the installation and use documentation.


[ previous section | contents | next section ]

From 'netrexx.doc', version 1.00.
Copyright(c) IBM Corporation, 1996, 1997. All rights reserved. ©