Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

DSNM Library Services
Distributed Systems Network Management (DSNM) Subsystem Interface Development
Guide—109759 A-103
_REPORT^INTERNAL^ERROR
_REPORT^INTERNAL^ERROR
_REPORT^INTERNAL^ERROR logs internal errors to the $0 EMS collector.
internalcode input
INT:value
is an internal code that you assign strictly for your own use.
severity input
INT:value
is one of the following values, indicating the severity of the event logged to EMS:
I1 .. I4 input
INT:value
are four optional integer values for you to report relevant information.
Considerations
•
The internal code is designed to assign a code for locating the point of the error in
the program.
•
The integer values are designed to display internal data values in the event message
to help trace the error.
Example
IF _NOTNULL (@inobj := _GET^LM (cx.current^in)) THEN
BEGIN
CALL _REPORT^INTERNAL^ERROR (1, _EMS^EVENT^INFO);
RETURN _RC^ABORT (ZDSN^ERR^INTERNAL^ERR);
END;
_REPORT^INTERNAL^ERROR ([ internalcode ]
,[ severity ]
,[ I1 ]
,[ I2 ]
,[ I3 ]
,[ I4 ] );
_EMS^EVENT^INFO
The event is a nonfatal informative message; it is
defined earlier in this appendix.
_EMS^EVENT^CRITICAL
The event reports a critical but nonfatal condition; it
is defined earlier in this appendix.
_EMS^EVENT^FATAL
The event reports a fatal condition; it is defined
earlier in this appendix.