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 0.81.
Copyright(c) IBM Corporation, 1996. All rights reserved. ©