14.14. Control Hex Conversion Utility Diagnostics

The hex conversion utility uses certain C/C++ compiler options to control hex-converter-generated diagnostics.

--diag_error

Syntax: –diag_error=id

Categorizes the diagnostic identified by id as an error. To determine the numeric identifier of a diagnostic message, use the –display_error_number option first in a separate link. Then use –diag_error=id to recategorize the diagnostic as an error. You can only alter the severity of discretionary diagnostics.

--diag_remark

Syntax: –diag_remark=id

Categorizes the diagnostic identified by id as a remark. To determine the numeric identifier of a diagnostic message, use the –display_error_number option first in a separate link. Then use –diag_remark=id to recategorize the diagnostic as a remark. You can only alter the severity of discretionary diagnostics.

--diag_suppress

Syntax: –diag_suppress=id

Suppresses the diagnostic identified by id. To determine the numeric identifier of a diagnostic message, use the –display_error_number option first in a separate link. Then use –diag_suppress=id to suppress the diagnostic. You can only suppress discretionary diagnostics.

--diag_warning

Syntax: –diag_warning=id

Categorizes the diagnostic identified by id as a warning. To determine the numeric identifier of a diagnostic message, use the –display_error_number option first in a separate link. Then use –diag_warning=id to recategorize the diagnostic as a warning. You can only alter the severity of discretionary diagnostics.

--display_error_number

Syntax: –display_error_number

Displays a diagnostic message’s numeric identifier along with its text. Use this option in determining which arguments you need to supply to the diagnostic suppression options (–diag_suppress, –diag_error, –diag_remark, and –diag_warning). This option also indicates whether a diagnostic is discretionary. A discretionary diagnostic is one whose severity can be overridden. A discretionary diagnostic includes the suffix -D; otherwise, no suffix is present. See Diagnostic Options for more information on diagnostic messages.

--issue_remarks

Syntax: –issue_remarks

Issues remarks (nonserious warnings), which are suppressed by default.

--no_warnings

Syntax: –no_warnings

Suppresses warning diagnostics (errors are still issued).

--set_error_limit

Syntax: –set_error_limit=count

Sets the error limit to count, which can be any decimal value. The linker abandons linking after this number of errors. (The default is 100.)

--verbose_diagnostics

Syntax: –verbose_diagnostics

Provides verbose diagnostics that display the original source with line-wrap and indicate the position of the error in the source line.