DC_OPTIONS Function

Sets error message reporting level for all “DC” import/export functions.

Usage

    status = DC_OPTIONS(msg_level)

Input Parameters

msg_level — The error message reporting level. Allowed values are:

  • 0 — No messages. All “DC” functions operate in a silent mode.

  • 1 — Error messages (messages that indicate a “DC” function has failed).

  • 2 — Error message plus warning messages (messages that indicate the “DC” function did something, but possibly not what was expected).

  • 3 — Error message plus warning messages plus informational messages. All levels of error messages are reported.

Each level of message reporting includes all error message reporting levels with a lower value, as well. For example, Level 3 includes both Level 2 and Level 1 messages.

Returned Value

status — The value returned by DC_OPTIONS; expected values are:

  • < 0 — Indicates an error, such as an invalid value for msg_level.

  • 0 — Indicates a successful interpretation of msg_level.

Keywords

None.

Discussion

By default, all messages are sent to LUN –2, the standard error stream (stderr for UNIX).

If you are using DC_OPTIONS with an error message reporting level of 0, messages are not automatically sent to the standard error stream, but status codes are still being generated by the various “DC” functions. These status codes can be used as input to DC_ERROR_MSG; this is the way to obtain the corresponding error message string, a string that you can then process or display in any way that you choose to.

See Also

DC_ERROR_MSG