tibemsErrorContext_GetLastErrorStackTrace

Purpose

Retrieve a stack trace associated with the last EMS call.

C Declaration

tibems_status tibemsErrorContext_GetLastErrorStackTrace(
    tibemsErrorContext errorContext,
    const char** string);

COBOL Call

CALL "tibemsErrorContext_GetLastErrorStackTrace"
   USING BY VALUE errorContext,
       BY REFERENCE string,
   RETURNING tibems-status
END-CALL.

Parameters

Parameter Description
errorContext The error context.
string Location of the stack trace string.

Remarks

Passing NULL for the errorContext parameter will default to the error context of the current thread. This is useful for retrieving information from within a listener or exception callback. This function returns a pointer, not a copy of the stack trace string. If the last call was considered a non-error, an empty string is returned.

Return TIBEMS_OK, TIBEMS_INVALID_ARG (string is null, or passing an object created in a different thread), TIBEMS_NOT_INITIALIZED (no error context for this thread)