The openMatcher() method initializes a session between a client application and a Director matcher server.
When openMatcher() is called, the maximum window size is returned from the matcher server to TGenClient. If a project has multiple Relationship Linker steps and each step specifies a different maximum window size, the matcher server returns the smallest value to the client.
Refer to addToMatchWindow() and setWindowSize() for additional information on setting and checking the maximum window size.
Syntax
public void openMatcher(int handle, int retCode[]);Parameters
|
Name |
Type |
Use |
Length |
Description |
|---|---|---|---|---|
|
handle |
int |
In |
–– |
Handle to a Director matcher server. |
|
retCode |
int[ ] |
Out |
4 |
Error code that indicates status of method call. |
Return Values
Refer to Return Values.
Example
TrilTGenClient testClient = new TrilTGenClient();
// Return code and handle
int[] retCode= new int[1];
int handle = 0;
// System and Server ID for attach()
char systemID = ‘G’;
String serverName = “RMatcher”;
// openMatcher() requires attach to server using attach()
handle = testClient.attach(systemID, serverName, retCode);
if (retCode[0] == 0) {
// Initialize session with matcher server using openMatcher()
testClient.openMatcher(handle, retCode);
if (retCode[0] == 0) {
// Perform relevant processing
}
// Close the matcher server
testClient.closeMatcher(handle, retCode);
// closeMatcher() requires release of server using release()
testClient.release(handle, retCode);
}