The closeMatcher() method terminates a session between a client application and a Director matcher server.
Note: Failure to close the matcher session could cause degraded performance, memory leaks, or
loss of use of the server.
Syntax
public void closeMatcher(int handle, int retCode[]);Parameters
|
Name |
Type |
Use |
Length |
Description |
|---|---|---|---|---|
|
handle |
int |
In |
–– |
Handle to a Director matcher server instance. |
|
retCode |
int[ ] |
Out |
4 |
Error code that indicates status of method call. |
Return Values
Refer to Return Values.
Example
TrilTGenClient testClient = new TrilTGenClient();
int[] retCode= new int[1];
int handle = 0; // Return code and handle
char systemID = ‘G’; // System and Server ID for
attach()
String serverName = “RMatcher”;
// Attach operation is required with openMatcher()
handle = testClient.attach(systemID, serverName, retCode);
if (retCode[0] == 0) {
testClient.openMatcher(handle, retCode);
if (retCode[0] == 0) {
// Functional calls to matcher not shown
// Close matcher server
testClient.closeMatcher(handle, retCode);
// Release operation is required with closeMatcher()
testClient.release(handle, retCode);
}