Purpose
Limits the diagnostic messages to those of a
specified severity level or higher.
Syntax
(1) (2)
.-------i-. .-------i-.
>>- -q--flag--=--+-l-------+--:--+-l-------+-------------------><
+-w-------+ +-w-------+
+-e-------+ +-e-------+
+-s-------+ +-s-------+
+-u-------+ +-u-------+
'-q-------' '-q-------'
Notes:
- Minimum severity level of messages reported in listing
- Minimum severity level of messages reported on terminal
@PROCESS:
@PROCESS FLAG(listing_severity,terminal_severity)
Defaults
-qflag=i:i,
which shows all compiler messages.
Parameters
The severity levels (from lowest
to highest) are:
- i
- Informational messages. They explain things that you should know,
but they usually do not require any action on your part.
- l
- Language-level messages, such as those produced under the -qlanglvl option.
They indicate possible nonportable language constructs.
- w
- Warning messages. They indicate error conditions that might require
action on your part, but the program is still correct.
- e
- Error messages. They indicate error conditions that require action
on your part to make the program correct, but the resulting program
can probably still be executed.
- s
- Severe error messages. They indicate error conditions that require
action on your part to make the program correct, and the resulting
program will fail if it reaches the location of the error. You must
change the -qhalt setting to make the compiler
produce an object file when it encounters this kind of error.
- u
- Unrecoverable error messages. They indicate error conditions that
prevent the compiler from continuing. They require action on your
part before you can compile your program.
- q
- No messages. A severity level that can never be generated by any
defined error condition. Specifying it prevents the compiler from
displaying messages, even if it encounters unrecoverable errors.
Usage
You must specify both listing_severity and terminal_severity.
Only
messages with severity listing_severity or
higher are written to the listing file. Only messages with severity terminal_severity or
higher are written to the terminal.
The -qflag option
overrides any -qlanglvl or -qsaa options
specified.
The -w option
is a short form for -qflag=e:e.
The
-qhaltonmsg option has precedence
over the
-qflag option. If you specify both
-qhaltonmsg and
-qflag,
messages that
-qflag does not select are
also printed and compilation stops.
Note: If -qflag=u:u or -qflag=q:q is
specified, the message specified by -qhaltonmsg is
not shown.