Copyright © TIBCO Software Inc. All Rights Reserved

tibemsConnection_SetExceptionListener

Function

Purpose

Set the exception listener for a connection.

C Declaration

tibems_status tibemsConnection_SetExceptionListener(

    tibemsConnection connection,

    tibemsExceptionCallback listener,

    const void* closure );

COBOL Call

CALL "tibemsConnection_SetExceptionListener_STL"

USING BY VALUE tibemsConnection,

BY REFERENCE tibems-Exception-Status,

BY VALUE     TIBEMS-NULLPTR,

RETURNING tibems-status

END-CALL.

 

connection has usage pointer. tibems-Exception-Status has usage binary.

Parameters

 

Parameter	Description
connection	Set the exception listener for this connection.
listener	Register this exception listener callback.
closure	Register this closure argument.

Remarks

This is an alternate pathway for alerting a client program of connection problems. The program defines an exception listener callback function, and calls this function to register the callback and a closure argument. When the client library detects a connection problem, it calls the callback with a status code that identifies the problem.

See Also

tibemsConnection_GetExceptionListener on page 219

Asynchronous Errors.

tibemsExceptionCallback on page 233

Copyright © TIBCO Software Inc. All Rights Reserved