-qflag

Category

Listings, messages, and compiler information

Purpose

Limits the diagnostic messages to those of a specified severity level or higher.

Syntax

Read syntax diagramSkip visual syntax diagram
                    (1)             (2)        
                 .-------i-.     .-------i-.   
>>- -q--flag--=--+-l-------+--:--+-l-------+-------------------><
                 +-w-------+     +-w-------+   
                 +-e-------+     +-e-------+   
                 +-s-------+     +-s-------+   
                 +-u-------+     +-u-------+   
                 '-q-------'     '-q-------'   

Notes:
  1. Minimum severity level of messages reported in listing
  2. 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.

Related information