error_display_popup(_c)
status.i4.v = error_display_popup_c(top_row.i4.v, left_column.i4.v,
message.i1a.r, error_type.i4.v,
error_code.i4.v [,color.i4.v]
[,priority.i4.v])
This routine displays an error code and/or message in a
popup window. This routine will return a value of ERR_ERROR
if "error_code" is an error (depends on "error_type") or
ERR_OVFLOW if the same error has been repeated for more than five
times. If the overflow condition occurs, the error will not be
displayed. If specified in the most recent call to error_init(_c),
this routine will also write to an error log file. A previous call
to error_init(_c) is necessary.
top_row top row of menu (use WMNGR_CENTER for centering
or WINDOW_xxx_COORD macros in macro for special
positioning)
left_column left column of menu (use WMNGR_CENTER for centering
or WINDOW_xxx_COORD macros in macro for special
positioning)
message null terminated message (ERR_MAXLEN character max)
error_type type of error
(ERR_NONE -> no error, just a message,
ERR_ACNET -> "error_code" is an ACNET error,
ERR_INT -> "error_code" is a simple integer value,
ERR_SYS -> "error_code" is a VMS error code,
ERR_RTL -> "error_code" is a C RTL (errno) error code,
ERR_DEVNAM -> "error_code" is an ACNET device index,
otherwise -> "error_type" is interpreted as an ACNET
device index and "error_code" is treated
as an ACNET error)
error_code error code to display
[color] display color (default is RED if "error_code"
indicates an error condition and CYAN otherwise)
(constants are in 'cnsparam')
[priority] log entry priority value
(default is ERR_DEFAULT_PRIORITY)
This function returns status values as follows:
ERR_OK "error_code" is not an error
ERR_ERROR "error_code" is an error (This is
nonzero for integer or ACNET "error_type"
and any value but 1 for VMS "error_type".)
ERR_OVFLOW "error_code" is an error, but error
clipping is on and this device/error
combination has already occurred too
many times to be displayed
ERR_NO_INIT error_init(_c) has not been called
This function requires the following include files:
cbslib_h, cnsparam_h, acnet_errors_h
Related functions:
error_display_c, error_printf_c, error_message(_c), error_mprintf_c,
error_colored_message_c, error_cmprintf_c, error_init(_c),
error_imbedded_enabled, error_imbedded_on, error_imbedded_off,
error_erase, error_close, error_last, error_clip_depth_c,
error_query_clipping, error_trace_on, error_trace_off,
error_trace_get, error_trace_view_c, error_size_and_position_c,
error_is_occluded, error_window_is_present, intro_error
C/C++ usage:
static const char message[] = "This is an error message.";
int status;
int top_row = WMNGR_CENTER;
int left_column = WMNGR_CENTER;
int error_type = ERR_ACNET;
int error_code = ACNET_PEND;
int color = RED;
int priority = ERR_DEFAULT_PRIORITY;
status = error_display_popup_c(top_row,left_column,message,error_type,
error_code,color,priority);