Previous Topic: Diagnostic ToolsNext Topic: @I$INTERNAL STATUS


Internal Error Facility

CA Ideal provides an internal error logging and reporting facility. This facility traps internal system errors, not necessarily user errors. Any time an illogical or unexpected return code is received from an internal service in CA Ideal, the Internal Error Facility automatically gets control.

For example, if you try to delete a VLS member that does not exist, a return code indicating the problem is a reasonable condition and a simple message is issued. However, if the return code indicates “library cannot be accessed,” this is an unexpected condition, probably due to an error in generating or restoring the CA Ideal system. In the second case, an internal error message is issued.

Such internal error messages begin with the keyword INTERR.

If the message contains the keyword INTERR, the Internal Error Facility performed two actions: It wrote a hardcopy record of the internal error to the ADRLOG Log File (printed when the teleprocessing monitor is shut down or when a batch job ends) and, for an online session, it saved information about the error that you can display on the terminal by entering the following command.

This facility has the following format:

DISPLAY ERROR

The minimum abbreviation is D ERR.

If you plan to call CA Technical Support about the error, copy the information from your terminal, from a PRINT SCREEN printout, or from ADRLOG. Save the PRINT SCREEN or ADRLOG printout in case you are requested to send it to CA.

Note: Online, you can enter the DISPLAY ERROR command at any time. Information about the most recent internal error (if any) displays.

The following is an example of DISPLAY ERROR information.

1-IDADERRP18E - INTERR: LIB cannot be accessed, LIB=ID$IDOBJ SRVC=VLS FUNC=INIT RC=008 PGM=ADOMLD 11.0 -0E7C CALPGM= CURACT=AE ACTTYP=U USER=COL ERRID=AELPGM-L20 SYS=$ID ENTTYP=PGM ENTNAM=SCROLL ENTVER=001 ENTSTAT=TEST LIB=ID$IDOBJ MEM=

Following is a description of the various fields that you can display on Internal Error panels. The Internal Error key consists of the Service (SRVC) detecting the error, the internal function (FUNC) performed by that service, and the return code (RC). Only relevant fields display on a given Internal Error panel.

SRVC

Internal service detecting the error. Currently, the internal services are:

FUNC

Specific function performed by the service. For example, VLS services include INIT (initialize), READ, WRITE, and so on.

RC

Return code from the service.

PGM

Identifier of the internal program in control when the error was detected. This includes the six‑character program name, the CA Ideal version when the program was last compiled, the offset of the instruction detecting the error, and the date and time when the program was last compiled.

CALPGM

Identifier of the calling program, in cases where the program actually detecting the error is a general subroutine called from several other places. This includes the calling program name, the CA Ideal version, and the offset of the call instruction.

CURRACT

Current activity. Codes are as follows:

ACTTYP

Type or mode of activity. Possible codes are D (display), E (edit), and U (utility).

USER

Three‑character user ID.

ERRID

One‑ to ten‑character string that the program returned detecting the error to aid in problem determination (for example, this can be the sequence number of an iterated call to the service). This field can be blank.

DSFCMND

Command issued to the dictionary service facility that resulted in the specified return code.

QUALIFIER

Dictionary service facility User Request Area qualifier field passed to the dictionary service facility.

SYS

Three‑ character short system ID currently selected.

ENTTYP

Current entity type of the Datadictionary component of CA Datacom/DB.

ENTNAM

Current Datadictionary entity name.

ENTVER

Current Datadictionary entity version.

ENTSTAT

Current Datadictionary entity status.

PANEL‑NAME

Current panel name.

VER

Current panel version.

SUB‑SYS

Current panel subsystem (PDF only).

LIB

Seven‑ or eight‑character VLS library identifier (corresponds to the DD/DLBL name for the indicated VLS file).

MEM

An 11‑to‑24‑character VLS member name, possibly with embedded spaces.

LOGMSG

Optional message written to ADRLOG by the program detecting the error. It can be in any format.