closeMatcher() - trillium_quality - 17.2

Trillium Director SDK Reference Guide

Product type
Software
Portfolio
Verify
Product family
Trillium
Product
Trillium > Trillium Quality
Version
17.2
Language
English
Product name
Trillium Quality
Title
Trillium Director SDK Reference Guide
Topic type
Administration
Overview
Installation
Reference
How Do I
Configuration
First publish date
2008
ft:lastEdition
2024-02-07
ft:lastPublication
2024-02-07T07:48:41.529641

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