-qhaltonmsg

Category

Error checking and debugging

Pragma equivalent

None.

Purpose

Stops compilation before producing any object files, executable files, or assembler source files if a specified error message is generated.

Syntax

Read syntax diagramSkip visual syntax diagram
-qhaltonmsg syntax - C

        .-nohaltonmsg--------------------------.   
        |               .-:------------------. |   
        |               V                    | |   
>>- -q--+-haltonmsg--=----message_identifier-+-+---------------><

Read syntax diagramSkip visual syntax diagram
-qhaltonmsg syntax - C++

        .-nohaltonmsg--+---------------------------+-.   
        |              |    .-:------------------. | |   
        |              |    V                    | | |   
        |              '-=----message_identifier-+-' |   
        |               .-:------------------.       |   
        |               V                    |       |   
>>- -q--+-haltonmsg--=----message_identifier-+-------+---------><

Defaults

-qnohaltonmsg

Parameters

message_identifier
Represents a message identifier. The message identifier must be in the following format:
15dd-number
where:
15
Is the compiler product identifier.
dd
Is the two-digit code representing the compiler component that produces the message. See Compiler message format for descriptions of these codes.
number
Is the message number.

Usage

When the compiler stops as a result of the -qhaltonmsg option, the compiler return code is nonzero. The severity level of a message that is specified by -qhaltonmsg is changed to S if its original severity level is lower than S.

You cannot specify -qnohaltonmsg to resume compilation if a message whose severity level is S has been issued.

C onlyThe -qnohaltonmsg compiler option cancels previous settings of -qhaltonmsg.C only

C++ only When you specify -qnohaltonmsg with message identifiers, the previous -qhaltonmsg instances with the same message identifiers lose effect. When you specify -qnohaltonmsg without specific message identifiers, all previous -qhaltonmsg instances lose effect.

If you specify two or three of the following options, the last option specified has precedence:
  • -qhaltonmsg=message_identifier
  • -qnohaltonmsg=message_identifier
  • -qnohaltonmsg
C++ only

-qhaltonmsg has precedence over -qsuppress and -qflag.

Predefined macros

None.

Related information