openMatcher() - trillium_quality - 17.1

Trillium Director SDK Reference Guide

Product type
Software
Portfolio
Verify
Product family
Trillium
Product
Trillium > Trillium Quality
Version
17.1
Language
English
Product name
Trillium Quality
Title
Trillium Director SDK Reference Guide
Topic type
Administration
Overview
How Do I
Configuration
Reference
Installation
First publish date
2008

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);
}