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)