HALT(num)

Pragma equivalent

None.

Purpose

Stops compilation process of a set of source code before producing any object, executable, or assembler source files if the maximum severity of compile-time messages equals or exceeds the severity specified for this option.

Syntax

Defaults

HALT(16)

Parameters

num: Return code from the compiler. See z/OS XL C/C++ Messages for a list of return codes.

Usage

If the return code from compiling a particular member is greater than or equal to the value num specified in the HALT option, no more members are compiled. This option only applies to the compilation of all members of a specified PDS or z/OS® UNIX System Services file system directory.

Under z/OS UNIX, the prefix_ACCEPTABLE_RC (where prefix can be _CC, _CXX, or _C89, depending on the language level) environment variable, or the acceptable_rc compiler configuration file attribute can be set to change the threshold used to control what return code is returned. For more information, see Environment variables and Configuration file attributes.

IPA effects

The HALT option affects the IPA link step in a way similar to the way it affects the IPA compile step, but the message severity levels may be different. Also, the severity levels for the IPA link step and a C++ compilation include the "unrecoverable" level.

Predefined macros