Programming Guide

client_exit

Disconnects from the middleware

Synopsis

client_exit

Environment

JetNet, Oracle Tuxedo

Scope

Client

Description

The client_exit command closes a connection between a client and the middleware.

When it closes a connection, Panther cleans up all resources associated with it. This includes aborting outstanding requests and rolling back incomplete transactions. It automatically terminates the connection to all resource managers.

client_exit sets the tp_return property to the number of connections actually closed.

If you have established a direct connection to an XA-compliant resource manager with the GROUP option of client_init, this command closes that connection.

Exceptions

The client_exit command can raise the following exceptions:

Exception Severity Cause 
TP_INVALID_CONNECTION
 
TP_COMMAND

No connection to close. 

TP_INVALID_SERVER_COMMAND
 
TP_COMMAND

Server attempts to use the command. 

TP_MONITOR_ERROR
 
TP_ERROR

Operating system error is detected. 

TP_XA_CLOSE_FAILED
 
TP_ERROR

Unable to close XA-connection resource managers.

See Also

client_init