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. ©