Error handling functions

Use the following functions to manage errors and other types of codes in Natural Access:

Function

Synchronous/
Asynchronous

Description

ctaGetText

Synchronous

Returns the text representation of an error, reason, event, or command code.

ctaGetTextEx

Synchronous

Returns the text representation of an error, reason, event, or command code from a particular Natural Access Server.

ctaSetErrorHandler

Synchronous

Defines the action taken when an error is returned from Natural Access services.

ctaLogTrace

Synchronous

Allows you to log errors, warnings, or informational messages to the Natural Access trace log.

ctaSetTraceLevel

Synchronous

Sets the trace mask for a service on the specified context.

ctaStartTrace

Synchronous

Starts tracing on a remote server.

ctaSetGlobalTraceMask

Synchronous

Sets the global trace mask for the Natural Access Server specified by a context handle (ctahd).

ctaStopTrace

Synchronous

Stops tracing on a remote server.


Refer to Handling Natural Access errors for more information. Refer to the Alphabetical error summary for a list of Natural Access errors and to the Event summary for a list of Natural Access events.