Interrupting a Connection

When to interrupt a connection

If an OLAP API method is taking too long to execute, and it is acceptable for your application to break off its connection with the OLAP service, you can use the interrupt method on ConnectionInterrupter. Terminating a connection in this way is not a routine procedure, and you should use it only under extraordinary circumstances.

Preparing to use the interrupt method

Typically, an application runs in a thread that establishes a connection and executes queries. Your application must prepare for using the interrupt method by creating a second thread for interrupting the connection. The second thread waits for notification by the first thread that an interruption is needed.

Using the interrupt method

When the first thread tells the second thread to terminate the connection, the second thread does the following:

1. Calls the getRemoteStub method on the Connection object that represents the connection to be interrupted. The method returns the CORBA stub for the Connection.

2. Uses the constructor to create a new ConnectionInterrupter, specifying the CORBA stub for the Connection as a parameter.

3. Calls the interrupt method on the new ConnectionInterrupter to terminate the connection.