Sie sind auf Seite 1von 1041

Informatica MDM Registry Edition

(Version 9.5.3)

Developer Guide

Informatica MDM Registry Edition Developer Guide


Version 9.5.3
September 2013
Copyright (c) 1998-2013 Informatica Corporation. All rights reserved.
This software and documentation contain proprietary information of Informatica Corporation and are provided under a license agreement containing restrictions on use
and disclosure and are also protected by copyright law. Reverse engineering of the software is prohibited. No part of this document may be reproduced or transmitted in
any form, by any means (electronic, photocopying, recording or otherwise) without prior consent of Informatica Corporation. This Software may be protected by U.S.
and/or international Patents and other Patents Pending.
Use, duplication, or disclosure of the Software by the U.S. Government is subject to the restrictions set forth in the applicable software license agreement and as
provided in DFARS 227.7202-1(a) and 227.7702-3(a) (1995), DFARS 252.227-7013(1)(ii) (OCT 1988), FAR 12.212(a) (1995), FAR 52.227-19, or FAR 52.227-14
(ALT III), as applicable.
The information in this product or documentation is subject to change without notice. If you find any problems in this product or documentation, please report them to us
in writing.
Informatica, Informatica Platform, Informatica Data Services, PowerCenter, PowerCenterRT, PowerCenter Connect, PowerCenter Data Analyzer, PowerExchange,
PowerMart, Metadata Manager, Informatica Data Quality, Informatica Data Explorer, Informatica B2B Data Transformation, Informatica B2B Data Exchange Informatica
On Demand, Informatica Identity Resolution, Informatica Application Information Lifecycle Management, Informatica Complex Event Processing, Ultra Messaging and
Informatica Master Data Management are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world.
All other company and product names may be trade names or trademarks of their respective owners.
Portions of this software and/or documentation are subject to copyright held by third parties, including without limitation: Copyright DataDirect Technologies. All rights
reserved. Copyright Sun Microsystems. All rights reserved. Copyright RSA Security Inc. All Rights Reserved. Copyright Ordinal Technology Corp. All rights
reserved.Copyright Aandacht c.v. All rights reserved. Copyright Genivia, Inc. All rights reserved. Copyright Isomorphic Software. All rights reserved. Copyright Meta
Integration Technology, Inc. All rights reserved. Copyright Intalio. All rights reserved. Copyright Oracle. All rights reserved. Copyright Adobe Systems
Incorporated. All rights reserved. Copyright DataArt, Inc. All rights reserved. Copyright ComponentSource. All rights reserved. Copyright Microsoft Corporation. All
rights reserved. Copyright Rogue Wave Software, Inc. All rights reserved. Copyright Teradata Corporation. All rights reserved. Copyright Yahoo! Inc. All rights
reserved. Copyright Glyph & Cog, LLC. All rights reserved. Copyright Thinkmap, Inc. All rights reserved. Copyright Clearpace Software Limited. All rights
reserved. Copyright Information Builders, Inc. All rights reserved. Copyright OSS Nokalva, Inc. All rights reserved. Copyright Edifecs, Inc. All rights reserved.
Copyright Cleo Communications, Inc. All rights reserved. Copyright International Organization for Standardization 1986. All rights reserved. Copyright ejtechnologies GmbH. All rights reserved. Copyright Jaspersoft Corporation. All rights reserved. Copyright is International Business Machines Corporation. All rights
reserved. Copyright yWorks GmbH. All rights reserved. Copyright Lucent Technologies. All rights reserved. Copyright (c) University of Toronto. All rights reserved.
Copyright Daniel Veillard. All rights reserved. Copyright Unicode, Inc. Copyright IBM Corp. All rights reserved. Copyright MicroQuill Software Publishing, Inc. All
rights reserved. Copyright PassMark Software Pty Ltd. All rights reserved. Copyright LogiXML, Inc. All rights reserved. Copyright 2003-2010 Lorenzi Davide, All
rights reserved. Copyright Red Hat, Inc. All rights reserved. Copyright The Board of Trustees of the Leland Stanford Junior University. All rights reserved. Copyright
EMC Corporation. All rights reserved. Copyright Flexera Software. All rights reserved. Copyright Jinfonet Software. All rights reserved. Copyright Apple Inc. All
rights reserved. Copyright Telerik Inc. All rights reserved. Copyright BEA Systems. All rights reserved.
This product includes software developed by the Apache Software Foundation (http://www.apache.org/), and/or other software which is licensed under various versions
of the Apache License (the "License"). You may obtain a copy of these Licenses at http://www.apache.org/licenses/. Unless required by applicable law or agreed to in
writing, software distributed under these Licenses is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied. See the Licenses for the specific language governing permissions and limitations under the Licenses.
This product includes software which was developed by Mozilla (http://www.mozilla.org/), software copyright The JBoss Group, LLC, all rights reserved; software
copyright 1999-2006 by Bruno Lowagie and Paulo Soares and other software which is licensed under various versions of the GNU Lesser General Public License
Agreement, which may be found at http://www.gnu.org/licenses/lgpl.html. The materials are provided free of charge by Informatica, "as-is", without warranty of any kind,
either express or implied, including but not limited to the implied warranties of merchantability and fitness for a particular purpose.
The product includes ACE(TM) and TAO(TM) software copyrighted by Douglas C. Schmidt and his research group at Washington University, University of California,
Irvine, and Vanderbilt University, Copyright () 1993-2006, all rights reserved.
This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (copyright The OpenSSL Project. All Rights Reserved) and
redistribution of this software is subject to terms available at http://www.openssl.org and http://www.openssl.org/source/license.html.
This product includes Curl software which is Copyright 1996-2013, Daniel Stenberg, <daniel@haxx.se>. All Rights Reserved. Permissions and limitations regarding this
software are subject to terms available at http://curl.haxx.se/docs/copyright.html. Permission to use, copy, modify, and distribute this software for any purpose with or
without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
The product includes software copyright 2001-2005 () MetaStuff, Ltd. All Rights Reserved. Permissions and limitations regarding this software are subject to terms
available at http://www.dom4j.org/license.html.
The product includes software copyright 2004-2007, The Dojo Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to
terms available at http://dojotoolkit.org/license.
This product includes ICU software which is copyright International Business Machines Corporation and others. All rights reserved. Permissions and limitations
regarding this software are subject to terms available at http://source.icu-project.org/repos/icu/icu/trunk/license.html.
This product includes software copyright 1996-2006 Per Bothner. All rights reserved. Your right to use such materials is set forth in the license which may be found at
http:// www.gnu.org/software/kawa/Software-License.html.
This product includes OSSP UUID software which is Copyright 2002 Ralf S. Engelschall, Copyright 2002 The OSSP Project Copyright 2002 Cable & Wireless
Deutschland. Permissions and limitations regarding this software are subject to terms available at http://www.opensource.org/licenses/mit-license.php.
This product includes software developed by Boost (http://www.boost.org/) or under the Boost software license. Permissions and limitations regarding this software are
subject to terms available at http://www.boost.org/LICENSE_1_0.txt.
This product includes software copyright 1997-2007 University of Cambridge. Permissions and limitations regarding this software are subject to terms available at
http://www.pcre.org/license.txt.
This product includes software copyright 2007 The Eclipse Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to terms
available at http://www.eclipse.org/org/documents/epl-v10.php and at http://www.eclipse.org/org/documents/edl-v10.php.
This product includes software licensed under the terms at http://www.tcl.tk/software/tcltk/license.html, http://www.bosrup.com/web/overlib/?License, http://
www.stlport.org/doc/license.html, http://asm.ow2.org/license.html, http://www.cryptix.org/LICENSE.TXT, http://hsqldb.org/web/hsqlLicense.html, http://
httpunit.sourceforge.net/doc/license.html, http://jung.sourceforge.net/license.txt , http://www.gzip.org/zlib/zlib_license.html, http://www.openldap.org/software/release/
license.html, http://www.libssh2.org, http://slf4j.org/license.html, http://www.sente.ch/software/OpenSourceLicense.html, http://fusesource.com/downloads/licenseagreements/fuse-message-broker-v-5-3- license-agreement; http://antlr.org/license.html; http://aopalliance.sourceforge.net/; http://www.bouncycastle.org/licence.html;

http://www.jgraph.com/jgraphdownload.html; http://www.jcraft.com/jsch/LICENSE.txt; http://jotm.objectweb.org/bsd_license.html; . http://www.w3.org/Consortium/Legal/


2002/copyright-software-20021231; http://www.slf4j.org/license.html; http://nanoxml.sourceforge.net/orig/copyright.html; http://www.json.org/license.html; http://
forge.ow2.org/projects/javaservice/, http://www.postgresql.org/about/licence.html, http://www.sqlite.org/copyright.html, http://www.tcl.tk/software/tcltk/license.html, http://
www.jaxen.org/faq.html, http://www.jdom.org/docs/faq.html, http://www.slf4j.org/license.html; http://www.iodbc.org/dataspace/iodbc/wiki/iODBC/License; http://
www.keplerproject.org/md5/license.html; http://www.toedter.com/en/jcalendar/license.html; http://www.edankert.com/bounce/index.html; http://www.net-snmp.org/about/
license.html; http://www.openmdx.org/#FAQ; http://www.php.net/license/3_01.txt; http://srp.stanford.edu/license.txt; http://www.schneier.com/blowfish.html; http://
www.jmock.org/license.html; http://xsom.java.net; and http://benalman.com/about/license/; https://github.com/CreateJS/EaselJS/blob/master/src/easeljs/display/
Bitmap.js; http://www.h2database.com/html/license.html#summary; http://jsoncpp.sourceforge.net/LICENSE; http://jdbc.postgresql.org/license.html; and http://
protobuf.googlecode.com/svn/trunk/src/google/protobuf/descriptor.proto.
This product includes software licensed under the Academic Free License (http://www.opensource.org/licenses/afl-3.0.php), the Common Development and Distribution
License (http://www.opensource.org/licenses/cddl1.php) the Common Public License (http://www.opensource.org/licenses/cpl1.0.php), the Sun Binary Code License
Agreement Supplemental License Terms, the BSD License (http://www.opensource.org/licenses/bsd-license.php) the MIT License (http://www.opensource.org/licenses/
mit-license.php), the Artistic License (http://www.opensource.org/licenses/artistic-license-1.0) and the Initial Developers Public License Version 1.0 (http://
www.firebirdsql.org/en/initial-developer-s-public-license-version-1-0/).
This product includes software copyright 2003-2006 Joe WaInes, 2006-2007 XStream Committers. All rights reserved. Permissions and limitations regarding this
software are subject to terms available at http://xstream.codehaus.org/license.html. This product includes software developed by the Indiana University Extreme! Lab.
For further information please visit http://www.extreme.indiana.edu/.
This product includes software Copyright (c) 2013 Frank Balluffi and Markus Moeller. All rights reserved. Permissions and limitations regarding this software are subject
to terms of the MIT license.
This Software is protected by U.S. Patent Numbers 5,794,246; 6,014,670; 6,016,501; 6,029,178; 6,032,158; 6,035,307; 6,044,374; 6,092,086; 6,208,990; 6,339,775;
6,640,226; 6,789,096; 6,820,077; 6,823,373; 6,850,947; 6,895,471; 7,117,215; 7,162,643; 7,243,110, 7,254,590; 7,281,001; 7,421,458; 7,496,588; 7,523,121;
7,584,422; 7676516; 7,720,842; 7,721,270; and 7,774,791, international Patents and other Patents Pending.
DISCLAIMER: Informatica Corporation provides this documentation "as is" without warranty of any kind, either express or implied, including, but not limited to, the
implied warranties of noninfringement, merchantability, or use for a particular purpose. Informatica Corporation does not warrant that this software or documentation is
error free. The information provided in this software or documentation may include technical inaccuracies or typographical errors. The information in this software and
documentation is subject to change at any time without notice.
NOTICES
This Informatica product (the Software) includes certain drivers (the DataDirect Drivers) from DataDirect Technologies, an operating company of Progress Software
Corporation (DataDirect) which are subject to the following terms and conditions:
1. THE DATADIRECT DRIVERS ARE PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
2. IN NO EVENT WILL DATADIRECT OR ITS THIRD PARTY SUPPLIERS BE LIABLE TO THE END-USER CUSTOMER FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, CONSEQUENTIAL OR OTHER DAMAGES ARISING OUT OF THE USE OF THE ODBC DRIVERS, WHETHER OR NOT
INFORMED OF THE POSSIBILITIES OF DAMAGES IN ADVANCE. THESE LIMITATIONS APPLY TO ALL CAUSES OF ACTION, INCLUDING, WITHOUT
LIMITATION, BREACH OF CONTRACT, BREACH OF WARRANTY, NEGLIGENCE, STRICT LIABILITY, MISREPRESENTATION AND OTHER TORTS.
Part Number: MRE-DEV-95300-0002

Contents
Table of Contents

Introduction
Process Overview
Concepts . . . . .
Connections
Sessions . . .
Systems . . .
Searches . .
Basic API . . . . .
Advanced API . .

35
.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

36
36
36
36
36
36
36
37

Sample API Programs


Sample System . . . . . . . . . . . . . . . . . . . . . . . .
Directory Structure . . . . . . . . . . . . . . . . . .
Population . . . . . . . . . . . . . . . . . . . . . . .
Installing . . . . . . . . . . . . . . . . . . . . . . . .
IDT Layout . . . . . . . . . . . . . . . . . . . . . . .
Building the Programs . . . . . . . . . . . . . . . .
Language specific notes . . . . . . . . . . .
Running the Samples . . . . . . . . . . . . . . . . .
C . . . . . . . . . . . . . . . . . . . . . . . .
ColdFusion . . . . . . . . . . . . . . . . . .
C# . . . . . . . . . . . . . . . . . . . . . . . .
Java . . . . . . . . . . . . . . . . . . . . . . .
MS SQL . . . . . . . . . . . . . . . . . . . .
Perl . . . . . . . . . . . . . . . . . . . . . . .
Oracle and PL/SQL . . . . . . . . . . . . .
Power Builder . . . . . . . . . . . . . . . . .
VB6 . . . . . . . . . . . . . . . . . . . . . . .
VB6 OCX . . . . . . . . . . . . . . . . . . . .
VB.NET . . . . . . . . . . . . . . . . . . . .
Sample 1 - Basic API . . . . . . . . . . . . . . . . . . . .
Logic . . . . . . . . . . . . . . . . . . . . . . . . . .
Open a socket to the Search Server . . . . .
Open a System and start a Search . . . . . .
Retrieve Result Set . . . . . . . . . . . . . .
Terminate the Search and close the System
Disconnect from the Search Server . . . . .
Sample 2 - Advanced API . . . . . . . . . . . . . . . . .
Logic . . . . . . . . . . . . . . . . . . . . . . . . . .
Open a socket to the Connection Server . .
Open a Session . . . . . . . . . . . . . . . .
Open a System . . . . . . . . . . . . . . . .
Retrieve the Input-View layout . . . . . . .
for each Search . . . . . . . . . . . . . . . .
Close System . . . . . . . . . . . . . . . . .
Close Session (optional) . . . . . . . . . . .
Disconnect from the Connection Server . .
PIDSearch - Persistance ID search API . . . . . . . . . .
Logic . . . . . . . . . . . . . . . . . . . . . . . . . .
Open a socket to the Search Server . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

38
38
38
38
38
39
39
39
40
40
40
40
41
41
41
41
42
42
42
42
42
42
42
43
43
43
43
43
43
43
44
44
44
44
45
45
45
45
46
46

CONTENTS

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

Open a System . . . . . . . . . . . . . . . . . . . . .
Identify the persistent ID search to use . . . . . . .
Get name of the IDT associated with the PID search
Identify the runnable search to use . . . . . . . . . .
Construct search record . . . . . . . . . . . . . . . .
Retrieve the Input-View layout . . . . . . . . . . . .
Start a search . . . . . . . . . . . . . . . . . . . . . .
Get preferred records . . . . . . . . . . . . . . . . . .
For each record in preferred records . . . . . . . . .
End Loop . . . . . . . . . . . . . . . . . . . . . . . .
Finish Search . . . . . . . . . . . . . . . . . . . . . .
Terminate the Search and close the System . . . . .
Disconnect from the Search Server . . . . . . . . . .
API Reference
Data Types . . . . . .
Strings . . . . .
String Arrays .
Blocks . . . . . .
Block Arrays . .
Nulls and NULs
Error Handling . . .

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

46
46
46
46
47
47
47
47
48
48
48
48
48

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

49
49
49
49
50
50
50
50

Constants . . . .
Parameter types .
ids_addr_get_cass_field . . .
ids_addr_get_cass_field_cnt .
ids_addr_get_cass_field_info
ids_addr_get_del_lines_ext .
ids_addr_get_field . . . . . .
ids_addr_get_field_count . .
ids_addr_get_field_ext . . . .
ids_addr_get_field_idx . . . .
ids_addr_get_field_info_ext .
ids_addr_get_field_len . . . .
ids_addr_get_line_len . . . .
ids_addr_get_option . . . . .
ids_addr_info . . . . . . . . .
ids_addr_init . . . . . . . . . .
ids_addr_parse . . . . . . . .
ids_addr_preload_country . .
ids_addr_set_attrib . . . . . .
ids_addr_set_del_lines . . . .
ids_addr_set_field_case . . .
ids_addr_set_field_ext . . . .
ids_addr_set_field_idx . . . .
ids_addr_set_field_name . . .
ids_addr_set_lines . . . . . . .
ids_addr_set_option . . . . .
ids_addr_std . . . . . . . . . .
ids_addr_validate . . . . . . .
ids_connect . . . . . . . . . . .
ids_disconnect . . . . . . . . .
ids_error_get . . . . . . . . . .
ids_errors_get_all . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

51
51
51
51
52
52
53
54
54
55
56
56
57
57
58
58
59
59
60
60
61
62
62
63
64
64
65
66
67
67
68
68
69

CONTENTS

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

Calling from C

ids_identify . . . . . . . . . . . .
ids_is_little_endian . . . . . . . .
ids_match_explain . . . . . . . .
ids_match_explain_count . . . .
ids_pid_close . . . . . . . . . . .
ids_pid_member_count . . . . .
ids_pid_member_get . . . . . . .
ids_pid_open . . . . . . . . . . .
ids_pid_search_get . . . . . . . .
ids_pid_search_get_clusters . . .
ids_pid_src_pk_get . . . . . . . .
ids_pid_src_pk_start . . . . . . .
ids_ps_get_entity_list . . . . . . .
ids_ps_get_entity_max_elements
ids_ps_get_entity_max_length . .
ids_ps_parse . . . . . . . . . . . .
ids_ps_set_encoding . . . . . . .
ids_ps_set_entity_list . . . . . . .
ids_ps_set_population . . . . . .
ids_real_time_async_get . . . . .
ids_real_time_async_start . . . .
ids_real_time_flul_add . . . . . .
ids_real_time_flul_close . . . . .
ids_real_time_flul_delete . . . . .
ids_real_time_flul_find_rule . . .
ids_real_time_flul_get_rule . . .
ids_real_time_flul_init . . . . . .
ids_real_time_sync_get . . . . . .
ids_real_time_sync_start . . . . .
ids_scores_get . . . . . . . . . . .
ids_search_comment_get . . . . .
ids_search_dedupe_start . . . . .
ids_search_fields_count . . . . .
ids_search_fields_get . . . . . . .
ids_search_filter . . . . . . . . . .
ids_search_finish . . . . . . . . .
ids_search_get . . . . . . . . . . .
ids_search_get_complete . . . . .
ids_search_get_detail . . . . . . .
ids_search_IDT_get . . . . . . . .
ids_search_layout . . . . . . . . .
ids_search_start . . . . . . . . . .
ids_search_tolerances_count . . .
ids_search_tolerances_get . . . .
ids_search_view_get . . . . . . .
ids_search_view_set . . . . . . .
ids_search_widths_count . . . . .
ids_search_widths_get . . . . . .
ids_server_version_get . . . . . .
ids_session_close . . . . . . . . .
ids_session_open . . . . . . . . .
ids_set_encoding . . . . . . . . .
ids_set_vpd_user . . . . . . . . .
ids_system_close . . . . . . . . .
ids_system_idtname_count . . .
5

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

69
70
70
71
71
72
72
73
74
74
75
76
76
77
77
78
78
79
79
80
81
82
83
83
84
84
85
85
86
87
88
88
89
90
90
91
91
92
93
94
94
96
97
98
98
99
99
100
100
101
101
102
102
103
103

ids_system_idtname_get . . . .
ids_system_notify . . . . . . . .
ids_system_open . . . . . . . .
ids_system_pid_searches_count
ids_system_pid_searches_get .
ids_system_search_finish . . . .
ids_system_search_start . . . .
ids_system_searches_count . .
ids_system_searches_get . . . .
ids_systems_count . . . . . . .
ids_systems_get . . . . . . . . .
Calling from C without Arrays
Constants . . . .
Parameter types .
ids_addr_get_cass_field . . .
ids_addr_get_cass_field_cnt .
ids_addr_get_cass_field_info
ids_addr_get_del_lines_ext .
ids_addr_get_field . . . . . .
ids_addr_get_field_count . .
ids_addr_get_field_ext . . . .
ids_addr_get_field_idx . . . .
ids_addr_get_field_info_ext .
ids_addr_get_field_len . . . .
ids_addr_get_line_len . . . .
ids_addr_get_option . . . . .
ids_addr_info . . . . . . . . .
ids_addr_init . . . . . . . . . .
ids_addr_parse . . . . . . . .
ids_addr_preload_country . .
ids_addr_set_attrib . . . . . .
ids_addr_set_del_lines . . . .
ids_addr_set_field_case . . .
ids_addr_set_field_ext . . . .
ids_addr_set_field_idx . . . .
ids_addr_set_field_name . . .
ids_addr_set_lines . . . . . . .
ids_addr_set_option . . . . .
ids_addr_std . . . . . . . . . .
ids_addr_validate . . . . . . .
ids_connect . . . . . . . . . . .
ids_disconnect . . . . . . . . .
ids_error_get . . . . . . . . . .
ids_errors_get_all . . . . . . .
ids_identify . . . . . . . . . .
ids_is_little_endian . . . . . .
ids_match_explain . . . . . .
ids_match_explain_count . .
ids_pid_close . . . . . . . . .
ids_pid_member_count . . .
ids_pid_member_get . . . . .
ids_pid_open . . . . . . . . .
ids_pid_search_get . . . . . .
ids_pid_search_get_clusters .
ids_pid_src_pk_get . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

104
104
105
106
106
107
107
108
109
109
110

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

111
111
111
111
112
112
113
114
114
115
115
116
117
117
118
118
119
119
120
120
121
121
122
123
123
124
125
125
126
126
127
127
128
128
129
129
130
131
131
132
132
133
133
134

CONTENTS

ids_pid_src_pk_start . . . . . . .
ids_ps_get_entity_list . . . . . . .
ids_ps_get_entity_max_elements
ids_ps_get_entity_max_length . .
ids_ps_parse . . . . . . . . . . . .
ids_ps_set_encoding . . . . . . .
ids_ps_set_entity_list . . . . . . .
ids_ps_set_population . . . . . .
ids_real_time_async_get . . . . .
ids_real_time_async_start . . . .
ids_real_time_flul_add . . . . . .
ids_real_time_flul_close . . . . .
ids_real_time_flul_delete . . . . .
ids_real_time_flul_find_rule . . .
ids_real_time_flul_get_rule . . .
ids_real_time_flul_init . . . . . .
ids_real_time_sync_get . . . . . .
ids_real_time_sync_start . . . . .
ids_scores_get . . . . . . . . . . .
ids_search_comment_get . . . . .
ids_search_dedupe_start . . . . .
ids_search_fields_count . . . . .
ids_search_fields_get . . . . . . .
ids_search_filter . . . . . . . . . .
ids_search_finish . . . . . . . . .
ids_search_get . . . . . . . . . . .
ids_search_get_complete . . . . .
ids_search_get_detail . . . . . . .
ids_search_IDT_get . . . . . . . .
ids_search_layout . . . . . . . . .
ids_search_start . . . . . . . . . .
ids_search_tolerances_count . . .
ids_search_tolerances_get . . . .
ids_search_view_get . . . . . . .
ids_search_view_set . . . . . . .
ids_search_widths_count . . . . .
ids_search_widths_get . . . . . .
ids_server_version_get . . . . . .
ids_session_close . . . . . . . . .
ids_session_open . . . . . . . . .
ids_set_encoding . . . . . . . . .
ids_set_vpd_user . . . . . . . . .
ids_system_close . . . . . . . . .
ids_system_idtname_count . . .
ids_system_idtname_get . . . . .
ids_system_notify . . . . . . . . .
ids_system_open . . . . . . . . .
ids_system_pid_searches_count .
ids_system_pid_searches_get . .
ids_system_search_finish . . . . .
ids_system_search_start . . . . .
ids_system_searches_count . . .
ids_system_searches_get . . . . .
ids_systems_count . . . . . . . .
ids_systems_get . . . . . . . . . .
7

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

135
135
136
136
137
137
138
138
139
140
141
141
142
142
143
143
144
145
146
146
147
148
148
149
149
150
151
152
152
153
154
155
156
156
157
158
158
159
159
159
160
160
161
161
162
162
163
164
164
165
165
166
166
167
167

Calling from C#
Installation - Win32 client
Constants . . . . . . . . .
Response code . . . . . .
Parameter types . . . . . .
Constructor . . . . . . . . . . . . . . .
addr_get_cass_field . . . . . . . . . . .
addr_get_cass_field_cnt . . . . . . . .
addr_get_cass_field_info . . . . . . . .
addr_get_del_lines_ext . . . . . . . . .
addr_get_field . . . . . . . . . . . . . .
addr_get_field_count . . . . . . . . . .
addr_get_field_ext . . . . . . . . . . .
addr_get_field_idx . . . . . . . . . . .
addr_get_field_info_ext . . . . . . . .
addr_get_field_len . . . . . . . . . . .
addr_get_line_len . . . . . . . . . . . .
addr_get_option . . . . . . . . . . . . .
addr_info . . . . . . . . . . . . . . . . .
addr_init . . . . . . . . . . . . . . . . .
addr_parse . . . . . . . . . . . . . . . .
addr_preload_country . . . . . . . . .
addr_set_attrib . . . . . . . . . . . . . .
addr_set_del_lines . . . . . . . . . . .
addr_set_field_case . . . . . . . . . . .
addr_set_field_ext . . . . . . . . . . . .
addr_set_field_idx . . . . . . . . . . .
addr_set_field_name . . . . . . . . . .
addr_set_lines . . . . . . . . . . . . . .
addr_set_option . . . . . . . . . . . . .
addr_std . . . . . . . . . . . . . . . . .
addr_validate . . . . . . . . . . . . . .
disconnect . . . . . . . . . . . . . . . .
error_get . . . . . . . . . . . . . . . . .
errors_get_all . . . . . . . . . . . . . .
identify . . . . . . . . . . . . . . . . . .
is_little_endian . . . . . . . . . . . . .
match_explain . . . . . . . . . . . . . .
match_explain_count . . . . . . . . . .
pid_close . . . . . . . . . . . . . . . . .
pid_member_count . . . . . . . . . . .
pid_member_get . . . . . . . . . . . .
pid_open . . . . . . . . . . . . . . . . .
pid_search_get . . . . . . . . . . . . . .
pid_search_get_clusters . . . . . . . .
pid_src_pk_get . . . . . . . . . . . . .
pid_src_pk_start . . . . . . . . . . . . .
ps_get_entity_list . . . . . . . . . . . .
ps_get_entity_max_elements . . . . .
ps_get_entity_max_length . . . . . . .
ps_parse . . . . . . . . . . . . . . . . .
ps_set_encoding . . . . . . . . . . . . .
ps_set_entity_list . . . . . . . . . . . .
ps_set_population . . . . . . . . . . . .
real_time_async_get . . . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

169
169
169
169
169
169
170
170
171
171
172
173
173
174
174
175
175
176
176
177
177
178
178
179
180
180
181
181
182
183
183
184
184
185
185
186
186
187
187
188
188
189
189
190
191
191
192
192
192
193
193
194
195
195
196

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

real_time_async_start . . . .
real_time_flul_add . . . . .
real_time_flul_close . . . . .
real_time_flul_delete . . . .
real_time_flul_find_rule . .
real_time_flul_get_rule . . .
real_time_flul_init . . . . . .
real_time_sync_get . . . . .
real_time_sync_start . . . .
scores_get . . . . . . . . . .
search_comment_get . . . .
search_dedupe_start . . . .
search_fields_count . . . . .
search_fields_get . . . . . .
search_filter . . . . . . . . .
search_finish . . . . . . . . .
search_get . . . . . . . . . .
search_get_complete . . . .
search_get_detail . . . . . .
search_IDT_get . . . . . . .
search_layout . . . . . . . .
search_start . . . . . . . . .
search_tolerances_count . .
search_tolerances_get . . . .
search_view_get . . . . . . .
search_view_set . . . . . . .
search_widths_count . . . .
search_widths_get . . . . . .
server_version_get . . . . .
session_close . . . . . . . . .
session_open . . . . . . . . .
set_encoding . . . . . . . . .
set_vpd_user . . . . . . . . .
system_close . . . . . . . . .
system_idtname_count . . .
system_idtname_get . . . .
system_notify . . . . . . . .
system_open . . . . . . . . .
system_pid_searches_count
system_pid_searches_get . .
system_search_finish . . . .
system_search_start . . . . .
system_searches_count . . .
system_searches_get . . . .
systems_count . . . . . . . .
systems_get . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

196
197
198
199
199
200
200
201
201
203
203
204
205
205
206
206
207
207
208
209
209
210
211
212
212
213
214
214
215
215
215
216
216
217
217
218
218
219
219
220
220
221
222
222
223
223

Calling from Cobol (z/OS)


Constants . . . . . . . . . . . . . .
Installation . . . . . . . . . . . . . .
Installation (TSO/batch) . . . . . .
Installation (CICS) -static calls . .
Installation (CICS) - dynamic calls
Defining programs to CICS . . . .
Parameter types . . . . . . . . . . .
IDS-ADDR-GET-CASS-FIELD . . . . . . . . . .

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

224
224
224
224
225
225
225
225
226

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

IDS-ADDR-GET-CASS-FIELD-CNT . .
IDS-ADDR-GET-CASS-FIELD-INFO . .
IDS-ADDR-GET-DEL-LINES-EXT . . .
IDS-ADDR-GET-FIELD . . . . . . . . . .
IDS-ADDR-GET-FIELD-COUNT . . . .
IDS-ADDR-GET-FIELD-EXT . . . . . . .
IDS-ADDR-GET-FIELD-IDX . . . . . . .
IDS-ADDR-GET-FIELD-INFO-EXT . . .
IDS-ADDR-GET-FIELD-LEN . . . . . .
IDS-ADDR-GET-LINE-LEN . . . . . . .
IDS-ADDR-GET-OPTION . . . . . . . .
IDS-ADDR-INFO . . . . . . . . . . . . .
IDS-ADDR-INIT . . . . . . . . . . . . . .
IDS-ADDR-PARSE . . . . . . . . . . . .
IDS-ADDR-PRELOAD-COUNTRY . . .
IDS-ADDR-SET-ATTRIB . . . . . . . . .
IDS-ADDR-SET-DEL-LINES . . . . . . .
IDS-ADDR-SET-FIELD-CASE . . . . . .
IDS-ADDR-SET-FIELD-EXT . . . . . . .
IDS-ADDR-SET-FIELD-IDX . . . . . . .
IDS-ADDR-SET-FIELD-NAME . . . . .
IDS-ADDR-SET-LINES . . . . . . . . . .
IDS-ADDR-SET-OPTION . . . . . . . .
IDS-ADDR-STD . . . . . . . . . . . . . .
IDS-ADDR-VALIDATE . . . . . . . . . .
IDS-CONNECT . . . . . . . . . . . . . .
IDS-DISCONNECT . . . . . . . . . . . .
IDS-ERROR-GET . . . . . . . . . . . . .
IDS-ERRORS-GET-ALL . . . . . . . . . .
IDS-IDENTIFY . . . . . . . . . . . . . . .
IDS-IS-LITTLE-ENDIAN . . . . . . . . .
IDS-MATCH-EXPLAIN . . . . . . . . .
IDS-MATCH-EXPLAIN-COUNT . . . .
IDS-PID-CLOSE . . . . . . . . . . . . . .
IDS-PID-MEMBER-COUNT . . . . . . .
IDS-PID-MEMBER-GET . . . . . . . . .
IDS-PID-OPEN . . . . . . . . . . . . . .
IDS-PID-SEARCH-GET . . . . . . . . . .
IDS-PID-SEARCH-GET-CLUSTERS . .
IDS-PID-SRC-PK-GET . . . . . . . . . .
IDS-PID-SRC-PK-START . . . . . . . . .
IDS-PS-GET-ENTITY-LIST . . . . . . . .
IDS-PS-GET-ENTITY-MAX-ELEMENTS
IDS-PS-GET-ENTITY-MAX-LENGTH .
IDS-PS-PARSE . . . . . . . . . . . . . . .
IDS-PS-SET-ENCODING . . . . . . . . .
IDS-PS-SET-ENTITY-LIST . . . . . . . .
IDS-PS-SET-POPULATION . . . . . . .
IDS-REAL-TIME-ASYNC-GET . . . . .
IDS-REAL-TIME-ASYNC-START . . . .
IDS-REAL-TIME-FLUL-ADD . . . . . .
IDS-REAL-TIME-FLUL-CLOSE . . . . .
IDS-REAL-TIME-FLUL-DELETE . . . .
IDS-REAL-TIME-FLUL-FIND-RULE . .
IDS-REAL-TIME-FLUL-GET-RULE . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

226
227
227
228
229
229
230
231
231
232
232
233
233
234
234
235
236
236
237
237
238
238
239
240
241
241
242
242
243
243
244
244
245
245
246
246
247
248
248
249
250
250
251
251
252
252
253
253
254
255
256
256
257
257
258
10

IDS-REAL-TIME-FLUL-INIT . . . . . .
IDS-REAL-TIME-SYNC-GET . . . . . .
IDS-REAL-TIME-SYNC-START . . . . .
IDS-SCORES-GET . . . . . . . . . . . . .
IDS-SEARCH-COMMENT-GET . . . . .
IDS-SEARCH-DEDUPE-START . . . . .
IDS-SEARCH-FIELDS-COUNT . . . . .
IDS-SEARCH-FIELDS-GET . . . . . . .
IDS-SEARCH-FILTER . . . . . . . . . . .
IDS-SEARCH-FINISH . . . . . . . . . .
IDS-SEARCH-GET . . . . . . . . . . . .
IDS-SEARCH-GET-COMPLETE . . . . .
IDS-SEARCH-GET-DETAIL . . . . . . .
IDS-SEARCH-IDT-GET . . . . . . . . . .
IDS-SEARCH-LAYOUT . . . . . . . . .
IDS-SEARCH-START . . . . . . . . . . .
IDS-SEARCH-TOLERANCES-COUNT .
IDS-SEARCH-TOLERANCES-GET . . .
IDS-SEARCH-VIEW-GET . . . . . . . .
IDS-SEARCH-VIEW-SET . . . . . . . . .
IDS-SEARCH-WIDTHS-COUNT . . . .
IDS-SEARCH-WIDTHS-GET . . . . . .
IDS-SERVER-VERSION-GET . . . . . .
IDS-SESSION-CLOSE . . . . . . . . . . .
IDS-SESSION-OPEN . . . . . . . . . . .
IDS-SET-ENCODING . . . . . . . . . . .
IDS-SET-VPD-USER . . . . . . . . . . .
IDS-SYSTEM-CLOSE . . . . . . . . . . .
IDS-SYSTEM-IDTNAME-COUNT . . .
IDS-SYSTEM-IDTNAME-GET . . . . . .
IDS-SYSTEM-NOTIFY . . . . . . . . . .
IDS-SYSTEM-OPEN . . . . . . . . . . .
IDS-SYSTEM-PID-SEARCHES-COUNT
IDS-SYSTEM-PID-SEARCHES-GET . .
IDS-SYSTEM-SEARCH-FINISH . . . . .
IDS-SYSTEM-SEARCH-START . . . . .
IDS-SYSTEM-SEARCHES-COUNT . . .
IDS-SYSTEM-SEARCHES-GET . . . . .
IDS-SYSTEMS-COUNT . . . . . . . . . .
IDS-SYSTEMS-GET . . . . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

258
259
260
261
261
262
263
263
264
264
265
266
267
267
268
269
270
271
271
272
273
273
274
274
275
275
276
276
277
277
278
278
279
279
280
280
281
282
282
283

Calling from ColdFusion with an ActiveX Control


Constants . . . . . . . . . . . . . . .
Parameter types . . . . . . . . . . . .
ids_addr_get_cass_field . . . . . . . . . . . . . .
ids_addr_get_cass_field_cnt . . . . . . . . . . . .
ids_addr_get_cass_field_info . . . . . . . . . . .
ids_addr_get_del_lines_ext . . . . . . . . . . . .
ids_addr_get_field . . . . . . . . . . . . . . . . .
ids_addr_get_field_count . . . . . . . . . . . . .
ids_addr_get_field_ext . . . . . . . . . . . . . . .
ids_addr_get_field_idx . . . . . . . . . . . . . . .
ids_addr_get_field_info_ext . . . . . . . . . . . .
ids_addr_get_field_len . . . . . . . . . . . . . . .
ids_addr_get_line_len . . . . . . . . . . . . . . .
ids_addr_get_option . . . . . . . . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.

284
284
284
284
285
285
286
286
287
287
288
289
289
290
290

11

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

ids_addr_info . . . . . . . . . . .
ids_addr_init . . . . . . . . . . . .
ids_addr_parse . . . . . . . . . .
ids_addr_preload_country . . . .
ids_addr_set_attrib . . . . . . . .
ids_addr_set_del_lines . . . . . .
ids_addr_set_field_case . . . . .
ids_addr_set_field_ext . . . . . .
ids_addr_set_field_idx . . . . . .
ids_addr_set_field_name . . . . .
ids_addr_set_lines . . . . . . . . .
ids_addr_set_option . . . . . . .
ids_addr_std . . . . . . . . . . . .
ids_addr_validate . . . . . . . . .
ids_connect . . . . . . . . . . . . .
ids_disconnect . . . . . . . . . . .
ids_error_get . . . . . . . . . . . .
ids_errors_get_all . . . . . . . . .
ids_identify . . . . . . . . . . . .
ids_is_little_endian . . . . . . . .
ids_match_explain . . . . . . . .
ids_match_explain_count . . . .
ids_pid_close . . . . . . . . . . .
ids_pid_member_count . . . . .
ids_pid_member_get . . . . . . .
ids_pid_open . . . . . . . . . . .
ids_pid_search_get . . . . . . . .
ids_pid_search_get_clusters . . .
ids_pid_src_pk_get . . . . . . . .
ids_pid_src_pk_start . . . . . . .
ids_ps_get_entity_list . . . . . . .
ids_ps_get_entity_max_elements
ids_ps_get_entity_max_length . .
ids_ps_parse . . . . . . . . . . . .
ids_ps_set_encoding . . . . . . .
ids_ps_set_entity_list . . . . . . .
ids_ps_set_population . . . . . .
ids_real_time_async_get . . . . .
ids_real_time_async_start . . . .
ids_real_time_flul_add . . . . . .
ids_real_time_flul_close . . . . .
ids_real_time_flul_delete . . . . .
ids_real_time_flul_find_rule . . .
ids_real_time_flul_get_rule . . .
ids_real_time_flul_init . . . . . .
ids_real_time_sync_get . . . . . .
ids_real_time_sync_start . . . . .
ids_scores_get . . . . . . . . . . .
ids_search_comment_get . . . . .
ids_search_dedupe_start . . . . .
ids_search_fields_count . . . . .
ids_search_fields_get . . . . . . .
ids_search_filter . . . . . . . . . .
ids_search_finish . . . . . . . . .
ids_search_get . . . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

291
291
292
292
293
293
294
294
295
295
296
297
297
298
298
299
299
300
300
301
301
302
303
303
303
304
304
305
306
306
307
307
308
308
309
309
310
310
311
312
312
313
313
314
314
315
316
317
317
318
319
319
320
320
321
12

ids_search_get_complete . . . .
ids_search_get_detail . . . . . .
ids_search_IDT_get . . . . . . .
ids_search_layout . . . . . . . .
ids_search_start . . . . . . . . .
ids_search_tolerances_count . .
ids_search_tolerances_get . . .
ids_search_view_get . . . . . .
ids_search_view_set . . . . . .
ids_search_widths_count . . . .
ids_search_widths_get . . . . .
ids_server_version_get . . . . .
ids_session_close . . . . . . . .
ids_session_open . . . . . . . .
ids_set_encoding . . . . . . . .
ids_set_vpd_user . . . . . . . .
ids_system_close . . . . . . . .
ids_system_idtname_count . .
ids_system_idtname_get . . . .
ids_system_notify . . . . . . . .
ids_system_open . . . . . . . .
ids_system_pid_searches_count
ids_system_pid_searches_get .
ids_system_search_finish . . . .
ids_system_search_start . . . .
ids_system_searches_count . .
ids_system_searches_get . . . .
ids_systems_count . . . . . . .
ids_systems_get . . . . . . . . .
Calling from Java
Java Version . . . . . . . . . .
Overview . . . . . . . . . . . .
Constants . . . . . . . . .
Parameter types . . . . .
Error Handling . . . . . . . .
Deprecated APIs . . . . . . . .
ClieSock Constructor . . . . .
ids_addr_get_cass_field . . .
ids_addr_get_cass_field_cnt .
ids_addr_get_cass_field_info
ids_addr_get_del_lines_ext .
ids_addr_get_field . . . . . .
ids_addr_get_field_count . .
ids_addr_get_field_ext . . . .
ids_addr_get_field_idx . . . .
ids_addr_get_field_info_ext .
ids_addr_get_field_len . . . .
ids_addr_get_line_len . . . .
ids_addr_get_option . . . . .
ids_addr_info . . . . . . . . .
ids_addr_init . . . . . . . . . .
ids_addr_parse . . . . . . . .
ids_addr_preload_country . .
ids_addr_set_attrib . . . . . .
ids_addr_set_del_lines . . . .
13

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

322
322
323
324
325
326
327
327
328
328
329
329
330
330
330
331
331
332
332
333
333
334
334
335
335
336
337
337
338

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

339
339
339
339
339
339
341
341
342
343
343
344
345
345
346
346
347
348
348
349
349
350
350
351
351
352

ids_addr_set_field_case . . . . .
ids_addr_set_field_ext . . . . . .
ids_addr_set_field_idx . . . . . .
ids_addr_set_field_name . . . . .
ids_addr_set_lines . . . . . . . . .
ids_addr_set_option . . . . . . .
ids_addr_std . . . . . . . . . . . .
ids_addr_validate . . . . . . . . .
ids_disconnect . . . . . . . . . . .
ids_error_get . . . . . . . . . . . .
ids_errors_get_all . . . . . . . . .
ids_identify . . . . . . . . . . . .
ids_is_little_endian . . . . . . . .
ids_match_explain . . . . . . . .
ids_match_explain_count . . . .
ids_pid_close . . . . . . . . . . .
ids_pid_member_count . . . . .
ids_pid_member_get . . . . . . .
ids_pid_open . . . . . . . . . . .
ids_pid_search_get . . . . . . . .
ids_pid_search_get_clusters . . .
ids_pid_src_pk_get . . . . . . . .
ids_pid_src_pk_start . . . . . . .
ids_ps_get_entity_list . . . . . . .
ids_ps_get_entity_max_elements
ids_ps_get_entity_max_length . .
ids_ps_parse . . . . . . . . . . . .
ids_ps_set_encoding . . . . . . .
ids_ps_set_entity_list . . . . . . .
ids_ps_set_population . . . . . .
ids_real_time_async_get . . . . .
ids_real_time_async_start . . . .
ids_real_time_flul_add . . . . . .
ids_real_time_flul_close . . . . .
ids_real_time_flul_delete . . . . .
ids_real_time_flul_find_rule . . .
ids_real_time_flul_get_rule . . .
ids_real_time_flul_init . . . . . .
ids_real_time_sync_get . . . . . .
ids_real_time_sync_start . . . . .
ids_scores_get . . . . . . . . . . .
ids_search_comment_get . . . . .
ids_search_dedupe_start . . . . .
ids_search_fields_count . . . . .
ids_search_fields_get . . . . . . .
ids_search_filter . . . . . . . . . .
ids_search_finish . . . . . . . . .
ids_search_get . . . . . . . . . . .
ids_search_get_complete . . . . .
ids_search_get_detail . . . . . . .
ids_search_IDT_get . . . . . . . .
ids_search_layout . . . . . . . . .
ids_search_start . . . . . . . . . .
ids_search_tolerances_count . . .
ids_search_tolerances_get . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

352
353
354
354
355
355
356
357
357
358
358
359
359
360
361
361
361
362
363
363
364
364
365
365
366
366
367
368
368
369
369
370
371
372
372
373
373
374
374
375
376
377
377
378
379
379
380
380
381
382
382
383
384
385
386
14

ids_search_view_get . . . . . .
ids_search_view_set . . . . . .
ids_search_widths_count . . . .
ids_search_widths_get . . . . .
ids_server_version_get . . . . .
ids_session_close . . . . . . . .
ids_session_open . . . . . . . .
ids_set_encoding . . . . . . . .
ids_set_vpd_user . . . . . . . .
ids_system_close . . . . . . . .
ids_system_idtname_count . .
ids_system_idtname_get . . . .
ids_system_notify . . . . . . . .
ids_system_open . . . . . . . .
ids_system_pid_searches_count
ids_system_pid_searches_get .
ids_system_search_finish . . . .
ids_system_search_start . . . .
ids_system_searches_count . .
ids_system_searches_get . . . .
ids_systems_count . . . . . . .
ids_systems_get . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

386
387
388
388
389
389
390
390
391
391
392
392
393
393
394
394
395
395
396
397
397
398

Calling from Perl


Constants - Object Oriented
Installation - Win32 client .
Installation - Unix client . .
Parameter types . . . . . . .
addr_get_cass_field . . . . . . . . . . . .
addr_get_cass_field_cnt . . . . . . . . .
addr_get_cass_field_info . . . . . . . . .
addr_get_del_lines_ext . . . . . . . . . .
addr_get_field . . . . . . . . . . . . . . .
addr_get_field_count . . . . . . . . . . .
addr_get_field_ext . . . . . . . . . . . .
addr_get_field_idx . . . . . . . . . . . .
addr_get_field_info_ext . . . . . . . . .
addr_get_field_len . . . . . . . . . . . .
addr_get_line_len . . . . . . . . . . . . .
addr_get_option . . . . . . . . . . . . . .
addr_info . . . . . . . . . . . . . . . . . .
addr_init . . . . . . . . . . . . . . . . . .
addr_parse . . . . . . . . . . . . . . . . .
addr_preload_country . . . . . . . . . .
addr_set_attrib . . . . . . . . . . . . . . .
addr_set_del_lines . . . . . . . . . . . .
addr_set_field_case . . . . . . . . . . . .
addr_set_field_ext . . . . . . . . . . . . .
addr_set_field_idx . . . . . . . . . . . .
addr_set_field_name . . . . . . . . . . .
addr_set_lines . . . . . . . . . . . . . . .
addr_set_option . . . . . . . . . . . . . .
addr_std . . . . . . . . . . . . . . . . . .
addr_validate . . . . . . . . . . . . . . .
disconnect . . . . . . . . . . . . . . . . .
error_get . . . . . . . . . . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

399
399
399
399
399
399
400
400
401
402
402
403
403
404
405
405
405
406
406
407
407
408
408
409
410
410
411
411
412
413
414
414
415

15

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

errors_get_all . . . . . . . . .
identify . . . . . . . . . . . . .
is_little_endian . . . . . . . .
match_explain . . . . . . . . .
match_explain_count . . . . .
pid_close . . . . . . . . . . . .
pid_member_count . . . . . .
pid_member_get . . . . . . .
pid_open . . . . . . . . . . . .
pid_search_get . . . . . . . . .
pid_search_get_clusters . . .
pid_src_pk_get . . . . . . . .
pid_src_pk_start . . . . . . . .
ps_get_entity_list . . . . . . .
ps_get_entity_max_elements
ps_get_entity_max_length . .
ps_parse . . . . . . . . . . . .
ps_set_encoding . . . . . . . .
ps_set_entity_list . . . . . . .
ps_set_population . . . . . . .
real_time_async_get . . . . . .
real_time_async_start . . . . .
real_time_flul_add . . . . . .
real_time_flul_close . . . . . .
real_time_flul_delete . . . . .
real_time_flul_find_rule . . .
real_time_flul_get_rule . . . .
real_time_flul_init . . . . . . .
real_time_sync_get . . . . . .
real_time_sync_start . . . . .
scores_get . . . . . . . . . . .
search_comment_get . . . . .
search_dedupe_start . . . . .
search_fields_count . . . . . .
search_fields_get . . . . . . .
search_filter . . . . . . . . . .
search_finish . . . . . . . . . .
search_get . . . . . . . . . . .
search_get_complete . . . . .
search_get_detail . . . . . . .
search_IDT_get . . . . . . . .
search_layout . . . . . . . . .
search_start . . . . . . . . . .
search_tolerances_count . . .
search_tolerances_get . . . . .
search_view_get . . . . . . . .
search_view_set . . . . . . . .
search_widths_count . . . . .
search_widths_get . . . . . . .
server_version_get . . . . . .
session_close . . . . . . . . . .
session_open . . . . . . . . . .
set_encoding . . . . . . . . . .
set_vpd_user . . . . . . . . . .
system_close . . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

415
416
416
417
417
418
418
419
419
420
420
421
421
422
422
423
423
424
425
425
426
426
427
428
429
429
430
430
431
431
433
433
434
435
435
436
436
437
437
438
439
439
440
441
442
442
443
444
444
445
445
445
446
446
447
16

system_idtname_count . . .
system_idtname_get . . . .
system_notify . . . . . . . .
system_open . . . . . . . . .
system_pid_searches_count
system_pid_searches_get . .
system_search_finish . . . .
system_search_start . . . . .
system_searches_count . . .
system_searches_get . . . .
systems_count . . . . . . . .
systems_get . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

447
448
448
449
449
450
450
451
452
452
453
453

Calling from MS SQL


Constants . . . . . . . . . .
Installation - Win32 Server .
Parameter types . . . . . . .
ssasexp_addr_get_cass_field . . . . . . .
ssasexp_addr_get_cass_field_cnt . . . .
ssasexp_addr_get_cass_field_info . . . .
ssasexp_addr_get_del_lines_ext . . . . .
ssasexp_addr_get_field . . . . . . . . . .
ssasexp_addr_get_field_count . . . . . .
ssasexp_addr_get_field_ext . . . . . . .
ssasexp_addr_get_field_idx . . . . . . .
ssasexp_addr_get_field_info_ext . . . .
ssasexp_addr_get_field_len . . . . . . .
ssasexp_addr_get_line_len . . . . . . . .
ssasexp_addr_get_option . . . . . . . . .
ssasexp_addr_info . . . . . . . . . . . . .
ssasexp_addr_init . . . . . . . . . . . . .
ssasexp_addr_parse . . . . . . . . . . . .
ssasexp_addr_preload_country . . . . .
ssasexp_addr_set_attrib . . . . . . . . .
ssasexp_addr_set_del_lines . . . . . . .
ssasexp_addr_set_field_case . . . . . . .
ssasexp_addr_set_field_ext . . . . . . .
ssasexp_addr_set_field_idx . . . . . . .
ssasexp_addr_set_field_name . . . . . .
ssasexp_addr_set_lines . . . . . . . . . .
ssasexp_addr_set_option . . . . . . . . .
ssasexp_addr_std . . . . . . . . . . . . .
ssasexp_addr_validate . . . . . . . . . .
ssasexp_connect . . . . . . . . . . . . . .
ssasexp_disconnect . . . . . . . . . . . .
ssasexp_error_get . . . . . . . . . . . . .
ssasexp_errors_get_all . . . . . . . . . .
ssasexp_identify . . . . . . . . . . . . . .
ssasexp_is_little_endian . . . . . . . . .
ssasexp_match_explain . . . . . . . . . .
ssasexp_match_explain_count . . . . . .
ssasexp_pid_close . . . . . . . . . . . . .
ssasexp_pid_member_count . . . . . . .
ssasexp_pid_member_get . . . . . . . .
ssasexp_pid_open . . . . . . . . . . . . .
ssasexp_pid_search_get . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

454
454
454
454
454
455
455
456
457
458
458
459
460
461
461
462
462
463
463
464
465
465
466
466
467
468
468
469
469
470
471
471
472
472
473
473
474
475
475
476
476
477
477

17

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

ssasexp_pid_search_get_clusters . . .
ssasexp_pid_src_pk_get . . . . . . . .
ssasexp_pid_src_pk_start . . . . . . . .
ssasexp_ps_get_entity_list . . . . . . .
ssasexp_ps_get_entity_max_elements
ssasexp_ps_get_entity_max_length . .
ssasexp_ps_parse . . . . . . . . . . . .
ssasexp_ps_set_encoding . . . . . . . .
ssasexp_ps_set_entity_list . . . . . . .
ssasexp_ps_set_population . . . . . .
ssasexp_real_time_async_get . . . . .
ssasexp_real_time_async_start . . . . .
ssasexp_real_time_flul_add . . . . . .
ssasexp_real_time_flul_close . . . . . .
ssasexp_real_time_flul_delete . . . . .
ssasexp_real_time_flul_find_rule . . .
ssasexp_real_time_flul_get_rule . . . .
ssasexp_real_time_flul_init . . . . . . .
ssasexp_real_time_sync_get . . . . . .
ssasexp_real_time_sync_start . . . . .
ssasexp_scores_get . . . . . . . . . . .
ssasexp_search_comment_get . . . . .
ssasexp_search_dedupe_start . . . . .
ssasexp_search_fields_count . . . . . .
ssasexp_search_fields_get . . . . . . .
ssasexp_search_filter . . . . . . . . . .
ssasexp_search_finish . . . . . . . . . .
ssasexp_search_get . . . . . . . . . . .
ssasexp_search_get_complete . . . . .
ssasexp_search_get_detail . . . . . . .
ssasexp_search_IDT_get . . . . . . . .
ssasexp_search_layout . . . . . . . . .
ssasexp_search_start . . . . . . . . . .
ssasexp_search_tolerances_count . . .
ssasexp_search_tolerances_get . . . .
ssasexp_search_view_get . . . . . . . .
ssasexp_search_view_set . . . . . . . .
ssasexp_search_widths_count . . . . .
ssasexp_search_widths_get . . . . . .
ssasexp_server_version_get . . . . . .
ssasexp_session_close . . . . . . . . . .
ssasexp_session_open . . . . . . . . . .
ssasexp_set_encoding . . . . . . . . . .
ssasexp_set_vpd_user . . . . . . . . .
ssasexp_system_close . . . . . . . . . .
ssasexp_system_idtname_count . . . .
ssasexp_system_idtname_get . . . . .
ssasexp_system_notify . . . . . . . . .
ssasexp_system_open . . . . . . . . . .
ssasexp_system_pid_searches_count .
ssasexp_system_pid_searches_get . .
ssasexp_system_search_finish . . . . .
ssasexp_system_search_start . . . . . .
ssasexp_system_searches_count . . . .
ssasexp_system_searches_get . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

478
479
480
480
481
481
482
483
483
484
484
485
486
487
487
488
488
489
489
490
491
492
493
494
494
495
495
496
497
498
499
499
501
502
503
503
504
505
505
506
507
507
508
508
509
509
510
510
511
512
512
513
514
515
515
18

ssasexp_systems_count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ssasexp_systems_get . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Calling from PL/SQL
Constants . . . . . . . . . .
Requirements . . . . . . . .
Installation - Win32 Server .
Installation - UNIX Server .
Oracle 9.2 Notes . . . . . .
Parameter types . . . . . . .
ids_addr_get_cass_field . . . . . . . . .
ids_addr_get_cass_field_cnt . . . . . . .
ids_addr_get_cass_field_info . . . . . .
ids_addr_get_del_lines_ext . . . . . . .
ids_addr_get_field . . . . . . . . . . . .
ids_addr_get_field_count . . . . . . . .
ids_addr_get_field_ext . . . . . . . . . .
ids_addr_get_field_idx . . . . . . . . . .
ids_addr_get_field_info_ext . . . . . . .
ids_addr_get_field_len . . . . . . . . . .
ids_addr_get_line_len . . . . . . . . . .
ids_addr_get_option . . . . . . . . . . .
ids_addr_info . . . . . . . . . . . . . . .
ids_addr_init . . . . . . . . . . . . . . . .
ids_addr_parse . . . . . . . . . . . . . .
ids_addr_preload_country . . . . . . . .
ids_addr_set_attrib . . . . . . . . . . . .
ids_addr_set_del_lines . . . . . . . . . .
ids_addr_set_field_case . . . . . . . . .
ids_addr_set_field_ext . . . . . . . . . .
ids_addr_set_field_idx . . . . . . . . . .
ids_addr_set_field_name . . . . . . . . .
ids_addr_set_lines . . . . . . . . . . . . .
ids_addr_set_option . . . . . . . . . . .
ids_addr_std . . . . . . . . . . . . . . . .
ids_addr_validate . . . . . . . . . . . . .
ids_connect . . . . . . . . . . . . . . . . .
ids_disconnect . . . . . . . . . . . . . . .
ids_error_get . . . . . . . . . . . . . . . .
ids_errors_get_all . . . . . . . . . . . . .
ids_identify . . . . . . . . . . . . . . . .
ids_is_little_endian . . . . . . . . . . . .
ids_match_explain . . . . . . . . . . . .
ids_match_explain_count . . . . . . . .
ids_pid_close . . . . . . . . . . . . . . .
ids_pid_member_count . . . . . . . . .
ids_pid_member_get . . . . . . . . . . .
ids_pid_open . . . . . . . . . . . . . . .
ids_pid_search_get . . . . . . . . . . . .
ids_pid_search_get_clusters . . . . . . .
ids_pid_src_pk_get . . . . . . . . . . . .
ids_pid_src_pk_start . . . . . . . . . . .
ids_ps_get_entity_list . . . . . . . . . . .
ids_ps_get_entity_max_elements . . . .
ids_ps_get_entity_max_length . . . . . .
ids_ps_parse . . . . . . . . . . . . . . . .
19

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

516
516
518
518
518
518
519
519
520
520
521
521
522
523
523
524
524
525
526
526
527
527
528
528
529
529
530
530
531
532
532
533
533
534
535
535
536
536
537
537
538
538
539
540
540
541
541
542
542
543
544
544
545
545
546

ids_ps_set_encoding . . . . . .
ids_ps_set_entity_list . . . . . .
ids_ps_set_population . . . . .
ids_real_time_async_get . . . .
ids_real_time_async_start . . .
ids_real_time_flul_add . . . . .
ids_real_time_flul_close . . . .
ids_real_time_flul_delete . . . .
ids_real_time_flul_find_rule . .
ids_real_time_flul_get_rule . .
ids_real_time_flul_init . . . . .
ids_real_time_sync_get . . . . .
ids_real_time_sync_start . . . .
ids_scores_get . . . . . . . . . .
ids_search_comment_get . . . .
ids_search_dedupe_start . . . .
ids_search_fields_count . . . .
ids_search_fields_get . . . . . .
ids_search_filter . . . . . . . . .
ids_search_finish . . . . . . . .
ids_search_get . . . . . . . . . .
ids_search_get_complete . . . .
ids_search_get_detail . . . . . .
ids_search_IDT_get . . . . . . .
ids_search_layout . . . . . . . .
ids_search_start . . . . . . . . .
ids_search_tolerances_count . .
ids_search_tolerances_get . . .
ids_search_view_get . . . . . .
ids_search_view_set . . . . . .
ids_search_widths_count . . . .
ids_search_widths_get . . . . .
ids_server_version_get . . . . .
ids_session_close . . . . . . . .
ids_session_open . . . . . . . .
ids_set_encoding . . . . . . . .
ids_set_vpd_user . . . . . . . .
ids_system_close . . . . . . . .
ids_system_idtname_count . .
ids_system_idtname_get . . . .
ids_system_notify . . . . . . . .
ids_system_open . . . . . . . .
ids_system_pid_searches_count
ids_system_pid_searches_get .
ids_system_search_finish . . . .
ids_system_search_start . . . .
ids_system_searches_count . .
ids_system_searches_get . . . .
ids_systems_count . . . . . . .
ids_systems_get . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

546
547
547
548
549
550
550
551
551
552
552
553
554
555
555
556
557
557
558
558
559
560
561
561
562
563
564
565
565
566
567
567
568
568
569
569
570
570
571
571
572
572
573
573
574
574
575
576
576
577
20

Calling from PowerBuilder


Constants . . . . . .
Parameter types . . .
ids_addr_get_cass_field . . . . .
ids_addr_get_cass_field_cnt . . .
ids_addr_get_cass_field_info . .
ids_addr_get_del_lines_ext . . .
ids_addr_get_field . . . . . . . .
ids_addr_get_field_count . . . .
ids_addr_get_field_ext . . . . . .
ids_addr_get_field_idx . . . . . .
ids_addr_get_field_info_ext . . .
ids_addr_get_field_len . . . . . .
ids_addr_get_line_len . . . . . .
ids_addr_get_option . . . . . . .
ids_addr_info . . . . . . . . . . .
ids_addr_init . . . . . . . . . . . .
ids_addr_parse . . . . . . . . . .
ids_addr_preload_country . . . .
ids_addr_set_attrib . . . . . . . .
ids_addr_set_del_lines . . . . . .
ids_addr_set_field_case . . . . .
ids_addr_set_field_ext . . . . . .
ids_addr_set_field_idx . . . . . .
ids_addr_set_field_name . . . . .
ids_addr_set_lines . . . . . . . . .
ids_addr_set_option . . . . . . .
ids_addr_std . . . . . . . . . . . .
ids_addr_validate . . . . . . . . .
ids_connect . . . . . . . . . . . . .
ids_disconnect . . . . . . . . . . .
ids_error_get . . . . . . . . . . . .
ids_errors_get_all . . . . . . . . .
ids_identify . . . . . . . . . . . .
ids_is_little_endian . . . . . . . .
ids_match_explain . . . . . . . .
ids_match_explain_count . . . .
ids_pid_close . . . . . . . . . . .
ids_pid_member_count . . . . .
ids_pid_member_get . . . . . . .
ids_pid_open . . . . . . . . . . .
ids_pid_search_get . . . . . . . .
ids_pid_search_get_clusters . . .
ids_pid_src_pk_get . . . . . . . .
ids_pid_src_pk_start . . . . . . .
ids_ps_get_entity_list . . . . . . .
ids_ps_get_entity_max_elements
ids_ps_get_entity_max_length . .
ids_ps_parse . . . . . . . . . . . .
ids_ps_set_encoding . . . . . . .
ids_ps_set_entity_list . . . . . . .
ids_ps_set_population . . . . . .
ids_real_time_async_get . . . . .
ids_real_time_async_start . . . .
ids_real_time_flul_add . . . . . .
21

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

578
578
578
578
579
579
580
581
581
582
582
583
584
584
585
585
586
586
587
587
588
588
589
590
590
591
591
592
593
593
594
594
595
595
596
596
597
598
598
599
599
600
600
601
602
602
603
603
604
604
605
605
606
607
608

ids_real_time_flul_close . . . .
ids_real_time_flul_delete . . . .
ids_real_time_flul_find_rule . .
ids_real_time_flul_get_rule . .
ids_real_time_flul_init . . . . .
ids_real_time_sync_get . . . . .
ids_real_time_sync_start . . . .
ids_scores_get . . . . . . . . . .
ids_search_comment_get . . . .
ids_search_dedupe_start . . . .
ids_search_fields_count . . . .
ids_search_fields_get . . . . . .
ids_search_filter . . . . . . . . .
ids_search_finish . . . . . . . .
ids_search_get . . . . . . . . . .
ids_search_get_complete . . . .
ids_search_get_detail . . . . . .
ids_search_IDT_get . . . . . . .
ids_search_layout . . . . . . . .
ids_search_start . . . . . . . . .
ids_search_tolerances_count . .
ids_search_tolerances_get . . .
ids_search_view_get . . . . . .
ids_search_view_set . . . . . .
ids_search_widths_count . . . .
ids_search_widths_get . . . . .
ids_server_version_get . . . . .
ids_session_close . . . . . . . .
ids_session_open . . . . . . . .
ids_set_encoding . . . . . . . .
ids_set_vpd_user . . . . . . . .
ids_system_close . . . . . . . .
ids_system_idtname_count . .
ids_system_idtname_get . . . .
ids_system_notify . . . . . . . .
ids_system_open . . . . . . . .
ids_system_pid_searches_count
ids_system_pid_searches_get .
ids_system_search_finish . . . .
ids_system_search_start . . . .
ids_system_searches_count . .
ids_system_searches_get . . . .
ids_systems_count . . . . . . .
ids_systems_get . . . . . . . . .
Calling from Visual Basic v6
Constants . . . .
ids_addr_get_cass_field . . .
ids_addr_get_cass_field_cnt .
ids_addr_get_cass_field_info
ids_addr_get_del_lines_ext .
ids_addr_get_field . . . . . .
ids_addr_get_field_count . .
ids_addr_get_field_ext . . . .
ids_addr_get_field_idx . . . .
ids_addr_get_field_info_ext .

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

608
609
609
610
610
611
612
613
613
614
615
615
616
616
617
618
619
619
620
621
622
623
623
624
625
625
626
626
627
627
628
628
629
629
630
630
631
631
632
632
633
634
634
635

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

636
636
636
637
637
638
638
639
639
640
641

CONTENTS

22

ids_addr_get_field_len . . . . . .
ids_addr_get_line_len . . . . . .
ids_addr_get_option . . . . . . .
ids_addr_info . . . . . . . . . . .
ids_addr_init . . . . . . . . . . . .
ids_addr_parse . . . . . . . . . .
ids_addr_preload_country . . . .
ids_addr_set_attrib . . . . . . . .
ids_addr_set_del_lines . . . . . .
ids_addr_set_field_case . . . . .
ids_addr_set_field_ext . . . . . .
ids_addr_set_field_idx . . . . . .
ids_addr_set_field_name . . . . .
ids_addr_set_lines . . . . . . . . .
ids_addr_set_option . . . . . . .
ids_addr_std . . . . . . . . . . . .
ids_addr_validate . . . . . . . . .
ids_connect . . . . . . . . . . . . .
ids_disconnect . . . . . . . . . . .
ids_error_get . . . . . . . . . . . .
ids_errors_get_all . . . . . . . . .
ids_identify . . . . . . . . . . . .
ids_is_little_endian . . . . . . . .
ids_match_explain . . . . . . . .
ids_match_explain_count . . . .
ids_pid_close . . . . . . . . . . .
ids_pid_member_count . . . . .
ids_pid_member_get . . . . . . .
ids_pid_open . . . . . . . . . . .
ids_pid_search_get . . . . . . . .
ids_pid_search_get_clusters . . .
ids_pid_src_pk_get . . . . . . . .
ids_pid_src_pk_start . . . . . . .
ids_ps_get_entity_list . . . . . . .
ids_ps_get_entity_max_elements
ids_ps_get_entity_max_length . .
ids_ps_parse . . . . . . . . . . . .
ids_ps_set_encoding . . . . . . .
ids_ps_set_entity_list . . . . . . .
ids_ps_set_population . . . . . .
ids_real_time_async_get . . . . .
ids_real_time_async_start . . . .
ids_real_time_flul_add . . . . . .
ids_real_time_flul_close . . . . .
ids_real_time_flul_delete . . . . .
ids_real_time_flul_find_rule . . .
ids_real_time_flul_get_rule . . .
ids_real_time_flul_init . . . . . .
ids_real_time_sync_get . . . . . .
ids_real_time_sync_start . . . . .
ids_scores_get . . . . . . . . . . .
ids_search_comment_get . . . . .
ids_search_dedupe_start . . . . .
ids_search_fields_count . . . . .
ids_search_fields_get . . . . . . .
23

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

641
642
642
643
643
644
644
645
645
646
646
647
647
648
649
649
650
650
651
651
652
652
653
653
654
655
655
655
656
656
657
658
658
659
659
660
660
661
661
662
662
663
664
664
665
665
666
666
667
668
669
669
670
671
671

ids_search_filter . . . . . . . . .
ids_search_finish . . . . . . . .
ids_search_get . . . . . . . . . .
ids_search_get_complete . . . .
ids_search_get_detail . . . . . .
ids_search_IDT_get . . . . . . .
ids_search_layout . . . . . . . .
ids_search_start . . . . . . . . .
ids_search_tolerances_count . .
ids_search_tolerances_get . . .
ids_search_view_get . . . . . .
ids_search_view_set . . . . . .
ids_search_widths_count . . . .
ids_search_widths_get . . . . .
ids_server_version_get . . . . .
ids_session_close . . . . . . . .
ids_session_open . . . . . . . .
ids_set_encoding . . . . . . . .
ids_set_vpd_user . . . . . . . .
ids_system_close . . . . . . . .
ids_system_idtname_count . .
ids_system_idtname_get . . . .
ids_system_notify . . . . . . . .
ids_system_open . . . . . . . .
ids_system_pid_searches_count
ids_system_pid_searches_get .
ids_system_search_finish . . . .
ids_system_search_start . . . .
ids_system_searches_count . .
ids_system_searches_get . . . .
ids_systems_count . . . . . . .
ids_systems_get . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

672
672
673
674
674
675
676
677
678
679
679
680
680
681
681
682
682
682
683
683
684
684
685
685
686
686
687
687
688
689
689
690

Calling from Visual Basic with an ActiveX Control


ids_disconnect . . . . . . . . . . . . . . . . . . . .
Constants . . . . . . . . . . . . . . .
Parameter types . . . . . . . . . . . .
ids_addr_get_cass_field . . . . . . . . . . . . . .
ids_addr_get_cass_field_cnt . . . . . . . . . . . .
ids_addr_get_cass_field_info . . . . . . . . . . .
ids_addr_get_del_lines_ext . . . . . . . . . . . .
ids_addr_get_field . . . . . . . . . . . . . . . . .
ids_addr_get_field_count . . . . . . . . . . . . .
ids_addr_get_field_ext . . . . . . . . . . . . . . .
ids_addr_get_field_idx . . . . . . . . . . . . . . .
ids_addr_get_field_info_ext . . . . . . . . . . . .
ids_addr_get_field_len . . . . . . . . . . . . . . .
ids_addr_get_line_len . . . . . . . . . . . . . . .
ids_addr_get_option . . . . . . . . . . . . . . . .
ids_addr_info . . . . . . . . . . . . . . . . . . . .
ids_addr_init . . . . . . . . . . . . . . . . . . . . .
ids_addr_parse . . . . . . . . . . . . . . . . . . .
ids_addr_preload_country . . . . . . . . . . . . .
ids_addr_set_attrib . . . . . . . . . . . . . . . . .
ids_addr_set_del_lines . . . . . . . . . . . . . . .
ids_addr_set_field_case . . . . . . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

691
691
691
691
692
692
693
693
694
695
695
696
696
697
697
698
698
699
699
700
700
701
702

CONTENTS

24

ids_addr_set_field_ext . . . . . .
ids_addr_set_field_idx . . . . . .
ids_addr_set_field_name . . . . .
ids_addr_set_lines . . . . . . . . .
ids_addr_set_option . . . . . . .
ids_addr_std . . . . . . . . . . . .
ids_addr_validate . . . . . . . . .
ids_connect . . . . . . . . . . . . .
ids_disconnect . . . . . . . . . . .
ids_error_get . . . . . . . . . . . .
ids_errors_get_all . . . . . . . . .
ids_identify . . . . . . . . . . . .
ids_is_little_endian . . . . . . . .
ids_match_explain . . . . . . . .
ids_match_explain_count . . . .
ids_pid_close . . . . . . . . . . .
ids_pid_member_count . . . . .
ids_pid_member_get . . . . . . .
ids_pid_open . . . . . . . . . . .
ids_pid_search_get . . . . . . . .
ids_pid_search_get_clusters . . .
ids_pid_src_pk_get . . . . . . . .
ids_pid_src_pk_start . . . . . . .
ids_ps_get_entity_list . . . . . . .
ids_ps_get_entity_max_elements
ids_ps_get_entity_max_length . .
ids_ps_parse . . . . . . . . . . . .
ids_ps_set_encoding . . . . . . .
ids_ps_set_entity_list . . . . . . .
ids_ps_set_population . . . . . .
ids_real_time_async_get . . . . .
ids_real_time_async_start . . . .
ids_real_time_flul_add . . . . . .
ids_real_time_flul_close . . . . .
ids_real_time_flul_delete . . . . .
ids_real_time_flul_find_rule . . .
ids_real_time_flul_get_rule . . .
ids_real_time_flul_init . . . . . .
ids_real_time_sync_get . . . . . .
ids_real_time_sync_start . . . . .
ids_scores_get . . . . . . . . . . .
ids_search_comment_get . . . . .
ids_search_dedupe_start . . . . .
ids_search_fields_count . . . . .
ids_search_fields_get . . . . . . .
ids_search_filter . . . . . . . . . .
ids_search_finish . . . . . . . . .
ids_search_get . . . . . . . . . . .
ids_search_get_complete . . . . .
ids_search_get_detail . . . . . . .
ids_search_IDT_get . . . . . . . .
ids_search_layout . . . . . . . . .
ids_search_start . . . . . . . . . .
ids_search_tolerances_count . . .
ids_search_tolerances_get . . . .
25

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

702
703
703
704
704
705
706
706
707
707
708
708
708
709
710
710
710
711
712
712
713
713
714
714
715
715
716
716
717
717
718
718
719
720
720
721
721
722
722
723
724
725
725
726
727
727
728
728
729
730
731
731
732
734
734

ids_search_view_get . . . . . .
ids_search_view_set . . . . . .
ids_search_widths_count . . . .
ids_search_widths_get . . . . .
ids_server_version_get . . . . .
ids_session_close . . . . . . . .
ids_session_open . . . . . . . .
ids_set_encoding . . . . . . . .
ids_set_vpd_user . . . . . . . .
ids_system_close . . . . . . . .
ids_system_idtname_count . .
ids_system_idtname_get . . . .
ids_system_notify . . . . . . . .
ids_system_open . . . . . . . .
ids_system_pid_searches_count
ids_system_pid_searches_get .
ids_system_search_finish . . . .
ids_system_search_start . . . .
ids_system_searches_count . .
ids_system_searches_get . . . .
ids_systems_count . . . . . . .
ids_systems_get . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

735
735
736
736
737
737
738
738
739
739
739
740
740
741
741
742
743
743
744
744
745
745

Calling from Visual Basic .NET


Constants . . . . . . . . .
Installation - Win32 client
Constructor . . . . . . . . . . . . . . .
addr_get_cass_field . . . . . . . . . . .
addr_get_cass_field_cnt . . . . . . . .
addr_get_cass_field_info . . . . . . . .
addr_get_del_lines_ext . . . . . . . . .
addr_get_field . . . . . . . . . . . . . .
addr_get_field_count . . . . . . . . . .
addr_get_field_ext . . . . . . . . . . .
addr_get_field_idx . . . . . . . . . . .
addr_get_field_info_ext . . . . . . . .
addr_get_field_len . . . . . . . . . . .
addr_get_line_len . . . . . . . . . . . .
addr_get_option . . . . . . . . . . . . .
addr_info . . . . . . . . . . . . . . . . .
addr_init . . . . . . . . . . . . . . . . .
addr_parse . . . . . . . . . . . . . . . .
addr_preload_country . . . . . . . . .
addr_set_attrib . . . . . . . . . . . . . .
addr_set_del_lines . . . . . . . . . . .
addr_set_field_case . . . . . . . . . . .
addr_set_field_ext . . . . . . . . . . . .
addr_set_field_idx . . . . . . . . . . .
addr_set_field_name . . . . . . . . . .
addr_set_lines . . . . . . . . . . . . . .
addr_set_option . . . . . . . . . . . . .
addr_std . . . . . . . . . . . . . . . . .
addr_validate . . . . . . . . . . . . . .
disconnect . . . . . . . . . . . . . . . .
error_get . . . . . . . . . . . . . . . . .
errors_get_all . . . . . . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

747
747
747
748
748
749
749
750
750
751
751
752
753
753
754
754
755
755
756
756
757
757
758
758
759
760
760
761
761
762
763
763
764

CONTENTS

26

identify . . . . . . . . . . . . .
is_little_endian . . . . . . . .
match_explain . . . . . . . . .
match_explain_count . . . . .
pid_close . . . . . . . . . . . .
pid_member_count . . . . . .
pid_member_get . . . . . . .
pid_open . . . . . . . . . . . .
pid_search_get . . . . . . . . .
pid_search_get_clusters . . .
pid_src_pk_get . . . . . . . .
pid_src_pk_start . . . . . . . .
ps_get_entity_list . . . . . . .
ps_get_entity_max_elements
ps_get_entity_max_length . .
ps_parse . . . . . . . . . . . .
ps_set_encoding . . . . . . . .
ps_set_entity_list . . . . . . .
ps_set_population . . . . . . .
real_time_async_get . . . . . .
real_time_async_start . . . . .
real_time_flul_add . . . . . .
real_time_flul_close . . . . . .
real_time_flul_delete . . . . .
real_time_flul_find_rule . . .
real_time_flul_get_rule . . . .
real_time_flul_init . . . . . . .
real_time_sync_get . . . . . .
real_time_sync_start . . . . .
scores_get . . . . . . . . . . .
search_comment_get . . . . .
search_dedupe_start . . . . .
search_fields_count . . . . . .
search_fields_get . . . . . . .
search_filter . . . . . . . . . .
search_finish . . . . . . . . . .
search_get . . . . . . . . . . .
search_get_complete . . . . .
search_get_detail . . . . . . .
search_IDT_get . . . . . . . .
search_layout . . . . . . . . .
search_start . . . . . . . . . .
search_tolerances_count . . .
search_tolerances_get . . . . .
search_view_get . . . . . . . .
search_view_set . . . . . . . .
search_widths_count . . . . .
search_widths_get . . . . . . .
server_version_get . . . . . .
session_close . . . . . . . . . .
session_open . . . . . . . . . .
set_encoding . . . . . . . . . .
set_vpd_user . . . . . . . . . .
system_close . . . . . . . . . .
system_idtname_count . . . .
27

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

764
765
765
766
766
767
767
768
768
769
769
770
770
771
771
772
772
773
773
774
775
776
776
777
777
778
778
779
780
781
781
782
783
783
784
784
785
785
786
787
787
789
790
790
791
792
792
793
793
793
794
794
795
795
796

system_idtname_get . . . .
system_notify . . . . . . . .
system_open . . . . . . . . .
system_pid_searches_count
system_pid_searches_get . .
system_search_finish . . . .
system_search_start . . . . .
system_searches_count . . .
system_searches_get . . . .
systems_count . . . . . . . .
systems_get . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

796
797
797
798
798
799
799
800
801
801
802

Calling from Visual Basic with an ActiveX Control


Constants . . . . . . . . . . . . . . .
Parameter types . . . . . . . . . . . .
ids_connect . . . . . . . . . . . . . . . . . . . . . .
ids_disconnect . . . . . . . . . . . . . . . . . . . .
ids_addr_get_cass_field . . . . . . . . . . . . . .
ids_addr_get_cass_field_cnt . . . . . . . . . . . .
ids_addr_get_cass_field_info . . . . . . . . . . .
ids_addr_get_del_lines_ext . . . . . . . . . . . .
ids_addr_get_field . . . . . . . . . . . . . . . . .
ids_addr_get_field_count . . . . . . . . . . . . .
ids_addr_get_field_ext . . . . . . . . . . . . . . .
ids_addr_get_field_idx . . . . . . . . . . . . . . .
ids_addr_get_field_info_ext . . . . . . . . . . . .
ids_addr_get_field_len . . . . . . . . . . . . . . .
ids_addr_get_line_len . . . . . . . . . . . . . . .
ids_addr_get_option . . . . . . . . . . . . . . . .
ids_addr_info . . . . . . . . . . . . . . . . . . . .
ids_addr_init . . . . . . . . . . . . . . . . . . . . .
ids_addr_parse . . . . . . . . . . . . . . . . . . .
ids_addr_preload_country . . . . . . . . . . . . .
ids_addr_set_attrib . . . . . . . . . . . . . . . . .
ids_addr_set_del_lines . . . . . . . . . . . . . . .
ids_addr_set_field_case . . . . . . . . . . . . . .
ids_addr_set_field_ext . . . . . . . . . . . . . . .
ids_addr_set_field_idx . . . . . . . . . . . . . . .
ids_addr_set_field_name . . . . . . . . . . . . . .
ids_addr_set_lines . . . . . . . . . . . . . . . . . .
ids_addr_set_option . . . . . . . . . . . . . . . .
ids_addr_std . . . . . . . . . . . . . . . . . . . . .
ids_addr_validate . . . . . . . . . . . . . . . . . .
ids_connect . . . . . . . . . . . . . . . . . . . . . .
ids_disconnect . . . . . . . . . . . . . . . . . . . .
ids_error_get . . . . . . . . . . . . . . . . . . . . .
ids_errors_get_all . . . . . . . . . . . . . . . . . .
ids_identify . . . . . . . . . . . . . . . . . . . . .
ids_is_little_endian . . . . . . . . . . . . . . . . .
ids_match_explain . . . . . . . . . . . . . . . . .
ids_match_explain_count . . . . . . . . . . . . .
ids_pid_close . . . . . . . . . . . . . . . . . . . .
ids_pid_member_count . . . . . . . . . . . . . .
ids_pid_member_get . . . . . . . . . . . . . . . .
ids_pid_open . . . . . . . . . . . . . . . . . . . .
ids_pid_search_get . . . . . . . . . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

803
803
803
803
804
804
805
805
806
806
807
807
808
809
809
810
810
811
811
812
812
813
813
814
814
815
815
816
817
817
818
818
819
819
820
820
821
821
822
823
823
823
824
824

CONTENTS

28

ids_pid_search_get_clusters . . .
ids_pid_src_pk_get . . . . . . . .
ids_pid_src_pk_start . . . . . . .
ids_ps_get_entity_list . . . . . . .
ids_ps_get_entity_max_elements
ids_ps_get_entity_max_length . .
ids_ps_parse . . . . . . . . . . . .
ids_ps_set_encoding . . . . . . .
ids_ps_set_entity_list . . . . . . .
ids_ps_set_population . . . . . .
ids_real_time_async_get . . . . .
ids_real_time_async_start . . . .
ids_real_time_flul_add . . . . . .
ids_real_time_flul_close . . . . .
ids_real_time_flul_delete . . . . .
ids_real_time_flul_find_rule . . .
ids_real_time_flul_get_rule . . .
ids_real_time_flul_init . . . . . .
ids_real_time_sync_get . . . . . .
ids_real_time_sync_start . . . . .
ids_scores_get . . . . . . . . . . .
ids_search_comment_get . . . . .
ids_search_dedupe_start . . . . .
ids_search_fields_count . . . . .
ids_search_fields_get . . . . . . .
ids_search_filter . . . . . . . . . .
ids_search_finish . . . . . . . . .
ids_search_get . . . . . . . . . . .
ids_search_get_complete . . . . .
ids_search_get_detail . . . . . . .
ids_search_IDT_get . . . . . . . .
ids_search_layout . . . . . . . . .
ids_search_start . . . . . . . . . .
ids_search_tolerances_count . . .
ids_search_tolerances_get . . . .
ids_search_view_get . . . . . . .
ids_search_view_set . . . . . . .
ids_search_widths_count . . . . .
ids_search_widths_get . . . . . .
ids_server_version_get . . . . . .
ids_session_close . . . . . . . . .
ids_session_open . . . . . . . . .
ids_set_encoding . . . . . . . . .
ids_set_vpd_user . . . . . . . . .
ids_system_close . . . . . . . . .
ids_system_idtname_count . . .
ids_system_idtname_get . . . . .
ids_system_notify . . . . . . . . .
ids_system_open . . . . . . . . .
ids_system_pid_searches_count .
ids_system_pid_searches_get . .
ids_system_search_finish . . . . .
ids_system_search_start . . . . .
ids_system_searches_count . . .
ids_system_searches_get . . . . .
29

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

825
826
826
827
827
828
828
829
829
830
830
831
832
832
833
833
834
834
835
836
837
837
838
839
839
840
840
841
842
842
843
844
845
846
847
847
848
848
849
849
850
850
850
851
851
852
852
853
853
854
854
855
855
856
857

ids_systems_count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ids_systems_get . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Calling from Visual Basic with an ActiveX Control
Constants . . . . . . . . . . . . . . .
Parameter types . . . . . . . . . . . .
ids_connect . . . . . . . . . . . . . . . . . . . . . .
ids_disconnect . . . . . . . . . . . . . . . . . . . .
ids_addr_get_cass_field . . . . . . . . . . . . . .
ids_addr_get_cass_field_cnt . . . . . . . . . . . .
ids_addr_get_cass_field_info . . . . . . . . . . .
ids_addr_get_del_lines_ext . . . . . . . . . . . .
ids_addr_get_field . . . . . . . . . . . . . . . . .
ids_addr_get_field_count . . . . . . . . . . . . .
ids_addr_get_field_ext . . . . . . . . . . . . . . .
ids_addr_get_field_idx . . . . . . . . . . . . . . .
ids_addr_get_field_info_ext . . . . . . . . . . . .
ids_addr_get_field_len . . . . . . . . . . . . . . .
ids_addr_get_line_len . . . . . . . . . . . . . . .
ids_addr_get_option . . . . . . . . . . . . . . . .
ids_addr_info . . . . . . . . . . . . . . . . . . . .
ids_addr_init . . . . . . . . . . . . . . . . . . . . .
ids_addr_parse . . . . . . . . . . . . . . . . . . .
ids_addr_preload_country . . . . . . . . . . . . .
ids_addr_set_attrib . . . . . . . . . . . . . . . . .
ids_addr_set_del_lines . . . . . . . . . . . . . . .
ids_addr_set_field_case . . . . . . . . . . . . . .
ids_addr_set_field_ext . . . . . . . . . . . . . . .
ids_addr_set_field_idx . . . . . . . . . . . . . . .
ids_addr_set_field_name . . . . . . . . . . . . . .
ids_addr_set_lines . . . . . . . . . . . . . . . . . .
ids_addr_set_option . . . . . . . . . . . . . . . .
ids_addr_std . . . . . . . . . . . . . . . . . . . . .
ids_addr_validate . . . . . . . . . . . . . . . . . .
ids_connect . . . . . . . . . . . . . . . . . . . . . .
ids_disconnect . . . . . . . . . . . . . . . . . . . .
ids_error_get . . . . . . . . . . . . . . . . . . . . .
ids_errors_get_all . . . . . . . . . . . . . . . . . .
ids_identify . . . . . . . . . . . . . . . . . . . . .
ids_is_little_endian . . . . . . . . . . . . . . . . .
ids_match_explain . . . . . . . . . . . . . . . . .
ids_match_explain_count . . . . . . . . . . . . .
ids_pid_close . . . . . . . . . . . . . . . . . . . .
ids_pid_member_count . . . . . . . . . . . . . .
ids_pid_member_get . . . . . . . . . . . . . . . .
ids_pid_open . . . . . . . . . . . . . . . . . . . .
ids_pid_search_get . . . . . . . . . . . . . . . . .
ids_pid_search_get_clusters . . . . . . . . . . . .
ids_pid_src_pk_get . . . . . . . . . . . . . . . . .
ids_pid_src_pk_start . . . . . . . . . . . . . . . .
ids_ps_get_entity_list . . . . . . . . . . . . . . . .
ids_ps_get_entity_max_elements . . . . . . . . .
ids_ps_get_entity_max_length . . . . . . . . . . .
ids_ps_parse . . . . . . . . . . . . . . . . . . . . .
ids_ps_set_encoding . . . . . . . . . . . . . . . .
ids_ps_set_entity_list . . . . . . . . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

857
858
859
859
859
859
860
860
861
861
862
862
863
863
864
865
865
866
866
867
867
868
868
869
869
870
870
871
871
872
873
873
874
874
875
875
876
876
877
877
878
879
879
879
880
880
881
882
882
883
883
884
884
885
885
30

ids_ps_set_population . . . . .
ids_real_time_async_get . . . .
ids_real_time_async_start . . .
ids_real_time_flul_add . . . . .
ids_real_time_flul_close . . . .
ids_real_time_flul_delete . . . .
ids_real_time_flul_find_rule . .
ids_real_time_flul_get_rule . .
ids_real_time_flul_init . . . . .
ids_real_time_sync_get . . . . .
ids_real_time_sync_start . . . .
ids_scores_get . . . . . . . . . .
ids_search_comment_get . . . .
ids_search_dedupe_start . . . .
ids_search_fields_count . . . .
ids_search_fields_get . . . . . .
ids_search_filter . . . . . . . . .
ids_search_finish . . . . . . . .
ids_search_get . . . . . . . . . .
ids_search_get_complete . . . .
ids_search_get_detail . . . . . .
ids_search_IDT_get . . . . . . .
ids_search_layout . . . . . . . .
ids_search_start . . . . . . . . .
ids_search_tolerances_count . .
ids_search_tolerances_get . . .
ids_search_view_get . . . . . .
ids_search_view_set . . . . . .
ids_search_widths_count . . . .
ids_search_widths_get . . . . .
ids_server_version_get . . . . .
ids_session_close . . . . . . . .
ids_session_open . . . . . . . .
ids_set_encoding . . . . . . . .
ids_set_vpd_user . . . . . . . .
ids_system_close . . . . . . . .
ids_system_idtname_count . .
ids_system_idtname_get . . . .
ids_system_notify . . . . . . . .
ids_system_open . . . . . . . .
ids_system_pid_searches_count
ids_system_pid_searches_get .
ids_system_search_finish . . . .
ids_system_search_start . . . .
ids_system_searches_count . .
ids_system_searches_get . . . .
ids_systems_count . . . . . . .
ids_systems_get . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

886
886
887
888
888
889
889
890
890
891
892
893
893
894
895
895
896
896
897
898
898
899
900
901
902
903
903
904
904
905
905
906
906
906
907
907
908
908
909
909
910
910
911
911
912
913
913
914

Using MDM-RE with XML


WSDL . . . . . . . . . . . . . . . . . .
Creating a proxy with .NET . . . . .
Creating a proxy with Apache Axis2
XML and HTTP . . . . . . . . . . . .
XML and SOAP . . . . . . . . . . . .
XML and Unicode . . . . . . . . . . . . . .

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

915
915
915
915
915
916
918

31

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

Parameter types . . .
ids_addr_get_cass_field . . . . .
ids_addr_get_cass_field_cnt . . .
ids_addr_get_cass_field_info . .
ids_addr_get_del_lines_ext . . .
ids_addr_get_field . . . . . . . .
ids_addr_get_field_count . . . .
ids_addr_get_field_ext . . . . . .
ids_addr_get_field_idx . . . . . .
ids_addr_get_field_info_ext . . .
ids_addr_get_field_len . . . . . .
ids_addr_get_line_len . . . . . .
ids_addr_get_option . . . . . . .
ids_addr_info . . . . . . . . . . .
ids_addr_init . . . . . . . . . . . .
ids_addr_parse . . . . . . . . . .
ids_addr_preload_country . . . .
ids_addr_set_attrib . . . . . . . .
ids_addr_set_del_lines . . . . . .
ids_addr_set_field_case . . . . .
ids_addr_set_field_ext . . . . . .
ids_addr_set_field_idx . . . . . .
ids_addr_set_field_name . . . . .
ids_addr_set_lines . . . . . . . . .
ids_addr_set_option . . . . . . .
ids_addr_std . . . . . . . . . . . .
ids_addr_validate . . . . . . . . .
ids_connect . . . . . . . . . . . . .
ids_disconnect . . . . . . . . . . .
ids_error_get . . . . . . . . . . . .
ids_errors_get_all . . . . . . . . .
ids_identify . . . . . . . . . . . .
ids_is_little_endian . . . . . . . .
ids_match_explain . . . . . . . .
ids_match_explain_count . . . .
ids_pid_close . . . . . . . . . . .
ids_pid_member_count . . . . .
ids_pid_member_get . . . . . . .
ids_pid_open . . . . . . . . . . .
ids_pid_search_get . . . . . . . .
ids_pid_search_get_clusters . . .
ids_pid_src_pk_get . . . . . . . .
ids_pid_src_pk_start . . . . . . .
ids_ps_get_entity_list . . . . . . .
ids_ps_get_entity_max_elements
ids_ps_get_entity_max_length . .
ids_ps_parse . . . . . . . . . . . .
ids_ps_set_encoding . . . . . . .
ids_ps_set_entity_list . . . . . . .
ids_ps_set_population . . . . . .
ids_real_time_async_get . . . . .
ids_real_time_async_start . . . .
ids_real_time_flul_add . . . . . .
ids_real_time_flul_close . . . . .
ids_real_time_flul_delete . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

CONTENTS

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

918
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
932
933
934
935
936
937
938
939
941
941
943
944
944
945
946
947
948
949
950
951
952
952
954
954
956
957
958
958
959
960
961
963
963
964
965
966
968
969
970
32

ids_real_time_flul_find_rule . .
ids_real_time_flul_get_rule . .
ids_real_time_flul_init . . . . .
ids_real_time_sync_get . . . . .
ids_real_time_sync_start . . . .
ids_scores_get . . . . . . . . . .
ids_search_comment_get . . . .
ids_search_dedupe_start . . . .
ids_search_fields_count . . . .
ids_search_fields_get . . . . . .
ids_search_filter . . . . . . . . .
ids_search_finish . . . . . . . .
ids_search_get . . . . . . . . . .
ids_search_get_complete . . . .
ids_search_get_detail . . . . . .
ids_search_IDT_get . . . . . . .
ids_search_layout . . . . . . . .
ids_search_start . . . . . . . . .
ids_search_tolerances_count . .
ids_search_tolerances_get . . .
ids_search_view_get . . . . . .
ids_search_view_set . . . . . .
ids_search_widths_count . . . .
ids_search_widths_get . . . . .
ids_server_version_get . . . . .
ids_session_close . . . . . . . .
ids_session_open . . . . . . . .
ids_set_encoding . . . . . . . .
ids_set_vpd_user . . . . . . . .
ids_system_close . . . . . . . .
ids_system_idtname_count . .
ids_system_idtname_get . . . .
ids_system_notify . . . . . . . .
ids_system_open . . . . . . . .
ids_system_pid_searches_count
ids_system_pid_searches_get .
ids_system_search_finish . . . .
ids_system_search_start . . . .
ids_system_searches_count . .
ids_system_searches_get . . . .
ids_systems_count . . . . . . .
ids_systems_get . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

971
971
972
973
974
976
977
978
979
980
981
982
983
984
986
987
988
989
991
992
993
994
995
996
997
998
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013

Common Parameters
1014
Verbosity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1014
Address Standardization
Initialization . . . . . . . . . . . .
Character Sets and Countries . .
Providing an Input Address
Parsing an Address . . . . . . . .
Validating an Address . . . . . .
Retrieving Address Fields . . . .
Setting Options . . . . . . .
Getting Options . . . . . . .
Sample Code . . . . . . . . .
33

CONTENTS

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

1015
1015
1015
1021
1022
1023
1025
1027
1028
1028

Validation Database Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1028


ASM configuration for AddressDoctor v5 . . . . . . . . . . . . . . . . . . . . . . . . . . . 1029
Batch Test Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1031
AnswerSet
Table Name and Index . . .
Table Layout . . . . . . . . .
Adding Rows . . . . . . . .
Clearing the Table . . . . . .
Relate & DupFinder Set-Ids
Oracle RAC . . . . . . . . .

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

1034
1034
1034
1034
1035
1035
1035

DupFinder
1036
AnswerSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1037
Match Explain API
1038
Match Explain Record Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1038
Match Explain Scores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1039
Index

1040

CONTENTS

34

Introduction
This manual describes how to develop a custom search client application using the API.
Prototype search clients are provided in the following languages:

C#

Cobol

Java

Perl

PL/SQL

MS SQL

PowerBuilder

Visual Basic 6

Visual Basic .NET

ActiveX controls are provided for:

Cold Fusion

Visual Basic 6

35

INTRODUCTION

Process Overview
Concepts
Connections
The ids_connect and ids_disconnect API calls are used to establish / terminate a connection
(TCP/IP socket) to the "server". The "server" can be either the Search Server or Connection Server,
depending on the host name and host port parameters supplied on the connection call.

Sessions
Use of the Connection Server is optional. Refer to the O PERATIONS manual, Servers chapter for details
about the Connection Server and why you might want to use it.
If it is used, you must establish a "session" with the Connection Server using the ids_session_open
API.
Sessions may be closed explicitly using the ids_session_close API, or can be timed-out by the
Connection Server if they have been inactive for the defined time-out period.

Systems
The ids_system_open and ids_system_close calls are used to inform the server which System
will be used for subsequent search calls. Switching between different Systems incurs a slight overhead,
as the Rulebase must be consulted to read the rules for the new System.

Searches
Searches are started with ids_search_start. This call performs all of the work necessary to find
candidates and match them against the search record. The resulting set of records is created and sorted.
The call returns the number of records in the resulting set.
The results may be written to a database table known as an AnswerSet , or may be retrieved using
ids_search_get. The latter API is called repeatedly to retrieve records from the result set one at a
time.
Once enough rows have been retrieved, any remaining resources held by the server for this search are
freed using ids_search_finish.
Note: The first search for a given System incurs an additional overhead to allocate database resources
and access the Rulebase. Switching between searches on a particular connection is equivalent to starting
a new search and therefore incurs some overhead. Applications requiring the best possible search
performance should be architected to avoid switching between searches. The easiest way to do this is
to use separate (dedicated) connections for each Search.

Basic API
The Basic API is suitable for processing a simple one-off query. It combines opening the System with
starting a search. It also combines terminating a search and closing a System in one call.
36

Use the Advanced API if you wish to start multiple searches for the same System.
The flow of the Basic API is
1. Open a connection (ids_connect)
2. Initiate a search (ids_system_search_start)
3. Retrieve sorted search results (ids_search_get) until required buffer is filled (this may be a
screens worth, or a pre-determined search limit size).
4. Process the search results (display to a screen or write to a file)
5. End the search (ids_system_search_finish)
6. Close the connection (ids_disconnect)

Advanced API
The Advanced API is more efficient than the Basic API but requires the use of two extra calls. It is
suited to applications that wish to perform multiple searches for a given System.
The flow of the more advanced level is
1. Open a Socket (ids_connect)
2. Optionally start a Session (ids_session_open)
3. Open a System (ids_system_open)
4. Initiate a Search (ids_search_start)
5. Retrieve sorted search results (ids_search_get) until required buffer is filled (this may be a
screens worth, or a pre-determined search limit size).
6. Process the search results (display to a screen or write to a file)
7. End the search (ids_search_finish)
8. Optionally return to 4. to start more searches
9. Close the system (ids_system_close)
10. Optionally close the session (ids_session_close)
11. Close the socket (ids_disconnect)
Other functions are available through this level of the API allowing the search client to be more rulesensitive. For example, the length of a record to be returned in the search results can be determined
with an ids_search_view_get call which is followed by a call to ids_search_layout. This may
assist the clients dynamic memory allocation.

37

PROCESS OVERVIEW

Sample API Programs


Sample client programs are provided for all supported API languages. All sample programs use the
same System (and data) and demonstrate the same logical sequence of API calls.

Sample System
All sample programs use the same System (ssa001). This is provided as an SDF.

Directory Structure
The sample System, programs and data are located in the samples directory of the Client and Developer Components installation directory. The following directory structure exists:
samples/
data/
f5000.txt
programs/
applet/
c/
cobol/
coldfsn/
csharp/
java/
mssql/
oraplsql/
pb/
perl/
perl-oo/
vb6/
vbnet/
system/
ssa001.sdf

Population
The sample System uses the same population as the MDM-RE Installation test. The SSA-NAME3 System is named mdm-reXXXX, where XXXX is the release number of MDM-RE. The Population is named
test.

Installing


Launch MDM-RE Console and choose New from the System menu.

Choose Create a system from an SDF and click OK.

Enter ssa001 as the system name, and %SSATOP%\samples\system\ssa001.sdf as the System


Definition File (where %SSATOP% is the directory that the Client and Developer Components were
installed into - by default, c:\InformaticaIR).

Fill out your database details and click OK.


38

Click Close when the system has been created.

Under the System menu, choose Select, then ssa001 and click OK.

Under the System menu, choose Load IDT, then ssa001 and click OK.

Your MDM-RE installation is now ready to run the samples.

IDT Layout
The IDT has the following layout. Records passed to ids_search_start must be preformatted by
the caller in this layout.
Name

Offset

Length

11

name

11

50

DOB

61

Address

69

40

ID

IDT record length is 109 bytes.

Building the Programs


(Instructions and files are only provided for the WINDOWS environment. Unix users will need to
adjust this section accordingly).
To build the sample applications you will need to establish the client environment by running <MDMRE Client Install Dir>\env\issc.bat.
Once your environment is established, simply run compile.bat in the subdirectory of the sample you
wish to build. The batch file assumes that the compilers are in your PATH. You will need to adjust your
PATH environment variable if they are not.
Note that ColdFusion, Perl and Oracle PL/SQL are either interpreted or compiled at runtime, so no
compile.bat file exists for these.

Language specific notes


C Ensure that cl.exe can be found in your path, and that the INCLUDE and LIB environment variables are set correctly.
C# Ensure that csc.exe can be found in your PATH.
VB6 & VB6OCX Ensure that vb6.exe and editbin.exe can be found in your PATH.
VB.NET Ensure that vbc.exe can be found in your PATH.
PB Does not have a batch file to perform compilation. It can be built through the PowerBuilder IDE.
Open the work space for the sample then add the MDM-RE PowerBuilder Dynamic Library to the
library list (ids.pbd). Select the project in the system tree then select deploy project from the design
menu. Change the location of the executable file and save the project. Then perform Building and
Deployment from the run menu.
39

SAMPLE API PROGRAMS

Running the Samples


The commands below illustrate how to run the samples.
The <RULEBASE> parameter defines which Rulebase to use and is formatted as type:method:details, eg.
odb:0:user/password@hostname
The <HOST> field is formatted as hostname:port, eg. localhost:1666
Sample 1 expects the host parameter to point to the Search Server, while Sample 2 expects the host
parameter to point to the Connection Server.
The <WORKDIR> parameter defines which working directory to use.
The <SYSTEM> parameter defines the name of the system in the rulebase.

C
sample1 -r<RULEBASE> -h<HOST>
sample2 -r<RULEBASE> -h<HOST>
pidsearch -r<RULEBASE> -h<HOST> -p<SYSTEM> [-w<WORKDIR>]

Note: the C examples use the API stub DLL ssasec.dll and the MDM-RE socket interface
provided by ssaiok.dll. These dynamic link libraries are packaged in the MDM-RE Client
bin and SSA-NAME3 bin directory respectively. Make sure these directories are in your
PATH before running the samples.

ColdFusion
Copy the contents of the coldfsn directory to a directory in your webserver root. Next, copy and
register the ColdFusion ActiveX control on your machine:
copy %SSATOP%\vb\ssasecf.ocx %SystemRoot%\system32
regsvr32 %SystemRoot%\system32\ssasecf.ocx

You can now execute the scripts by pointing a web browser at the following URLs:

C#
Load the .NET assembly into the system cache:
gacutil /i %SSATOP%\bin\ssasecs.dll

You can now execute the programs as follows:


sample1 -r<RULEBASE> -h<HOST>
sample2 -r<RULEBASE> -h<HOST>
PIDSearch -r<RULEBASE> -h<HOST> -p<SYSTEM> [-w<WORKDIR>]

Sample System

40

Java
Add %SSATOP%\bin\idsclie.jar;%SSATOP%\bin\idssecl.jar;. to your CLASSPATH environment variable. Then run
java Sample1 -r<RULEBASE> -h<HOST>
java Sample2 -r<RULEBASE> -h<HOST>
PIDSearch -r<RULEBASE> -h<HOST> -p<SYSTEM> [-w<WORKDIR>]

MS SQL
Copy the DLL ssasexp.dll, to the directory containing the standard SQL server DLL
files (C:\Program Files\Microsoft SQL Server\MSSQL\Binn for MS SQL 2000). Copy
ssaiok.dll and ssasec.dll into a directory on the MS SQL servers default path.
To install the DLL, from the %SSATOP%\MSSQL directory run:
osql -U sa -P password -S service -n -i ssasexp.sql

To execute the samples use:


osql -U user -P password -S service -n -i sample.sql

Perl
perl sample1 -r<RULEBASE> -h<HOST>
perl sample2 -r<RULEBASE> -h<HOST>
perl pidsearch -r<RULEBASE> -h<HOST> -p<SYSTEM> [-w<WORKDIR>]

Oracle and PL/SQL


Copy %SSATOP%\bin\ssasep.dll and <SSA-NAME3 directory>\bin\ssaiok.dll to your Oracle
server bin directory. Execute the following SQL command:
CREATE OR REPLACE LIBRARY SSA_SSASE IS <path>\ssasep.dll;

Execute the following SQL scripts found in the bin directory of the Server installation:
ssasep.sql
ssaseb.sql
idsconv.sql
ssasec.sql
Edit sample1.sql and sample2.sql, replacing the connection information at the bottom with your
local details.
You can now run sample1.sql and sample2.sql.
41

SAMPLE API PROGRAMS

Power Builder
sample1 <OUTPUTFILE> -r<RULEBASE> -h<HOST>
sample2 <OUTPUTFILE> -r<RULEBASE> -h<HOST>

VB6
sample1 -r<RULEBASE> -h<HOST> [-o<OUTPUTFILE>]
sample2 -r<RULEBASE> -h<HOST> [-o<OUTPUTFILE>]

VB6 OCX
sample1 -r<RULEBASE> -h<HOST> [-o<OUTPUTFILE>]
sample2 -r<RULEBASE> -h<HOST> [-o<OUTPUTFILE>]

VB.NET
Load the .NET assembly into the system cache:
gacutil /i %SSATOP%\bin\ssasecs.dll

You can now execute the programs as follows:


sample1 -r<RULEBASE> -h<HOST>
sample2 -r<RULEBASE> -h<HOST>

Sample 1 - Basic API


Sample 1 demonstrates the use of the Basic API calls. It also demonstrates how to start a search with
an array of field values.

Logic
Open a socket to the Search Server


API call: ids_connect

This opens a socket (communication channel) to the Search Server using TCP/IP.

The Servers host name (or IP address) and port number (1666 by default) are specified as parameters
to this call.


The Search Server is used instead of the Connection Server because this sample does not make use of
the sessions (refer the Sample 2 for an example of how to use sessions).


The call returns a socket handle that must be used on subsequent API calls to communicate over the
same channel.

Sample 1 - Basic API

42

Open a System and start a Search




API call: ids_system_search_start

This call opens a System in preparation for a single search.

The name of a valid Search-Definition defined in the System is used to initialize a Search.

The search fields used in this example are passed to MDM-RE using a Block Array.

MDM-RE will build a set of file records that match the search record and sort them in descending
order of score (by default). The API call will return a count of the number of records in the result set.


Retrieve Result Set




API call: ids_search_get

This API is called repeatedly to retrieve one file record at a time.

Each record returned is in IDT format by default.

 Records can be returned using an output view by calling ids_IDT_views_output_set prior to


starting the search.

Response code 1 is returned when the End-Of-Set has been reached.

It is not mandatory to retrieve all records from the result set (although it would be unusual not to).

Terminate the Search and close the System




API call: ids_system_search_finish

This releases resources held by the Search Server for the Search and System.

Disconnect from the Search Server




API call: ids_disconnect

Closes the socket connection to the Server.

Sample 2 - Advanced API


Sample 2 demonstrates the use of the Advanced API to make slightly more complex (but more efficient)
API calls. It demonstrates the use of sessions and how to start a search with a pre-constructed search
record.

Logic
Open a socket to the Connection Server


API call: ids_connect

This opens a socket (communication channel) to the Connection Server using TCP/IP.

The host name (or IP address) and port number (1667 by default) of the Connection Server are specified as parameters to the call.


43

SAMPLE API PROGRAMS

The Connection Server should be running on the same machine as the client application program (for
maximum performance).


The Connection Server is used instead of the Search Server because this sample will make use of
sessions; a facility implemented by the Connection Server.


The call returns a socket handle that must be used on subsequent API calls to communicate over the
same channel.


Open a Session


API call: ids_session_open

This API call is used to establish a new session with the Connection Server or to reopen an existing
session (created by a previous call).


Specify a session number of -1 to create a new session, or the existing session number to reopen a
previously created session.


Sessions are used to identify resources on the Search Server and to keep them open even when the
client application disconnects from the Connection Server.


Stateless Web based transactions can store/retrieve the session number using a cookie.

Open a System


API call: ids_system_open

This call retrieves the Systems rules from the Rulebase and prepares for making multiple searches.

This is a relatively expensive operation so it is beneficial to reduce the number of times a system is
opened/closed and/or switched.


Retrieve the Input-View layout




API call: ids_search_view_get

This returns the name, number of fields and record length of the current input-view associated with
this Search.


This followed by a call to ids_search_layout

It returns arrays describing the field names, lengths and offsets. As no input (or output) views have
been explicitly set, both views use the default format, which is the IDT layout.


This information is typically used to allocate appropriately sized buffers and/or prompt a client for
search data.


for each Search




Get input data for each field required for search

Start a Search


API call: ids_search_start

An input record is constructed from the search data. It must match the layout of the input-view.
Sample 2 - Advanced API

44

Retrieve Result Set




API call: ids_search_get

This API is called repeatedly to retrieve one record at a time.

Each record returned is in IDT format.

Response code 1 is returned when the End-Of-Set has been reached.

It is not mandatory to retrieve all records from the result set (although it would be unusual not to).

Terminate Search


API call: ids_system_search_finish

This releases resources held by the Search Server for the Search and System.

End-Loop

Close System


API call: ids_system_close

Frees resources held on Search Server.

Close Session (optional)




API call: ids_session_close

This call instructs the Connection Server to free resources held on the Search Server and to invalidate
the session number.


A stateless Web based search will not issue this call unless it will definitely not attempt to reconnect
to the Connection Server using the same session number.


Sessions that have not been closed explicitly with this call will be timed-out (closed) if they remain
inactive for the designated time-out period of the Connection Server.


Disconnect from the Connection Server




API call: ids_disconnect

Closes the socket connection to the Server.

PIDSearch - Persistance ID search API


PIDSearch sample demonstrates the use of search using persistent ID based multi-searches available in
the system.
45

SAMPLE API PROGRAMS

Logic
Open a socket to the Search Server


API call: ids_connect

This opens a socket (communication channel) to the Search Server using TCP/IP.

The Servers host name (or IP address) and port number (1666 by default) are specified as parameters
to this call.


The call returns a socket handle that must be used on subsequent API calls to communicate over the
same channel.

Open a System


API call: ids_system_open

This call retrieves the Systems rules from the Rulebase and prepares for making multiple searches.

This is a relatively expensive operation so it is beneficial to reduce the number of times a system is
opened/closed and/or switched.


Identify the persistent ID search to use




API call: ids_system_pid_searches_count

This call retrieves number of persistent ID based multi-searches defined on a system.

Allocate the area into which an array of the persistent ID based multi-searches defined on the rulebase
will be copied.


List all persistent ID based multi-searches defined.

API call: ids_system_pid_searches_get

This call retrieves the names of all persistent ID based multi-searches defined on the system.

Display the PID search names on the screen and prompt the user to select the PID search name.

Use this PID search to identify the runnable search to use.

Get name of the IDT associated with the PID search




API call: ids_search_IDT_get

This call retreives the name of the IDT associated with the PID search.

IDT name is use to get the searches defined in the system with the same IDT name.

Identify the runnable search to use




API call: ids_system_searches_count

This call retrieves number of searches defined on the system.

Allocate the area into which an array of the searches defined on the rulebase will be copied.
PIDSearch - Persistance ID search API

46

Get the runnable searches defined on the system.

API call: ids_system_searches_get

This call retreives the names of all defined runnable searches.

Walk through the runnable searches and select the runnable search which has same IDT name of PID
search.


API call: ids_search_IDT_get to get the IDT name of the runnable search and compare it with
the IDT name of PID search.


List all valid runnable searches on the screen and prompt the user to select the runnable search.

Construct search record




Retreive number of fields required for searching.

API call: ids_search_fields_count

Allocate memory for field names arrays using number of fields.

Retreive names of the fields required for searching.

API call: ids_search_fields_get

Use field names to prompt the user for search values.

Read the search values for the required field names.

Save the search values into search records.

Retrieve the Input-View layout




API call: ids_search_view_get

This returns the name, number of fields and record length of the current input-view associated with
this Search.


This followed by a call to ids_search_layout

It returns arrays describing the field names, lengths and offsets. As no input (or output) views have
been explicitly set, both views use the default format, which is the IDT layout.


This information is typically used to allocate appropriately sized buffers and/or prompt a client for
search data.


Start a search


API call: ids_search_start

Starts a search using constructed search records.

Get preferred records




API call: ids_pid_search_get

Get preferred records which are a good match for the search record specified in the
ids_search_start


47

SAMPLE API PROGRAMS

For each record in preferred records




Display information about matching record found, its score and fields information.

Show clusters


Retrieve the clusters associated with the preferred records.

API call: ids_pid_search_get_clusters

For each prefix for the associated cluster:


Display prefix and cluster number.
Retrieve number of member records in the cluster.
API call: ids_pid_member_count
Retrieve the member records for the cluster in a loop, until end of set.
API call: ids_pid_member_get
Display each member record.

End Loop
Finish Search


API call: ids_search_finish

This releases resources held by the ids_search_start.

Terminate the Search and close the System




API call: ids_system_search_finish

This releases resources held by the Search Server for the Search and System.

Disconnect from the Search Server




API call: ids_disconnect

Closes the socket connection to the Server.

PIDSearch - Persistance ID search API

48

API Reference
The API allows user written application programs to access functions that provide name-searching
facilities over a network.
The API functions are callable from C, C#, Java, Perl and other Application Languages capable of calling
a DLL. It is also available as an ActiveX control for use in languages such as Visual Basic.
The API is thread safe with the following exception: each thread must establish its own connection to
the Search Server. The behavior of the API with multiple threads accessing the same connection to the
Search Server is undefined.

Data Types
The section discusses the MDM-RE data types used in this document. The Language Specific Bindings
section describes the mapping between the MDM-RE data types and the native data types used for
specific programming languages.

Strings
The String data-type is a variable length piece of memory, terminated with a NUL character (0x00).
When using a String as an input parameter there is no need to explicitly tell MDM-RE how long it is
because MDM-RE can detect its length.
When the API returns a String as an output parameter, the caller must allocate memory for it and
in some programming languages, tell MDM-RE how long it is. For example, in C it is not possible to
detect how long a piece of memory is, so the caller must pass two parameters:

the address of the memory, and

its length.

MDM-RE uses this information to prevent overwriting unallocated memory (which would result in
GPF or core dump).

String Arrays
A StringArray is an array of Strings. It consists of an array of pointers, with each pointer pointing to
a String. A String Array is usually passed through the API using three parameters:

address of the array of pointers,

number of pointers in the array, and

the length of each String.

Note that since there is provision for only one length value, all Strings must be the same length.
49

API REFERENCE

Blocks
A Block data-type is a fixed length piece of memory. It is not NUL terminated. If a value is not long
enough to fill the entire Block, the Block should be padded with spaces on the right. Since MDM-RE
cannot detect how long the memory is, Blocks are usually passed through the API using two parameters:

a pointer to the memory, and

the length of the Block.

Block Arrays
A BlockArray is an array of Blocks. It consists of an array of pointers, with each pointer pointing to a
Block. A Block Array is usually passed through the API using three parameters:

address of the array of pointers,

number of pointers in the array, and

the length of each Block.

Note that since there is provision for only one length value, all Blocks must be the same length.

Nulls and NULs


Some programming languages permit the use of Null pointers (such as C). Null pointers must never be
passed as arguments to any API functions. If you do not wish to provide a value for an argument, use
a NUL terminated (0x00) string instead (a zero-length, empty string).

Error Handling
An API program that receives a negative response code from a call should retrieve the associated error
messages from the Server and log them.
The API function ids_errors_get_all is called repeatedly to retrieve one message at a time. It
returns a positive response code when there are no more messages left to retrieve.

Error Handling

50

Calling from C
For Win32, the C API functions are prototyped in %SSAINC%\ssasecl.h. An import library
%SSALIB%\stssasec.lib is used to link to the application. At run time it will dynamically load
ssasec.dll and ssaiok.dll from the MDM-RE Client bin and SSA-NAME3 bin directories respectively.
For Unix, the C API functions are prototyped in $SSAINC/ssasecl.h and shared libraries are found
in $SSABIN (libssasec.so and libssaiok.so).
The functions return a response code. A negative response code indicates a transport error, after which
the communication channel is closed and no further API calls can be made without reconnecting.

Constants
Constants are declared as #defines, in uppercase using underscores. Constants are prefixed with SSA_,
eg. SSA_MSG_SIZE.

Parameter types
Note: values in BOLD represent information that must be provided to the function.

ids_addr_get_cass_field
Description:
Use this function to retrieve a validated CASS field. The suggestion_idx specifies the suggestion
from which to select the field value. (1..n for validated data, where n is the n_suggest parameter
returned by ids_addr_validate).

Prototype:
long i d s _ a d d r _ g e t _ c a s s _ f i e l d (
long
sockh ,
long
suggest_idx ,
long
field_idx ,
char f i e l d _ v a l u e ,
long
field_value_size
);

//
//
//
//

Long i n
Long i n
Long i n
Block out

Parameters:
sockh is the socket to use for the call
suggest_idx Specifies the nth suggestion from which to get a cass field
field_idx Specifies a cass field within the nth suggestion
field_value The cass field value
51

CALLING FROM C

Return Code:
negative for error, 0 for success

ids_addr_get_cass_field_cnt
Description:
This function returns the maximum number of CASS address fields created as a result of a parse or validate call. Use this value to dynamically allocate the field_length array for the ids_addr_parse
API.

Prototype:
long i d s _ a d d r _ g e t _ c a s s _ f i e l d _ c n t (
long
sockh ,
/ / Long i n
long count
/ / Long o u t
);

Parameters:
sockh is the socket to use for the call
count Returns the max number of cass address fields

Return Code:
negative for error, 0 for success

ids_addr_get_cass_field_info
Description:
This function returns the maximum length of an input address line. It may be used to dynamically
allocate the input lines used for the ids_addr_set_lines API.

Prototype:
long i d s _ a d d r _ g e t _ c a s s _ f i e l d _ i n f o
long
sockh ,
//
long
suggest_idx ,
//
long f i e l d _ l e n g t h ,
//
long
f ie l d_ l en gt h _n u m
);

(
Long i n
Long i n
LongArray o u t

Parameters:
sockh is the socket to use for the call
suggest_idx Specifies the suggestion from which to retrieve information
field_length An array containing the length of each cass address field
ids_addr_get_cass_field_cnt

52

Return Code:
negative for error, 0 for success

ids_addr_get_del_lines_ext
Description:
Use this function to retrieve delivery address line information

Prototype:
long i d s _ a d d r _ g e t _ d e l _ l i n e s _ e x t
long
sockh ,
long
suggest_idx ,
long
del_case ,
char d e l _ l i n e 1 ,
long
del_line1_size ,
char d e l _ l i n e 2 ,
long
del_line2_size ,
char d e l _ l i n e 3 ,
long
del_line3_size ,
char d e l _ l i n e 4 ,
long
del_line4_size ,
char d e l _ l i n e 5 ,
long
del_line5_size ,
char d e l _ l i n e 6 ,
long
del_line6_size
);

(
//
//
//
//

Long i n
Long i n
Long i n
Block out

/ / Block out
/ / Block out
/ / Block out
/ / Block out
/ / Block out

Parameters:
sockh is the socket to use for the call
suggest_idx Specifies the suggestion from which to get delivery address lines
del_case Specifies delivery address line case option value. The allowed values are 0 = Unchanged, 1
= Upper case, 2 = Lower case and 3 = Mixed case.
del_line1 delivery address line 1 output string
del_line2 delivery address line 2 output string
del_line3 delivery address line 3 output string
del_line4 delivery address line 4 output string
del_line5 delivery address line 5 output string
del_line6 delivery address line 6 output string

Return Code:
negative for error, 0 for success
53

CALLING FROM C

ids_addr_get_field
Description:
Use this function to retrieve a validated field. The suggestion_idx specifies the suggestion from
which to select the field value. (1..n for validated data, where n is the n_suggest parameter returned
by ids_addr_validate). val_status and val_mods return a code that describes how the field
matched to validation data and whether or not it was modified by validation. Refer to the Address
Validation section of this manual for a list of codes.

Prototype:
long i d s _ a d d r _ g e t _ f i e l d (
long
sockh ,
long
suggest_idx ,
long
field_idx ,
char f i e l d _ v a l u e ,
long
field_value_size
long f i e l d _ v a l _ s t a t u s
long f i e l d _ v a l _ m o d s
);

/ / Long i n
/ / Long i n
/ / Long i n
/ / Block out
,
, / / Long o u t
/ / Long o u t

Parameters:
sockh is the socket to use for the call
suggest_idx Specifies the nth suggestion from which to get a field
field_idx Specifies a field within the nth suggestion
field_value The field value
field_val_status Specifies how this field matched the validation data
field_val_mods Specifies how this field was modified by validation data

Return Code:
negative for error, 0 for success

ids_addr_get_field_count
Description:
This function returns the maximum number of address fields created as a result of a parse or validate
call. Use this value to dynamically allocate the field_length array for the ids_addr_parse API.

Prototype:
long i d s _ a d d r _ g e t _ f i e l d _ c o u n t (
long
sockh ,
/ / Long i n
long count
/ / Long o u t
);
ids_addr_get_field

54

Parameters:
sockh is the socket to use for the call
count Returns the max number of address fields

Return Code:
negative for error, 0 for success

ids_addr_get_field_ext
Description:
Use this function to retrieve all getter fields

Prototype:
long i d s _ a d d r _ g e t _ f i e l d _ e x t (
long
sockh ,
long
suggest_idx ,
long
field_operation ,
char field_name ,
long
field_item_line ,
char f i e l d _ t y p e ,
char f i e l d _ v a l u e ,
long
field_value_size
);

//
//
//
//
//
//
//

Long i n
Long i n
Long i n
String in
Long i n
String in
Block out

Parameters:
sockh is the socket to use for the call
suggest_idx Specifies the suggestion from which to get fields
field_operation Field operation Option 0 for AddressElements Option 1 for AddressLines Option
2 for AddressComplete Option 3 for EnrichmentData Option 4 for ResultDataParameter Option 5 for
EnrichmentDataStatus
field_name Refer AD Result.dtd for field names
field_item_line Represent field line number or field item number
field_type Refer AD Result.dtd for field attribute Type
field_value Cleansed field output

Return Code:
negative for error, 0 for success
55

CALLING FROM C

ids_addr_get_field_idx
Description:
Use this function to retrieve a parsed or validated field. The suggestion_idx specifies the suggestion from which to select the field value. (0 for parsed data, 1..n for validated data, where n is the
n_suggest parameter returned by ids_addr_validate).

Prototype:
long i d s _ a d d r _ g e t _ f i e l d _ i d x (
long
sockh ,
long
suggest_idx ,
long
field_idx ,
char f i e l d _ v a l u e ,
long
field_value_size
);

//
//
//
//

Long i n
Long i n
Long i n
Block out

Parameters:
sockh is the socket to use for the call
suggest_idx Specifies the nth suggestion from which to get a field. On successful parse, use 0 for
ASM/AD version 4, 1 for ASM/AD version 5
field_idx Specifies a field within the nth suggestion
field_value The field value

Return Code:
negative for error, 0 for success

ids_addr_get_field_info_ext
Description:
Use this function to retrieve a list of individual field lengths after validating an address. Fields with a
length of zero have no value associated with them and can be omitted from the list of fields retrieved
with ids_addr_get_field_idx

Prototype:
long i d s _ a d d r _ g e t _ f i e l d _ i n f o _ e x t (
long
sockh ,
/ / Long i n
long
suggest_idx ,
/ / Long i n
long f i e l d _ l e n g t h ,
/ / LongArray o u t
long
field_length_num ,
char addr_label_encoded , / / B l o c k o u t
long
addr_label_encoded_size ,
char a d d r _ l a b e l _ c h a r s e t , / / S t r i n g o u t
long
addr_label_charset_size ,
long s c o r e
/ / Long o u t
);
ids_addr_get_field_idx

56

Parameters:
sockh is the socket to use for the call
suggest_idx Specifies the suggestion from which to retrieve information
field_length An array containing the length of each address field
addr_label_encoded The returned label
addr_label_charset The character set used in the address label
score The returned labels score

Return Code:
negative for error, 0 for success

ids_addr_get_field_len
Description:
This function returns the maximum length of an individual address field. It may be used to dynamically
allocate the field parameter used for the ids_addr_get_field_idx API.

Prototype:
long i d s _ a d d r _ g e t _ f i e l d _ l e n (
long
sockh ,
long max_len
);

/ / Long i n
/ / Long o u t

Parameters:
sockh is the socket to use for the call
max_len Returns the max address field length in bytes

Return Code:
negative for error, 0 for success

ids_addr_get_line_len
Description:
This function returns the maximum length of an input address line. It may be used to dynamically
allocate the input lines used for the ids_addr_set_lines API.
57

CALLING FROM C

Prototype:
long i d s _ a d d r _ g e t _ l i n e _ l e n (
long
sockh ,
long max_len
);

/ / Long i n
/ / Long o u t

Parameters:
sockh is the socket to use for the call
max_len Returns the max line length in bytes

Return Code:
negative for error, 0 for success

ids_addr_get_option
Description:
Use this function to obtain values of options that control Address Standardization behavior. A list of
options appears in the Address Standardization section of this manual.

Prototype:
long i d s _ a d d r _ g e t _ o p t i o n (
long
sockh ,
char param ,
char value ,
long
value_size
);

/ / Long i n
/ / String in
/ / String out

Parameters:
sockh is the socket to use for the call
param This field specifies the name of the option to get.
value Returns the value of the option.

Return Code:
negative for error, 0 for success

ids_addr_info
Description:
Use this function to request additional information about an input address. This call must always be
preceded with a call to ids_addr_std.
ids_addr_get_option

58

Prototype:
long i d s _ a d d r _ i n f o (
long
sockh ,
char c o n t r o l s ,
char value ,
long
value_size
);

/ / Long i n
/ / String in
/ / String out

Parameters:
sockh is the socket to use for the call
controls this field contains the request information. It must me specified in the form ITEM=[value].
value this field contains the requested information.

Return Code:
negative for error, 0 for success

ids_addr_init
Description:
This function initializes the Address Standardization sub-system. It must be the first call to
ids_addr_* family of functions. The max_memory parameter specifies the maximum amount of
memory (MB) to be used by the Address Standardization engine (within the Search Server process).

Prototype:
long i d s _ a d d r _ i n i t (
long
sockh ,
long
max_memory
);

/ / Long i n
/ / Long i n

Parameters:
sockh is the socket to use for the call
max_memory This field specifies the maximum amount of memory (MB) to be used by the Address
Standardization engine.

Return Code:
negative for error, 0 for success

ids_addr_parse
Description:
Use this function to parse an address. The individual field lengths after parsing an address are returned
in the field_length array. Fields with a length of zero have no value associated with them and can be
omitted from the list of fields retrieved with ids_addr_get_field_idx
59

CALLING FROM C

Prototype:
long i d s _ a d d r _ p a r s e (
long
sockh ,
/ / Long i n
long f i e l d _ l e n g t h ,
/ / LongArray o u t
long
f ie l d_ l en gt h _n u m
);

Parameters:
sockh is the socket to use for the call
field_length An array containing the length of each parsed field

Return Code:
negative for error, 0 for success

ids_addr_preload_country
Description:
Use this function to preload country database

Prototype:
long i d s _ a d d r _ p r e l o a d _ c o u n t r y (
long
sockh ,
char preload_type ,
char preload_country
char val_mode
);

//
//
, //
//

Long i n
String in
String in
String in

Parameters:
sockh is the socket to use for the call
preload_type Type of preload to perform
preload_country Country database to be preloaded
val_mode Validation mode to be used

Return Code:
negative for error, 0 for success

ids_addr_set_attrib
Description:
Use this function to specify the character set of the data (for both input and output). The default_country parameter specifies that default country to use when parsing cannot identify a country
ids_addr_preload_country

60

from the address. This API must be called prior to parsing or validating an address. The values stay in
effect for the life of the session, or until they are changed.

Prototype:
long i d s _ a d d r _ s e t _ a t t r i b (
long
sockh ,
/ / Long i n
char c h a r _ s e t ,
/ / String in
char d e f a u l t _ c o u n t r y / / S t r i n g i n
);

Parameters:
sockh is the socket to use for the call
char_set The name of the character set used to encode the input and output.
default_country The default country used for validation when parsing cannot detect a country
name.

Return Code:
negative for error, 0 for success

ids_addr_set_del_lines
Description:
Use this function to set delivery address line information

Prototype:
long i d s _ a d d r _ s e t _ d e l _ l i n e s (
long
sockh ,
char d e l _ l i n e 1 ,
long
del_line1_size
char d e l _ l i n e 2 ,
long
del_line2_size
char d e l _ l i n e 3 ,
long
del_line3_size
char d e l _ l i n e 4 ,
long
del_line4_size
char d e l _ l i n e 5 ,
long
del_line5_size
char d e l _ l i n e 6 ,
long
del_line6_size
);

/ / Long i n
/ / Block in
,
/ / Block in
,
/ / Block in
,
/ / Block in
,
/ / Block in
,
/ / Block in

Parameters:
sockh is the socket to use for the call
del_line1 delivery address line 1 input string
61

CALLING FROM C

del_line2 delivery address line 2 input string


del_line3 delivery address line 3 input string
del_line4 delivery address line 4 input string
del_line5 delivery address line 5 input string
del_line6 delivery address line 6 input string

Return Code:
negative for error, 0 for success

ids_addr_set_field_case
Description:
Use this function to set individual input fields case option

Prototype:
long i d s _ a d d r _ s e t _ f i e l d _ c a s e (
long
sockh ,
long
field_idx ,
long
field_case
);

/ / Long i n
/ / Long i n
/ / Long i n

Parameters:
sockh is the socket to use for the call
field_idx Specifies the nth field to set
field_case Specifies output field case option value. The allowed values are 0 = Unchanged, 1 =
Upper case, 2 = Lower case and 3 = Mixed case.

Return Code:
negative for error, 0 for success

ids_addr_set_field_ext
Description:
Use this function to set fields
ids_addr_set_field_case

62

Prototype:
long i d s _ a d d r _ s e t _ f i e l d _ e x t (
long
sockh ,
long
field_operation ,
char field_name ,
long
field_item_line ,
char f i e l d _ t y p e ,
char f i e l d _ v a l u e ,
long
field_value_size
);

//
//
//
//
//
//

Long i n
Long i n
String in
Long i n
String in
Block in

Parameters:
sockh is the socket to use for the call
field_operation Field operation Option 0 for AddressElements Option 1 for AddressLines
field_name Refer AD Result.dtd for field names
field_item_line Represent field line number or field item number
field_type Refer AD Result.dtd for field attribute Type
field_value input field value

Return Code:
negative for error, 0 for success

ids_addr_set_field_idx
Description:
Use this function to specify the value of an input field. This API is used to specify an input address that
has already been pre-parsed into separate fields.

Prototype:
long i d s _ a d d r _ s e t _ f i e l d _ i d x (
long
sockh ,
/ / Long i n
long
field_idx ,
/ / Long i n
char f i e l d _ v a l u e ,
/ / Block in
long
field_value_size
);

Parameters:
sockh is the socket to use for the call
field_idx Specifies the nth field to set
field_value Specifies a value for the nth field
63

CALLING FROM C

Return Code:
negative for error, 0 for success

ids_addr_set_field_name
Description:
Use this function to set individual input fields by name

Prototype:
long i d s _ a d d r _ s e t _ f i e l d _ n a m e (
long
sockh ,
/ / Long i n
char field_name ,
/ / String in
char f i e l d _ v a l u e ,
/ / Block in
long
field_value_size
);

Parameters:
sockh is the socket to use for the call
field_name Specifies the name of the field to set
field_value Specifies a value for the field

Return Code:
negative for error, 0 for success

ids_addr_set_lines
Description:
Use this function to specify the value of an input field. This API is used to specify an input address that
has already been pre-parsed into separate fields.

Prototype:
long i d s _ a d d r _ s e t _ l i n e s (
long
sockh ,
char l i n e _ 1 ,
long
line_1_size
char l i n e _ 2 ,
long
line_2_size
char l i n e _ 3 ,
long
line_3_size
char l i n e _ 4 ,
long
line_4_size
char l i n e _ 5 ,

/ / Long i n
/ / Block in
,
/ / Block in
,
/ / Block in
,
/ / Block in
,
/ / Block in
ids_addr_set_field_name

64

long
char
long
char
long
char
long
char
long
char
long

line_5_size ,
line_6 ,
line_6_size ,
line_7 ,
line_7_size ,
line_8 ,
line_8_size ,
line_9 ,
line_9_size ,
line_10 ,
line_10_size

/ / Block in
/ / Block in
/ / Block in
/ / Block in
/ / Block in

);

Parameters:
sockh is the socket to use for the call
line_1 The first line of the address
line_2 The second line of the address
line_3 The third line of the address
line_4 The fourth line of the address
line_5 The fifth line of the address
line_6 The sixth line of the address
line_7 The seventh line of the address
line_8 The eighth line of the address
line_9 The ninth line of the address
line_10 The tenth line of the address

Return Code:
negative for error, 0 for success

ids_addr_set_option
Description:
Use this function to set values of options that control Address Standardization behavior. A list of
options appears in the Address Standardization section of this manual.

Prototype:
long i d s _ a d d r _ s e t _ o p t i o n (
long
sockh ,
char param ,
char value
);
65

CALLING FROM C

/ / Long i n
/ / String in
/ / String in

Parameters:
sockh is the socket to use for the call
param This field specifies the name of the option to set.
value This field specifies a value for the option.

Return Code:
negative for error, 0 for success

ids_addr_std
Description:
Use this function to request IDS to standardize an address by validating it against USPS validation
tables and formatting it to comply with U.S. Postal Addressing Standards. This API requires the separately licensable IDS Address Standardization Module to be installed.

Prototype:
long i d s _ a d d r _ s t d (
long
sockh ,
//
char firm_name ,
//
long
firm_name_size ,
char u r b a n i z a t i o n ,
//
long
urbanization_size ,
char address_one ,
//
long
address_one_size ,
char address_two ,
//
long
address_two_size ,
char l a s t _ l i n e ,
//
long
last_line_size
);

Long i n
String io
String io
String io
String io
String io

Parameters:
sockh is the socket to use for the call
firm_name It contains the name of the firm (may be blank).
urbanization this field can contain name of an urban development within a geographic area. It is
only used with Puerto Rican addresses.
address_one this field contains the Delivery Address Line. It normally consists of a street number,
pre-directional, street name, street suffix, post-directional and possibly some secondary address components such as apartment number.
address_two this field contains additional Delivery Address Line components. It is normally only
used when address_one is very long.
last_line this field contains the Last Line information: the city name, state abbreviation and zip
code (and possibly the Zip + 4 code).
ids_addr_std

66

Return Code:
0 indicates an exact match to a valid address
1 indicates a no match (invalid address)
2 indicates a multi match (non-unique address), and
< 0 indicates an error

ids_addr_validate
Description:
Use this function to validate an address

Prototype:
long i d s _ a d d r _ v a l i d a t e (
long
sockh ,
long s t a t u s ,
long n_suggest
);

/ / Long i n
/ / Long o u t
/ / Long o u t

Parameters:
sockh is the socket to use for the call
status The status returned by the validation process
n_suggest The number of suggestions generated by validation

Return Code:
negative for error, 0 for success

ids_connect
Description:
Initiates a socket.

Prototype:
long i d s _ c o n n e c t (
char host ,
long
port ,
long sockh
);

Parameters:
host is the host to connect to.
67

CALLING FROM C

/ / String in
/ / Long i n
/ / Long o u t

port is the port to connect to.


sockh is a socket handle.

Return Code:
negative for error, 0 for success

ids_disconnect
Description:
Releases resources allocated to a socket.

Prototype:
long i d s _ d i s c o n n e c t (
long
sockh
);

/ / Long i n

Parameters:
sockh is the socket to use for the call

Return Code:
negative for error, 0 for success

ids_error_get
Description:
Get the error messages from the last API function that failed. This function should be called repeatedly
until it returns 1, meaning all messages have been retrieved.
Note: if a communication (socket) error occurred, this function will also fail. Refer to the
O PERATIONS M ANUAL, Error Log section for help in interpreting the Error Log.

Prototype:
long i d s _ e r r o r _ g e t (
long
sockh ,
char msg ,
long
msg_size
);

/ / Long i n
/ / String out

Parameters:
sockh is the socket to use for the call
msg is the error message returned
ids_disconnect

68

Return Code:
0 for success, -ve for error and 1 for no more errors to retrieve.

ids_errors_get_all
Description:
Get the Server side error messages from the last API function that failed. This function should be called
repeatedly until it returns 1, meaning all messages have been retrieved.
Note: if a communication (socket) error occurred, this function will also fail. Refer to the
O PERATIONS M ANUAL, Error Log section for information on interpreting the Error Log.

Prototype:
long i d s _ e r r o r s _ g e t _ a l l (
long
sockh ,
char msg ,
long
msg_size
);

/ / Long i n
/ / String out

Parameters:
sockh is the socket to use for the call
msg is an error message.

Return Code:
negative for error, 0 for success

ids_identify
Description:
Identify a session to the console

Prototype:
long i d s _ i d e n t i f y (
long
sockh ,
char i d e n t i f i c a t i o n
);

/ / Long i n
/ / String in

Parameters:
sockh is the socket to use for the call
identification is user supplied identitification for display on the console
69

CALLING FROM C

Return Code:
negative for error, 0 for success

ids_is_little_endian
Description:
Checks if the search server is running on a little endian platform

Prototype:
long i d s _ i s _ l i t t l e _ e n d i a n (
long
sockh ,
long e n d i a n _ s t a t e
);

/ / Long i n
/ / Long o u t

Parameters:
sockh is the socket to use for the call
endian_state Returns 1 if the search server is running on a little endian platform. Returns 0 for
others

Return Code:
negative for error, 0 for success

ids_match_explain
Description:
Explains the match result given search and file records As match_explain_count does not give the exact
number of output rows for this call, but instead provides a maximal estimate, some of the info blocks
returned will be filled with NULL bytes. Test a block for validity by checking the first byte is not NULL.
Info blocks returned are not all the same length either. They are NULL filled on the right.

Prototype:
long i d s _ m a t c h _ e x p l a i n (
long
sockh ,
char search ,
char m a t c h _ t o l e r a n c e
char s e a r c h r e c ,
long
searchrec_size ,
char f i l e r e c ,
long
filerec_size ,
char i n f o _ a r r a y ,
long
info_array_num ,
long
info_array_size
);

//
//
, //
//

Long i n
String in
String in
Block in

/ / Block in
/ / BlockArray out

ids_is_little_endian

70

Parameters:
sockh is the socket to use for the call
search is the name of the Search which was performed.
match_tolerance specifies either Conservative, Typical or Loose to nominate how aggressive
the matching scheme should be in rejecting candidates.
searchrec is the IDT record used to search with. It is returned by the Search Server.
filerec is the record to be matched agains the searchrec
info_array An array describing the match results. See the Match Explain API section for details

Return Code:
negative for error, 0 for success

ids_match_explain_count
Description:
Estimate number of info blocks required for a subsequent match_explain call

Prototype:
long i d s _ m a t c h _ e x p l a i n _ c o u n t (
long
sockh ,
char search ,
long count
);

/ / Long i n
/ / String in
/ / Long o u t

Parameters:
sockh is the socket to use for the call
search is the name of the Search which was performed.
count Returns the maximum number of info blocks required to explain the search results

Return Code:
negative for error, 0 for success

ids_pid_close
Description:
Closes resources opened with the ids_pid_open call.
71

CALLING FROM C

Prototype:
long i d s _ p i d _ c l o s e (
long
sockh
);

/ / Long i n

Parameters:
sockh is the socket to use for the call

Return Code:
negative for error, 0 for success

ids_pid_member_count
Description:
Retrieve the number of member records in a cluster

Prototype:
long ids_pid_member_count (
long
sockh ,
char p r e f i x ,
long
prefix_size ,
long
cluster_num ,
long count
);

/ / Long i n
/ / Block in
/ / Long i n
/ / Long o u t

Parameters:
sockh is the socket to use for the call
prefix is the persistent ID prefix for the cluster to look up.
cluster_num is the cluster number for the cluster to look up.
count the number of member records found for the cluster

Return Code:
negative for error, 0 for success

ids_pid_member_get
Description:
Called after ids_pid_member_count in a consecutive manner to retrieve the member records for a
cluster.
ids_pid_member_count

72

Prototype:
long ids_pid_member_get (
long
sockh ,
char p r e f i x ,
long
prefix_size ,
long
cluster_num ,
char record ,
long
record_size ,
long r e c i d
);

/ / Long i n
/ / Block in
/ / Long i n
/ / Block out
/ / Long o u t

Parameters:
sockh is the socket to use for the call
prefix is the persistent ID prefix for the cluster.
cluster_num cluster_num is the cluster number for the cluster.
record the member record in IDT layout.
recid is rhe Rescord-Id for the member record (corresponding to the RECID column from the IDT)

Return Code:
negative for error, 0 for success, and 1 for "end of set".

ids_pid_open
Description:
Open resources for use with Persistent-ID.

Prototype:
long ids_pid_open (
long
sockh ,
char m u l t i _ s e a r c h
);

/ / Long i n
/ / String in

Parameters:
sockh is the socket to use for the call
multi_search is the name of a multi-search which uses Persistent-ID. This function requires a prior
call to ids_system_open.

Return Code:
negative for error, 0 for success
73

CALLING FROM C

ids_pid_search_get
Description:
Retrieve Preferred records which are a good match for the search record specified in the
ids_search_start or ids_system_search_start function. This function will return extended
matching information, including the match decision and the file (IDT) record-ID of the matching
records.

Prototype:
long i d s _ p i d _ s e a r c h _ g e t (
long
sockh ,
char search ,
char f i l e _ r e c ,
long
file_rec_size ,
long s c o r e ,
char d e c i s i o n ,
long
decision_size ,
long f i l e _ r e c i d ,
long c l u s t e r _ c o u n t
);

/ / Long i n
/ / String in
/ / Block out
/ / Long o u t
/ / String out
/ / Long o u t
/ / Long o u t

Parameters:
sockh is the socket to use for the call
search is the name of the Search which was performed.
file_rec is the matched File record.
score is the degree of similarity between the Search and File records (0-100).
decision is the match decision: A(ccept) or U(ndecided)
file_recid is the File Record-ID (corresponding to the RECID column from the IDT).
cluster_count is the number of clusters asociated with the cluster.

Return Code:
negative for error, 0 for success, and 1 for "end of set".

ids_pid_search_get_clusters
Description:
May be called after each call to ids_pid_search_get to retrieve the clusters associated with the
preferred record.
ids_pid_search_get

74

Prototype:
long i d s _ p i d _ s e a r c h _ g e t _ c l u s t e r s (
long
sockh ,
//
char search ,
//
long
file_recid ,
//
char p r e f i x s ,
//
long
prefixs_num ,
long
prefixs_size ,
long cluster_nums ,
//
long
cluster_nums_num
);

Long i n
String in
Long i n
BlockArray out

LongArray o u t

Parameters:
sockh is the socket to use for the call
search is the name of the Search which was performed.
file_recid is the Preferred Record-ID (corresponding to the RECID column from the IDT).
prefixs is the prefix for the associated cluster
cluster_nums is the number for the asociated cluster

Return Code:
negative for error, 0 for success

ids_pid_src_pk_get
Description:
Get persistent ids one at a time

Prototype:
long i d s _ p i d _ s r c _ p k _ g e t (
long
sockh ,
/ / Long i n
char src_pk_value ,
/ / BlockArray out
long
src_pk_value_num ,
long
src_pk_value_size
);

Parameters:
sockh is the socket to use for the call
src_pk_value the values of primary keys from the source table

Return Code:
negative for error, 0 for success
75

CALLING FROM C

ids_pid_src_pk_start
Description:
Search for persistent ids

Prototype:
long i d s _ p i d _ s r c _ p k _ s t a r t (
long
sockh ,
char m u l t i _ s e a r c h ,
char src_pk ,
long
src_pk_num ,
long
src_pk_size
);

/ / Long i n
/ / String in
/ / BlockArray in

Parameters:
sockh is the socket to use for the call
multi_search the name of the multi-search
src_pk the values of primary keys from the source table

Return Code:
negative for error, 0 for success

ids_ps_get_entity_list
Description:
Retrieves entity names supported by the current population

Prototype:
long i d s _ p s _ g e t _ e n t i t y _ l i s t (
long
sockh ,
char gross_names ,
long
gross_names_num ,
long
gross_names_size
char fine_names ,
long
fine_names_num ,
long
fine_names_size
);

/ / Long i n
/ / StringArray out
,
/ / StringArray out

Parameters:
sockh is the socket to use for the call
gross_names List of Gross entity names
fine_names List of Fine entity names
ids_pid_src_pk_start

76

Return Code:
negative for error, 0 for success

ids_ps_get_entity_max_elements
Description:
Retrieves number of entity array elements

Prototype:
long i d s _ p s _ g e t _ e n t i t y _ m a x _ e l e m e n t s (
long
sockh ,
/ / Long i n
char type ,
/ / String in
long elements
/ / Long o u t
);

Parameters:
sockh is the socket to use for the call
type Type of entity: Input, Gross, Fine, Standard, Format
elements maximum number of occurrences

Return Code:
negative for error, 0 for success

ids_ps_get_entity_max_length
Description:
Retrieves maximum length of an entity value

Prototype:
long i d s _ p s _ g e t _ e n t i t y _ m a x _ l e n g t h
long
sockh ,
//
char type ,
//
long l e n g t h
//
);

(
Long i n
String in
Long o u t

Parameters:
sockh is the socket to use for the call
type Type of entity: Input, Gross, Fine, Standard, Format
length maximum length (bytes) of an entity value
77

CALLING FROM C

Return Code:
negative for error, 0 for success

ids_ps_parse
Description:
Parse, Standardize and Format API

Prototype:
long i d s _ p s _ p a r s e (
long
sockh ,
char o p e r a t i o n ,
char input ,
long
input_size ,
char gross ,
long
gross_num ,
long
gross_size ,
char f i n e ,
long
fine_num ,
long
fine_size ,
char standard ,
long
standard_num ,
long
standard_size ,
char ps_format ,
long
ps_format_num ,
long
ps_format_size
);

/ / Long i n
/ / String in
/ / Block in
/ / BlockArray io

/ / BlockArray io

/ / BlockArray io

/ / BlockArray out

Parameters:
sockh is the socket to use for the call
operation The operation(s) to perform: G, F, S, M
input Unparsed input string
gross Gross entities used as input or output
fine Fine entities used as input or output
standard Standardized entities used as input or output
ps_format Formatted output string

Return Code:
negative for error, 0 for success

ids_ps_set_encoding
Description:
Defines encoding used for the input/output data
ids_ps_parse

78

Prototype:
long i d s _ p s _ s e t _ e n c o d i n g (
long
sockh ,
long
encoding
);

/ / Long i n
/ / Long i n

Parameters:
sockh is the socket to use for the call
encoding 0=Population default, 8=UTF-8, 16=UTF-16

Return Code:
negative for error, 0 for success

ids_ps_set_entity_list
Description:
Defines a subset of entities for input/output

Prototype:
long i d s _ p s _ s e t _ e n t i t y _ l i s t (
long
sockh ,
/ / Long i n
char type ,
/ / String in
char e n t i t y _ l i s t ,
/ / StringArray in
long
entity_list_num
);

Parameters:
sockh is the socket to use for the call
type Type of entity: Gross or Fine
entity_list List of entity names

Return Code:
negative for error, 0 for success

ids_ps_set_population
Description:
Defines the System and Population used for parsing rules
79

CALLING FROM C

Prototype:
long i d s _ p s _ s e t _ p o p u l a t i o n (
long
sockh ,
char system ,
char p o p u l a t i o n
);

/ / Long i n
/ / String in
/ / String in

Parameters:
sockh is the socket to use for the call
system System Name
population Specifies a Population within the System

Return Code:
negative for error, 0 for success

ids_real_time_async_get
Description:
Used to retrieve the result count associated with a call to ids_real_time_async_start.
cluster_action_count specifies the number of results that are available for collection using
ids_real_time_sync_get.

Prototype:
long i d s _ r e a l _ t i m e _ a s y n c _ g e t (
long
sockh ,
/ / Long i n
char r e f e r e n c e ,
/ / String in
long
block ,
/ / Long i n
long c l u s t e r _ a c t i o n _ c o u n t / / Long o u t
);

Parameters:
sockh is the socket to use for the call
reference A
reference
number
ids_real_time_sync_start)

identifying

the

request

(returned

by

block 1 = wait for a response 0 = return immediately if no results are available yet
cluster_action_count The number of clusters generated These can be returned with call to
real_time_sync_get 1 = wait for a response

Return Code:
negative for error 0 for success positive for no results are available yet
ids_real_time_async_get

80

ids_real_time_async_start
Description:
Used to start a synchronizer transaction of the Real Time Synchronization server. This call works in an
asynchronous fashion and will return when the transaction has been placed on the servers work queue
rather than when the transaction has been processed. The record passed in must match the layout of
the IDT. This call must be followed by a call to ids_real_time_async_get, then by one or more
calls to ids_real_time_sync_get to retrieve the results.

Prototype:
long i d s _ r e a l _ t i m e _ a s y n c _ s t a r t (
long
sockh ,
//
char r u l e b a s e ,
//
char system ,
//
char IDT ,
//
char sequence_number , / /
char o p e r a t i o n ,
//
char c l u s t e r _ r e c o r d , / /
long
cluster_record_size
long
source ,
//
char m u l t i _ s e a r c h ,
//
long
input_id ,
//
char r e f e r e n c e ,
//
long
reference_size
);

Long i n
String in
String in
String in
String in
String in
Block in
,
Long i n
String in
Long i n
String out

Parameters:
sockh is the socket to use for the call
rulebase is the name of the rulebase.
system The name of the system in the rulebase
IDT is the name of the IDT associated with the update.
sequence_number is a string that specifies the order of synchronization. Must obey the rules for
sequence numbers found in the O PERATIONS M ANUAL.
operation The synchronizer operation being performed: A for add or D for delete
cluster_record The record to be updated. The record must use the same layout as the IDT.
source Identifies the source of clustering: 0 = Real Time Synchronizer 1 = Flat file 2 = NSA table
multi_search The name of the multi-search which uses Persistent-ID. This parameter should be set
to an empty string for an IDT/IDX only transaction.
input_id The cluster id or record id as appropriate
reference A reference string identifying the request.
ids_real_time_sync_get call when retrieving results.
81

CALLING FROM C

This must be passed to the

Return Code:
negative for error
0 for success positive for warnings:
1-9 Reserved for future use
10 warnings: Duplicate PK detected on add to IDT with WARN_DUPLICATE_PK sync option.
11 warnings: Duplicate transaction was skipped.
12 warnings: Transaction was rejected because the sequence number was less than or equal to a previous transaction. The record was added to the reject table.

ids_real_time_flul_add
Description:
This API used to add force link and unlink rule.
ids_real_time_flul_init.

This call must be followed by

Prototype:
long i d s _ r e a l _ t i m e _ f l u l _ a d d (
long
sockh ,
/ / Long i n
char r u l e _ t y p e ,
/ / String in
char s u b j e c t _ r e c _ p k , / / B l o c k i n
long
subject_rec_pk_size ,
char r e l a t i o n s h i p ,
/ / String in
char r e l a t e d _ r e c _ p k , / / B l o c k i n
long
related_rec_pk_size
);

Parameters:
sockh is the socket to use for the call
rule_type This field is for specifying the type of the rule. A value of A represents that the rule needs
to be added to the system and D represents that a rule needs to be removed from the system
subject_rec_pk This field is for specifying the PK of the subject record
relationship This field is for specifying the relationship between the subject record and related
record. A value of L represents a Link rule between the subject record and the related record and a
value of U represents an Unlink rule between the subject record and the related record.
related_rec_pk This field is for specifying the PK of the record that is either linked or unlinked to
the subject record.

Return Code:
negative for error, 0 for success 3 when the Link rule is not allowed. Record unlinked with members of
subject cluster.
ids_real_time_flul_add

82

ids_real_time_flul_close
Description:
This API used to close and release force link and unlink module.

Prototype:
long i d s _ r e a l _ t i m e _ f l u l _ c l o s e (
long
sockh
/ / Long i n
);

Parameters:
sockh is the socket to use for the call

Return Code:
negative for error, 0 for success

ids_real_time_flul_delete
Description:
This API used to delete force link and unlink rule from MR table. This call must be followed by
ids_real_time_flul_init.

Prototype:
long i d s _ r e a l _ t i m e _ f l u l _ d e l e t e (
long
sockh ,
/ / Long i n
long
r u l e _ t y p e _ o p t i o n , / / Long i n
char record_pk ,
/ / Block in
long
record_pk_size
);

Parameters:
sockh is the socket to use for the call
rule_type_option

0 Delete only disabled rules for input pk.

1 Delete only active rules for input pk.


2 Delete all rules for input pk.
record_pk This field is for specifying the PK of the record to be deleted

Return Code:
negative for error, 0 for success
83

CALLING FROM C

ids_real_time_flul_find_rule
Description:
This API used to find link and unlink information for input IDT record. should be called after
ids_real_time_flul_init API.

Prototype:
long i d s _ r e a l _ t i m e _ f l u l _ f i n d _ r u l e
long
sockh ,
//
char i d t _ r e c ,
//
long
idt_rec_size ,
long
option
//
);

(
Long i n
Block in
Long i n

Parameters:
sockh is the socket to use for the call
idt_rec This field is for specifying the PK of the record to be searched
option

0 Link Rule.

1 Unlink Rule.

Return Code:
negative for error, 0 for success

ids_real_time_flul_get_rule
Description:
This API used fetch link and unlink information for input IDT record.
ids_real_time_flul_find_rule API.

Should be called after

Prototype:
long i d s _ r e a l _ t i m e _ f l u l _ g e t _ r u l e (
long
sockh ,
/ / Long i n
char i d t _ r e c ,
/ / Block out
long
idt_rec_size
);

Parameters:
sockh is the socket to use for the call
idt_rec is the matched File record for input link or unlink rule.
ids_real_time_flul_find_rule

84

Return Code:
negative for error, 0 for success

ids_real_time_flul_init
Description:
This API used to initialize force link and unlink module.
Memory allocated a part of
ids_real_time_flul_init is released using ids_real_time_flul_close.

Prototype:
long i d s _ r e a l _ t i m e _ f l u l _ i n i t (
long
sockh ,
char idt_name ,
char m u l t i _ s e a r c h
);

/ / Long i n
/ / String in
/ / String in

Parameters:
sockh is the socket to use for the call
idt_name is the name of the IDT associated with the force link and unlink rule.
multi_search The name of the multi-search which uses Persistent-ID. This parameter should be set
to an empty string for an IDT only MR rule creation.

Return Code:
negative for error, 0 for success

ids_real_time_sync_get
Description:
Use to retrieve the results and free the resources associated with a call to
ids_real_time_sync_start or ids_real_time_async_start. Should be called until it
returns a non zero response.

Prototype:
long i d s _ r e a l _ t i m e _ s y n c _ g e t (
long
sockh ,
/ / Long i n
char r e f e r e n c e ,
/ / String in
char c l u s t e r _ a c t i o n _ t y p e , / / S t r i n g o u t
long
cluster_action_type_size ,
char c l u s t e r _ a c t i o n _ i d , / / S t r i n g o u t
long
cluster_action_id_size ,
long c l u s t e r _ a c t i o n _ n u m b e r , / / Long o u t
char c l u s t e r _ a c t i o n _ n e w , / / S t r i n g o u t
long
cluster_action_new_size
);
85

CALLING FROM C

Parameters:
sockh is the socket to use for the call
reference A reference string identifying the request.
ids_real_time_sync_get call when retriving results.

This must be passed to the

cluster_action_type Identifies the action, ie add or delete


cluster_action_id The prefix which identifies the cluster
cluster_action_number The number which identifies the cluster
cluster_action_new Identifies whether the cluster is newly formed or existing

Return Code:
negative for error, 0 for success, 1 for end of results

ids_real_time_sync_start
Description:
Used to start a synchronizer transaction of the Real Time Synchronization server. This call works
in a synchronous fashion returning only when the transaction has been processed. The record
passed in must match the layout of the IDT. This call must be followed by one or more calls to
ids_real_time_sync_get to retrieve results.

Prototype:
long i d s _ r e a l _ t i m e _ s y n c _ s t a r t (
long
sockh ,
/ / Long i n
char r u l e b a s e ,
/ / String in
char system ,
/ / String in
char IDT ,
/ / String in
char sequence_number , / / S t r i n g i n
char o p e r a t i o n ,
/ / String in
char c l u s t e r _ r e c o r d , / / B l o c k i n
long
cluster_record_size ,
long c l u s t e r _ a c t i o n _ c o u n t , / / Long o u t
char r e f e r e n c e ,
/ / String out
long
reference_size
);

Parameters:
sockh is the socket to use for the call
rulebase is the name of the rulebase.
system The name of the system in the rulebase
IDT is the name of the IDT associated with the update.
sequence_number is a string that specifies the order of synchronization. Must obey the rules for
sequence numbers found in the O PERATIONS M ANUAL.
ids_real_time_sync_start

86

operation The synchronizer operation being performed: A for add or D for delete
cluster_record The record to be updated. The record must use the same layout as the IDT.
cluster_action_count The number of clusters generated. For IDT/IDX only processing this parameter will always be 0. These can be returned with ids_real_time_sync_get
reference A reference string identifying the request.
ids_real_time_sync_get call when retriving results.

This must be passed to the

Return Code:
negative for error
0 for success, and postive for warnings:
1-9 Reserved for future use
10 warning: Duplicate PK detected on add to IDT with WARN_DUPLICATE_PK sync option.
11 warning: Transaction was skipped.
12 warning: Transaction was reject because the sequence number was lessa than or equal to a previous
transaction. The record was added to the reject table.
13 warning: Transaction became a No Op. e.g. Add followed by delete in the same commit cycle
equates to do nothing.
14 warning: Force server shutdown in progress.
15 warning: Could not perform delete as the IDT record was not found. This will normally trigger
error unless the appropriate option is set in the syncronization server configuration.

ids_scores_get
Description:
Retrieve an array of scores, one per match record. This API is used in conjunction with ids_search_start
when candidate records to be matched are provided by the caller. The records and their scores may be
retrieved either by repeatedly calling ids_search_get or by calling this function to retrieve all scores at
once. A limit of 1024 scores may be returned in a single call. When using this function, please ensure
that an Accept limit of 0 has been specified (so that all candidates are returned regardless of their score),
and specify a SORT= parameter in the Search-Definition to ensure that the records remain in the same
order as passed otherwise they will be sorted by descending score. This is perhaps best achieved by
inserting a record number in each row and sorting by that field. The size of the scores array must be
equal to the number of input records to be matched, and may not exceed 1024.

Prototype:
long i d s _ s c o r e s _ g e t (
long
sockh ,
char searchname ,
long s c o r e s ,
long
scores_num
);
87

CALLING FROM C

/ / Long i n
/ / String in
/ / LongArray o u t

Parameters:
sockh is the socket to use for the call
searchname is the name of the associated search
scores is an array of scores, one per candidate record

Return Code:
negative for error, 0 for success

ids_search_comment_get
Description:
Returns the user defined comment stored with the search.

Prototype:
long ids_search_comment_get (
long
sockh ,
char searchname ,
char comment ,
long
comment_size
);

/ / Long i n
/ / String in
/ / String out

Parameters:
sockh is the socket to use for the call
searchname the search to count.
comment is the area to copy the string containing the comment. This string will be null-terminated.

Return Code:
negative for error, 0 for success

ids_search_dedupe_start
Description:
Search for duplicate records in the IDT. Refer to the Dup Finder section in this manual for details.

Prototype:
ids_search_comment_get

88

long i d s _ s e a r c h _ d e d u p e _ s t a r t (
long
sockh ,
char search ,
char search_width ,
char m a t c h _ t o l e r a n c e
char parameters ,
long
parameters_num ,
long
parameters_size
char s e a r c h r e c ,
long
searchrec_size ,
char AnswersetName ,
long
flags ,
long r e c i d ,
long r e c s
);

//
//
//
, //
//

Long i n
String in
String in
String in
BlockArray in

,
/ / Block io
//
//
//
//

String in
Long i n
Long i o
Long i o

Parameters:
sockh is the socket to use for the call
search is the name of the search that is to be performed.
search_width specifies either Narrow, Typical or Exhaustive to nominate how many candidates should be selected.
match_tolerance specifies either Conservative, Typical or Loose to nominate how aggressive
the matching scheme should be in rejecting candidates.
parameters not used.
searchrec is the IDT record used to search with. It is returned by the Search Server.
AnswersetName is used store the search results in an AnswerSet. The Answerset is used to identify
the Search results in the table and is constructed by concatenating the AnswersetName parameter with
the Search-Record-Id (10 bytes) . The maximum AnswersetName length is 22 characters. If you do not
wish to store the search results in an AnswerSet, set AnswersetName to an empty String.
flags flags for specifying options. This field is a bit-field. Valid values are: 2 = return search record
only. 4=remove search record from returned set.
recid the recid of the record to start a searching on. A value of 0 starts searching from the beginning
of the IDT. The returned value is the recid of the next record to be searched.
recs the number of records in the search set.

Return Code:
negative for error, 0 for success, and 1 for truncation of the search set.

ids_search_fields_count
Description:
Gets the number of fields required to assemble the search record.
89

CALLING FROM C

Prototype:
long i d s _ s e a r c h _ f i e l d s _ c o u n t (
long
sockh ,
char searchname ,
long f c
);

/ / Long i n
/ / String in
/ / Long o u t

Parameters:
sockh is the socket to use for the call
searchname the search to count.
fc is the number of fields required to be filled in to assemble the search.

Return Code:
negative for error, 0 for success

ids_search_fields_get
Description:
Gets the number of fields required to assemble the search record.

Prototype:
long i d s _ s e a r c h _ f i e l d s _ g e t (
long
sockh ,
/ / Long i n
char searchname ,
/ / String in
char fieldnames ,
/ / StringArray out
long
fieldnames_num ,
long
fieldnames_size
);

Parameters:
sockh is the socket to use for the call
searchname the search to count.
fieldnames is the array returned which will contain the name of the fields.

Return Code:
negative for error, 0 for success

ids_search_filter
Description:
Sets a dynamic SQL filter to be used by a search. Refere to the SQL Filters section of the D ESIGNER
M ANUAL for details about SQL filters
ids_search_fields_get

90

Prototype:
long i d s _ s e a r c h _ f i l t e r (
long
sockh ,
char search ,
char f i l t e r
);

/ / Long i n
/ / String in
/ / String in

Parameters:
sockh is the socket to use for the call
search is the name of the Search that will use the filter
filter is a string containing an SQL expression or values for substituion variables

Return Code:
negative for error, 0 for success

ids_search_finish
Description:
Release resources associated with ids_search_start.

Prototype:
long i d s _ s e a r c h _ f i n i s h (
long
sockh ,
char s e a r c h
);

/ / Long i n
/ / String in

Parameters:
sockh is the socket to use for the call
search is the name of the search that was performed

Return Code:
negative for error, 0 for success

ids_search_get
Description:
Retrieve file records that are a good match for the search record specified in the ids_search_start
or ids_system_search_start function.
91

CALLING FROM C

Prototype:
long i d s _ s e a r c h _ g e t (
long
sockh ,
//
char searchname ,
//
char s e a r c h r e t u r n ,
//
long
searchreturn_size ,
long s c o r e ,
//
long sreps ,
//
long
sreps_num ,
long f r e p s ,
//
long
freps_num
);

Long i n
String in
Block out
Long o u t
LongArray o u t
LongArray o u t

Parameters:
sockh is the socket to use for the call
searchname is the name the search to used by the call.
searchreturn is an area into which a string from the set is copied.
score is the score calculated for the string.
sreps is an array of the ordinal values of the repeating fields in the search record that were used in
the match.
Note: sreps and freps are only meaningful when using SSA-NAME3 v1, the SEQUENCES
option has been set in the Search-Definition, and the search and file records contain repeating
groups

freps is an array of the ordinal values of the repeating fields in the file record that were used in the
match.
For example, a record structure with a repeating name (2 fields) and a repeating address (2
fields) , if the first name field in the search record matched the second name field in the file
record while the first address field of the source matched the first address field of the file; the
contents of these two arrays would be; sreps[0] = 0, srep[1] = 0, freps[0] = 1, frep[1] = 0

Return Code:
negative for error, 0 for success, and 1 for "end of set".

ids_search_get_complete
Description:
Retrieve file records which are a good match for the search record specified in the ids_search_start
or ids_system_search_start function. This function will return extended matching information
in the info field as long as the Search-Definition specifies the SEQUENCES option, and SSA-NAME3
v1 is used.
ids_search_get_complete

92

Prototype:
long i d s _ s e a r c h _ g e t _ c o m p l e t e (
long
sockh ,
//
char search ,
//
char s e a r c h r e t u r n ,
//
long
searchreturn_size ,
long s c o r e ,
//
char i n f o ,
//
long
info_size
);

Long i n
String in
Block out
Long o u t
Block out

Parameters:
sockh is the socket to use for the call
search is the name of the search which was performed.
searchreturn is an area into which a string from the set is copied.
score is the score calculated for the string.
info an encoded list of values used to determine which occurrence of a repeating field matched the
value in the search record. The info field has a length of 4*(1+3*100) bytes. It contains 4 groups, each
one representing the result from one of the four possible scoring phases: Key-Pre-Score, Key-Score,
Pre-Score and Score respectively. If a phase was used, its data starts with a 1, otherwise 0 if the phase
was not used. The indicator is followed by 100 three-digit numbers, one each for each method in the
scoring-scheme for this phase, up to a limit of 100 methods per scheme (scoring phase). The three-digit
number is an index (base 1) representing the occurrence in the file record that was the best match for
the data in the search record.

Return Code:
negative for error, 0 for success, and 1 for "end of set".

ids_search_get_detail
Description:
Retrieve file records which are a good match for the search record specified in the ids_search_start
or ids_system_search_start function. This function will return extended matching information,
including the match decision and the file (IDT) record-ID of the matching records.

Prototype:
long i d s _ s e a r c h _ g e t _ d e t a i l (
long
sockh ,
char search ,
char f i l e _ r e c ,
long
file_rec_size ,
long s c o r e ,
char d e c i s i o n ,
long
decision_size ,
long f i l e _ r e c i d
);
93

CALLING FROM C

/ / Long i n
/ / String in
/ / Block out
/ / Long o u t
/ / String out
/ / Long o u t

Parameters:
sockh is the socket to use for the call
search is the name of the Search which was performed.
file_rec is the matched File record.
score is the degree of similarity between the Search and File records (0-100).
decision is the match decision: A(ccept) or U(ndecided)
file_recid is the File Record-ID (corresponding to the RECID column from the IDT).

Return Code:
negative for error, 0 for success, and 1 for "end of set".

ids_search_IDT_get
Description:
Gets the name of the IDT associated with the search.

Prototype:
long i d s _ s e a r c h _ I D T _ g e t (
long
sockh ,
char searchname ,
char IDT ,
long
IDT_size
);

/ / Long i n
/ / String in
/ / String out

Parameters:
sockh is the socket to use for the call
searchname is the name the search to used by the call.
IDT is the area into which the IDT name will be copied

Return Code:
negative for error, 0 for success

ids_search_layout
Description:
Get the names and descriptions of the fields in the current input or output view. If no view has been
defined, the IDT layout will be returned.
ids_search_IDT_get

94

Prototype:
long i d s _ s e a r c h _ l a y o u t (
long
sockh ,
char search ,
char viewType ,
char func ,
char names ,
long
names_num ,
long
names_size ,
long l e n g t h s ,
long
lengths_num ,
long o f f s e t s ,
long
offsets_num ,
long r e p e a t s ,
long
repeats_num ,
char formats ,
long
formats_num ,
long
formats_size
);

//
//
//
//
//

Long i n
String in
String in
String in
StringArray out

/ / LongArray o u t
/ / LongArray o u t
/ / LongArray o u t
/ / StringArray out

Parameters:
sockh is the socket to use for the call
search is the name of the Search which was performed.
viewType the type of view: input or output.
func describes the order of fields.
names is the area into which an array containing the fieldnames will be copied.
lengths is the area into which an array containing the lengths of the fields will be copied.
offsets is the area into which an array containing the offsets of the fields will be copied.
repeats is the area into which an array containing the number of repeats in a field will be copied.
formats is the area into which an array containing the format a field will be copied. The format of a
fields is a 50 character string in the following format:
Character 0:

Justification (Left or Right)

Character 1:

Compression (Fixed, Variable or Long)

Characters2 - 3:

Fill (2 characters containing the fill character in hexadecimal)

Character 4:

Fill type (Text or Binary)

Characters 5 - 6:

Base (2 characters containing the base in decimal)

Character 7:

Format (Text, Numeric, Variable or Binary)

Character 8 - 9:

Reserved

Characters 10 - 11:

Binary key number (2 hexadecimal digits)

Character 12:

Character width (Wide, Narrow)

Characters 13 - 50:

Reserved

Note: It is recommended that the FORMATS_SIZE constant be used to prevent errors from
undersized strings.

95

CALLING FROM C

Return Code:
negative for error, 0 for success

ids_search_start
Description:
Performs a search using a pre-constructed search-record (searchrec). Alternatively you can supply
fields (parameters) and have ids_search_start construct the record. The order of the field values
in parameters should be the same as that returned by ids_search_fields_get. You can either search the
database or search against a supplied list of records (records). There is a limit of 64K bytes of data that
can be sent to the Server. If the supplied list of records is too large, split it into smaller groups and make
multiple calls.
Note: The first search for a given System incurs an additional overhead to allocate database
resources and access the Rulebase. Switching between searches on a particular connection
is equivalent to starting a new search and therefore incurs some overhead. Applications requiring the best possible search performance should be designed to avoid switching between
searches. The easiest way to do this is to use separate (dedicated) connections for each Search.

Prototype:
long i d s _ s e a r c h _ s t a r t (
long
sockh ,
char search ,
char search_width ,
char m a t c h _ t o l e r a n c e
char parameters ,
long
parameters_num ,
long
parameters_size
char s e a r c h r e c ,
long
searchrec_size ,
char AnswersetName ,
long r e c s ,
char r ec o rd s ,
long
records_num ,
long
records_size
);

//
//
//
, //
//

Long i n
String in
String in
String in
BlockArray in

,
/ / Block io
/ / String in
/ / Long o u t
/ / BlockArray in

Parameters:
sockh is the socket to use for the call
search is the name of the search to be performed.
search_width specifies either Narrow, Typical or Exhaustive to nominate how many candidates should be selected. If left blank, the Search_Level in the Controls will be used.
match_tolerance specifies either Conservative, Typical or Loose to nominate how aggressive
the matching scheme should be in rejecting candidates. If left blank, the Match_Level in the Controls
will be used.
ids_search_start

96

parameters contains the field values used to construct a search record (searchrec). The order
of the field values must correspond to the order of fields returned by ids_search_fields_get. If
insufficient fields are supplied, the remaining fields in the constructed search record will be blank filled.
searchrec is the record that we will search on (in IDT format, or the input view if specified). If
searchrec is specified it will be used to search (provided no parameters are supplied). Alternatively if parameters are specified then the search will be on a record constructed on those parameters
and returned to the user.
AnswersetName is used store the search results in an AnswerSet. AnswersetName is used to identify
the Search results in the table. The maximum AnswersetName length is 32 characters. If you do not
wish to store the search results in an AnswerSet, set AnswersetName to an empty String.
recs number of records that matched the search criteria. The count reflects the number of records
prior to sorting the result set. If the sort uses the Unique_Keys option to remove duplicates, the
resulting set may contain less than recs records. In this case, you must use the response code from
ids_search_get to determine when the end of set has been reached.
records contains a list of records to search on. If you wish to search on the database then specify this
as containing 0 records.

Return Code:
negative for error, 0 for success, and 1 for truncation of the search set, and 2 for exceeding
SEARCH_LIMIT

ids_search_tolerances_count
Description:
Returns the match tolerances count that have for the search. The match tolerance defines how aggressively the matching scheme should be in rejecting candidates.

Prototype:
long i d s _ s e a r c h _ t o l e r a n c e s _ c o u n t
long
sockh ,
char searchname ,
long count
);

(
/ / Long i n
/ / String in
/ / Long o u t

Parameters:
sockh is the socket to use for the call
searchname is the name the search to used by the call.
count is the number of widths for the search by the call.

Return Code:
negative for error, 0 for success
97

CALLING FROM C

ids_search_tolerances_get
Description:
Returns the match tolerances that have been defined for the search. The match tolerance defines how
aggressively the matching scheme should be in rejecting candidates.

Prototype:
long i d s _ s e a r c h _ t o l e r a n c e s _ g e t (
long
sockh ,
/ / Long i n
char searchname ,
/ / String in
char t o l e r a n c e s ,
/ / StringArray out
long
tolerances_num ,
long
tolerances_size
);

Parameters:
sockh is the socket to use for the call
searchname the search to count.
tolerances is the list of null terminated strings returned by the call.

Return Code:
negative for error, 0 for success

ids_search_view_get
Description:
Returns the name of the current input or output view, together with information about the
view: view_field_count is needed to dynamically allocate the arrays used for calls to
ids_search_layout and view_length is used to dynamically allocate memory for input/output
records.

Prototype:
long i d s _ s e a r c h _ v i e w _ g e t (
long
sockh ,
//
char search ,
//
char viewType ,
//
char viewName ,
//
long
viewName_size ,
long viewFieldCount , / /
long viewRecLen
//
);

Long i n
String in
String in
String out
Long o u t
Long o u t

Parameters:
sockh is the socket to use for the call
ids_search_tolerances_get

98

search is the name of the Search


viewType the type of the view (input or output)
viewName is the name of the view to query
viewFieldCount the number of fields in the view
viewRecLen is the length of the view

Return Code:
negative for error, 0 for success

ids_search_view_set
Description:
Sets a view as the active input or output view

Prototype:
long i d s _ s e a r c h _ v i e w _ s e t (
long
sockh ,
char search ,
char viewType ,
char viewName
);

//
//
//
//

Long i n
String in
String in
String in

Parameters:
sockh is the socket to use for the call
search is the name of the Search
viewType the type of the view (input or output)
viewName the name of the view to use

Return Code:
negative for error, 0 for success

ids_search_widths_count
Description:
Returns the count of search widths that have been defined for the search. The search width defines how
many items are selected by the search
99

CALLING FROM C

Prototype:
long i d s _ s e a r c h _ w i d t h s _ c o u n t (
long
sockh ,
char searchname ,
long count
);

/ / Long i n
/ / String in
/ / Long o u t

Parameters:
sockh is the socket to use for the call
searchname is the name the search to used by the call.
count is the number of widths for the search by the call.

Return Code:
negative for error, 0 for success

ids_search_widths_get
Description:
Returns the search widths that have been defined for the search. The search width defines how many
items are selected by the search

Prototype:
long i d s _ s e a r c h _ w i d t h s _ g e t (
long
sockh ,
char searchname ,
char widths ,
long
widths_num ,
long
widths_size
);

/ / Long i n
/ / String in
/ / StringArray out

Parameters:
sockh is the socket to use for the call
searchname is the name the search to used by the call.
widths is the list of null terminated strings returned by the call.

Return Code:
negative for error, 0 for success

ids_server_version_get
Description:
Get the version information associated with the server.
ids_search_widths_get

100

Prototype:
long i d s _ s e r v e r _ v e r s i o n _ g e t (
long
sockh ,
/ / Long i n
char s e r v e r _ v e r s i o n , / / S t r i n g o u t
long
server_version_size
);

Parameters:
sockh is the socket to use for the call
server_version is the area into which the string containing the version information will be copied.

Return Code:
negative for error, 0 for success

ids_session_close
Description:
Closes the session currently allocated. This will cause the databases kept open by the connection server
to close and prevent the reuse of the session by subsequent calls by ids_session_open.

Prototype:
long i d s _ s e s s i o n _ c l o s e (
long
sockh
);

/ / Long i n

Parameters:
sockh is the socket to use for the call

Return Code:
negative for error, 0 for success

ids_session_open
Description:
Allocates resources for a socket. This is an API to the IDS Connection Server. The IDS Connection
Server sits between the client and the IDS Search Server. A session prevents the IDS Search Server
from reopening databases by keeping the databases open between connections. A timeout value can be
specified when starting the IDS Connection Server. If the session has not been reused or closed before
the timeout period it will be closed automatically.
101

CALLING FROM C

Prototype:
long i d s _ s e s s i o n _ o p e n (
long
sockh ,
long s e s s i o n
);

/ / Long i n
/ / Long i o

Parameters:
sockh is the socket to use for the call
session is the number of the session to open (-1 for a new session).

Return Code:
negative for error, 0 for success

ids_set_encoding
Description:
Informs the Search Server of the encoding used for fields of type W (UNICODE data). ISS stores and
retrieves W fields using an UTF-16 encoding. Search records should use this encoding for W columns
if possible. If they do not, the caller must use this API to inform the Search Server of the alternate
encoding used so that the Server can convert the data prior to using it. The W fields in each record of
the result set will be converted (if necessary) to the callers encoding prior to return. If no encoding is
specified, ISS assumes that the search data matches the file data and no conversion is performed. Refer
to the Globalization section of the O PERATIONS manual for further details and restrictions.

Prototype:
long i d s _ s e t _ e n c o d i n g (
long
sockh ,
long
encoding
);

/ / Long i n
/ / Long i n

Parameters:
sockh is the socket to use for the call
encoding 6=UTF-16/UCS-2 (LE), 7=UTF-16/UCS-2 (BE), 8=UTF-8, 4=UCS-4

Return Code:
negative for error, 0 for success

ids_set_vpd_user
Description:
Provides the Search Server with information required to set a Virtual Private Database context. Refer
to the D ESIGNER M ANUAL, VPD section for details about VPD.
ids_set_encoding

102

Prototype:
long i d s _ s e t _ v p d _ u s e r (
long
sockh ,
char vpd_user ,
char vpd_ctx
);

/ / Long i n
/ / String in
/ / String in

Parameters:
sockh is the socket to use for the call
vpd_user Connection string of the actual user
vpd_ctx the name of the PL/SQL context setting package

Return Code:
negative for error, 0 for success

ids_system_close
Description:
closes the system and frees any remaining resources.

Prototype:
long i d s _ s y s t e m _ c l o s e (
long
sockh
);

/ / Long i n

Parameters:
sockh is the socket to use for the call

Return Code:
negative for error, 0 for success

ids_system_idtname_count
Description:
Returns the number of active idt names. (i.e. those whose IDT has been loaded).
103

CALLING FROM C

Prototype:
long ids_system_idtname_count (
long
sockh ,
/ / Long i n
long i d t c o u n t
/ / Long o u t
);

Parameters:
sockh is the socket to use for the call
idtcount is the number of idtnames defined on the system

Return Code:
negative for error, 0 for success

ids_system_idtname_get
Description:
Get the names of all IDTs that are active. (i.e. those whose IDT has been loaded).

Prototype:
long ids_system_idtname_get (
long
sockh ,
char idtnames ,
long
idtnames_num ,
long
idtnames_size
);

/ / Long i n
/ / StringArray out

Parameters:
sockh is the socket to use for the call
idtnames is the area into which an array of the idtnames defined on the rulebase will be copied (the
idtnames are all null terminated strings).

Return Code:
negative for error, 0 for success

ids_system_notify
Description:
Notifies search server on a system.
ids_system_idtname_get

104

Prototype:
long i d s _ s y s t e m _ n o t i f y (
long
sockh ,
char r u l e b a s e ,
char sysname ,
char message
);

//
//
//
//

Long i n
String in
String in
String in

//
//
//
//
//

Long i n
String in
String in
String in
String in

Parameters:
sockh is the socket to use for the call
rulebase is the name of the rulebase.
sysname is the name of the system
message is a messagevto be delivered

Return Code:
negative for error, 0 for success

ids_system_open
Description:
opens a system.

Prototype:
long ids_system_open (
long
sockh ,
char r u l e b a s e ,
char system ,
char v e r b o s i t y ,
char Options
);

Parameters:
sockh is the socket to use for the call
rulebase is the name of the rulebase.
system The name of the system in the rulebase
verbosity specifies the verbosity level. See the Verbosity section for details.
Options

LOGOUT filename for server output for this session.

LOGERR filename for server errors for this session.


LOGTEST filename for server search trace for this session.
SHOWALLSEARCHES modifies the behavior of
WORKDIR used to inform the search server as to which directory is to be used as the working directory for this session.
105

CALLING FROM C

Return Code:
negative for error, 0 for success

ids_system_pid_searches_count
Description:
Gets the number of persistent ID based multi-searches defined on a system.

Prototype:
long i d s _ s y s t e m _ p i d _ s e a r c h e s _ c o u n t (
long
sockh ,
/ / Long i n
long s e a r c h c o u n t
/ / Long o u t
);

Parameters:
sockh is the socket to use for the call
searchcount is the number of persistent ID based multi-searches defined on a system

Return Code:
negative for error, 0 for success

ids_system_pid_searches_get
Description:
Get the names of all persistent ID based multi-searches defined in the system

Prototype:
long i d s _ s y s t e m _ p i d _ s e a r c h e s _ g e t (
long
sockh ,
//
char s e a r c h e s ,
//
long
searches_num ,
long
searches_size ,
char p i d _ p r e f i x ,
//
long
pid_prefix_num ,
long
pid_prefix_size ,
long pid_opts ,
//
long
pid_opts_num ,
long p r e f _ r e c _ o p t s ,
//
long
pref_rec_opts_num
);

Long i n
StringArray out

BlockArray out

LongArray o u t
LongArray o u t

Parameters:
sockh is the socket to use for the call
ids_system_pid_searches_count

106

searches is the area into which an array of the persistent ID based multi-searches defined on the
rulebase will be copied (the searches are all null terminated strings).
pid_prefix the area in which the Persistent ID prefix for the searches will be copied
pid_opts the area into which an array containing the Persistent_ID options for each search will be
copied
pref_rec_opts the area into which an array containing the options for the preferred record generation for each search will be copied

Return Code:
negative for error, 0 for success

ids_system_search_finish
Description:
Finishes the search and closes the system.

Prototype:
long i d s _ s y s t e m _ s e a r c h _ f i n i s h (
long
sockh
/ / Long i n
);

Parameters:
sockh is the socket to use for the call

Return Code:
negative for error, 0 for success

ids_system_search_start
Description:
Opens a system and constructs and initialises a search using the fields passed to it in parameters. Refer
to ids_search_start for a more detailed description of the parameters.

Prototype:
long i d s _ s y s t e m _ s e a r c h _ s t a r t (
long
sockh ,
char r u l e b a s e ,
char system ,
char v e r b o s i t y ,
107

CALLING FROM C

//
//
//
//

Long i n
String in
String in
String in

char
char
char
long
long
char
long
long

options ,
search ,
parameters ,
parameters_num ,
parameters_size
AnswersetName ,
datalen ,
recs

/ / String in
/ / String in
/ / BlockArray in
,
/ / String in
/ / Long o u t
/ / Long o u t

);

Parameters:
sockh is the socket to use for the call
rulebase is the name of the rulebase.
system The name of the system in the rulebase
verbosity specifies the verbosity level. See the Verbosity section for details.
options consists of one or more keywords and their respective values in the form
KEYWORD1=VALUE1,KEYWORD2=VALUE2,
search is the name of the search in the system in the Rulebase that will be used.
parameters is the array which contains the field values to be used to construct the search.
AnswersetName is used store the search results in an AnswerSet. AnswersetName is used to identify
the Search results in the table. The maximum AnswersetName length is 32 characters. If you do not
wish to store the search results in an AnswerSet, set AnswersetName to an empty String.
datalen will return the length of a record.
recs count of records that matched the search criteria

Return Code:
negative for error, 0 for success

ids_system_searches_count
Description:
Returns the number of runnable searches. (i.e. those whose IDX has been loaded). To return the number
of defined searches, add the SHOWALLSEARCHES keyword to the option string of ids_system_open.

Prototype:
long i d s _ s y s t e m _ s e a r c h e s _ c o u n t (
long
sockh ,
/ / Long i n
long s e a r c h c o u n t
/ / Long o u t
);

Parameters:
sockh is the socket to use for the call
searchcount is the number of searches defined on the system
ids_system_searches_count

108

Return Code:
negative for error, 0 for success

ids_system_searches_get
Description:
Get the names of all searches that are runnable. (i.e. those whose IDX has been loaded). To return the names of all defined searches, add the SHOWALLSEARCHES keyword to the option string of
ids_system_open.

Prototype:
long i d s _ s y s t e m _ s e a r c h e s _ g e t (
long
sockh ,
char s e a r c h e s ,
long
searches_num ,
long
searches_size
);

/ / Long i n
/ / StringArray out

Parameters:
sockh is the socket to use for the call
searches is the area into which an array of the searches defined on the rulebase will be copied (the
searches are all null terminated strings).

Return Code:
negative for error, 0 for success

ids_systems_count
Description:
the number of systems in the rulebase.

Prototype:
long i d s _ s y s t e m s _ c o u n t (
long
sockh ,
char r u l e b a s e ,
long systemscount
);

/ / Long i n
/ / String in
/ / Long o u t

Parameters:
sockh is the socket to use for the call
rulebase is the name of the rulebase.
systemscount the number of systems in the rulebase.
109

CALLING FROM C

Return Code:
negative for error, 0 for success

ids_systems_get
Description:
Get the names of all the systems defined in the rulebase.

Prototype:
long i d s _ s y s t e m s _ g e t (
long
sockh ,
char r u l e b a s e ,
char systems ,
long
systems_num ,
long
systems_size
);

/ / Long i n
/ / String in
/ / StringArray out

Parameters:
sockh is the socket to use for the call
rulebase is the name of the rulebase.
systems is the area into which an array of the systems defined in the rulebase will be copied (the
systems are all null terminated strings).

Return Code:
negative for error, 0 for success

ids_systems_get

110

Calling from C without Arrays


If the language does not support C-style arrays an alternative API is available. This API requires only
the long, long * and char * data-types.
For Win32, the C API functions are provided by the import library %SSALIB%\stssasea.lib for
dynamic linking.
For Unix, the C API functions are provided in $SSABIN (libssasea.so and libssaiok.so).
The functions are prototyped in %SSAINC%\ssaseca.h.
The functions return a response code. A negative response code indicates a transport error, after which
the communication channel is closed and no further API calls can be made without reconnecting.

Constants
Constants are declared as #defines, in uppercase using underscores. Constants are prefixed with SSA_,
eg. SSA_MSG_SIZE.

Parameter types
Note: values in BOLD represent information that must be provided to the function.

ids_addr_get_cass_field
Description:
Use this function to retrieve a validated CASS field. The suggestion_idx specifies the suggestion
from which to select the field value. (1..n for validated data, where n is the n_suggest parameter
returned by ids_addr_validate).

Prototype:
long i d s _ a d d r _ g e t _ c a s s _ f i e l d (
long sockh ,
long
suggest_idx ,
/ / Long i n
long
field_idx ,
/ / Long i n
char f i e l d _ v a l u e ,
/ / Block out
long
field_value_size
);

Parameters:
suggest_idx Specifies the nth suggestion from which to get a cass field
field_idx Specifies a cass field within the nth suggestion
field_value The cass field value
111

CALLING FROM C WITHOUT ARRAYS

Return Code:
negative for error, 0 for success

ids_addr_get_cass_field_cnt
Description:
This function returns the maximum number of CASS address fields created as a result of a parse or validate call. Use this value to dynamically allocate the field_length array for the ids_addr_parse
API.

Prototype:
long i d s _ a d d r _ g e t _ c a s s _ f i e l d _ c n t (
long sockh ,
long count
/ / Long o u t
);

Parameters:
count Returns the max number of cass address fields

Return Code:
negative for error, 0 for success

ids_addr_get_cass_field_info
Description:
This function returns the maximum length of an input address line. It may be used to dynamically
allocate the input lines used for the ids_addr_set_lines API.

Prototype:
long i d s _ a d d r _ g e t _ c a s s _ f i e l d _ i n f o (
long sockh ,
long
suggest_idx ,
/ / Long i n
long f i e l d _ l e n g t h ,
/ / LongArray o u t
long
f ie l d_ l en gt h _n u m
);

Parameters:
suggest_idx Specifies the suggestion from which to retrieve information
field_length An array containing the length of each cass address field
ids_addr_get_cass_field_cnt

112

Return Code:
negative for error, 0 for success

ids_addr_get_del_lines_ext
Description:
Use this function to retrieve delivery address line information

Prototype:
long i d s _ a d d r _ g e t _ d e l _ l i n e s _ e x t
long sockh ,
long
suggest_idx ,
long
del_case ,
char d e l _ l i n e 1 ,
long
del_line1_size ,
char d e l _ l i n e 2 ,
long
del_line2_size ,
char d e l _ l i n e 3 ,
long
del_line3_size ,
char d e l _ l i n e 4 ,
long
del_line4_size ,
char d e l _ l i n e 5 ,
long
del_line5_size ,
char d e l _ l i n e 6 ,
long
del_line6_size
);

(
/ / Long i n
/ / Long i n
/ / Block out
/ / Block out
/ / Block out
/ / Block out
/ / Block out
/ / Block out

Parameters:
suggest_idx Specifies the suggestion from which to get delivery address lines
del_case Specifies delivery address line case option value. The allowed values are 0 = Unchanged, 1
= Upper case, 2 = Lower case and 3 = Mixed case.
del_line1 delivery address line 1 output string
del_line2 delivery address line 2 output string
del_line3 delivery address line 3 output string
del_line4 delivery address line 4 output string
del_line5 delivery address line 5 output string
del_line6 delivery address line 6 output string

Return Code:
negative for error, 0 for success
113

CALLING FROM C WITHOUT ARRAYS

ids_addr_get_field
Description:
Use this function to retrieve a validated field. The suggestion_idx specifies the suggestion from
which to select the field value. (1..n for validated data, where n is the n_suggest parameter returned
by ids_addr_validate). val_status and val_mods return a code that describes how the field
matched to validation data and whether or not it was modified by validation. Refer to the Address
Validation section of this manual for a list of codes.

Prototype:
long i d s _ a d d r _ g e t _ f i e l d (
long sockh ,
long
suggest_idx ,
long
field_idx ,
char f i e l d _ v a l u e ,
long
field_value_size
long f i e l d _ v a l _ s t a t u s
long f i e l d _ v a l _ m o d s
);

/ / Long i n
/ / Long i n
/ / Block out
,
, / / Long o u t
/ / Long o u t

Parameters:
suggest_idx Specifies the nth suggestion from which to get a field
field_idx Specifies a field within the nth suggestion
field_value The field value
field_val_status Specifies how this field matched the validation data
field_val_mods Specifies how this field was modified by validation data

Return Code:
negative for error, 0 for success

ids_addr_get_field_count
Description:
This function returns the maximum number of address fields created as a result of a parse or validate
call. Use this value to dynamically allocate the field_length array for the ids_addr_parse API.

Prototype:
long i d s _ a d d r _ g e t _ f i e l d _ c o u n t (
long sockh ,
long count
/ / Long o u t
);

Parameters:
count Returns the max number of address fields
ids_addr_get_field

114

Return Code:
negative for error, 0 for success

ids_addr_get_field_ext
Description:
Use this function to retrieve all getter fields

Prototype:
long i d s _ a d d r _ g e t _ f i e l d _ e x t (
long sockh ,
long
suggest_idx ,
long
field_operation ,
char field_name ,
long
field_item_line ,
char f i e l d _ t y p e ,
char f i e l d _ v a l u e ,
long
field_value_size
);

//
//
//
//
//
//

Long i n
Long i n
String in
Long i n
String in
Block out

Parameters:
suggest_idx Specifies the suggestion from which to get fields
field_operation Field operation Option 0 for AddressElements Option 1 for AddressLines Option
2 for AddressComplete Option 3 for EnrichmentData Option 4 for ResultDataParameter Option 5 for
EnrichmentDataStatus
field_name Refer AD Result.dtd for field names
field_item_line Represent field line number or field item number
field_type Refer AD Result.dtd for field attribute Type
field_value Cleansed field output

Return Code:
negative for error, 0 for success

ids_addr_get_field_idx
Description:
Use this function to retrieve a parsed or validated field. The suggestion_idx specifies the suggestion from which to select the field value. (0 for parsed data, 1..n for validated data, where n is the
n_suggest parameter returned by ids_addr_validate).
115

CALLING FROM C WITHOUT ARRAYS

Prototype:
long i d s _ a d d r _ g e t _ f i e l d _ i d x (
long sockh ,
long
suggest_idx ,
/ / Long i n
long
field_idx ,
/ / Long i n
char f i e l d _ v a l u e ,
/ / Block out
long
field_value_size
);

Parameters:
suggest_idx Specifies the nth suggestion from which to get a field. On successful parse, use 0 for
ASM/AD version 4, 1 for ASM/AD version 5
field_idx Specifies a field within the nth suggestion
field_value The field value

Return Code:
negative for error, 0 for success

ids_addr_get_field_info_ext
Description:
Use this function to retrieve a list of individual field lengths after validating an address. Fields with a
length of zero have no value associated with them and can be omitted from the list of fields retrieved
with ids_addr_get_field_idx

Prototype:
long i d s _ a d d r _ g e t _ f i e l d _ i n f o _ e x t (
long sockh ,
long
suggest_idx ,
/ / Long i n
long f i e l d _ l e n g t h ,
/ / LongArray o u t
long
field_length_num ,
char addr_label_encoded , / / B l o c k o u t
long
addr_label_encoded_size ,
char a d d r _ l a b e l _ c h a r s e t , / / S t r i n g o u t
long
addr_label_charset_size ,
long s c o r e
/ / Long o u t
);

Parameters:
suggest_idx Specifies the suggestion from which to retrieve information
field_length An array containing the length of each address field
addr_label_encoded The returned label
addr_label_charset The character set used in the address label
score The returned labels score
ids_addr_get_field_info_ext

116

Return Code:
negative for error, 0 for success

ids_addr_get_field_len
Description:
This function returns the maximum length of an individual address field. It may be used to dynamically
allocate the field parameter used for the ids_addr_get_field_idx API.

Prototype:
long i d s _ a d d r _ g e t _ f i e l d _ l e n (
long sockh ,
long max_len
);

/ / Long o u t

Parameters:
max_len Returns the max address field length in bytes

Return Code:
negative for error, 0 for success

ids_addr_get_line_len
Description:
This function returns the maximum length of an input address line. It may be used to dynamically
allocate the input lines used for the ids_addr_set_lines API.

Prototype:
long i d s _ a d d r _ g e t _ l i n e _ l e n (
long sockh ,
long max_len
);

/ / Long o u t

Parameters:
max_len Returns the max line length in bytes

Return Code:
negative for error, 0 for success
117

CALLING FROM C WITHOUT ARRAYS

ids_addr_get_option
Description:
Use this function to obtain values of options that control Address Standardization behavior. A list of
options appears in the Address Standardization section of this manual.

Prototype:
long i d s _ a d d r _ g e t _ o p t i o n (
long sockh ,
char param ,
char value ,
long
value_size
);

/ / String in
/ / String out

Parameters:
param This field specifies the name of the option to get.
value Returns the value of the option.

Return Code:
negative for error, 0 for success

ids_addr_info
Description:
Use this function to request additional information about an input address. This call must always be
preceded with a call to ids_addr_std.

Prototype:
long i d s _ a d d r _ i n f o (
long sockh ,
char c o n t r o l s ,
char value ,
long
value_size
);

/ / String in
/ / String out

Parameters:
controls this field contains the request information. It must me specified in the form ITEM=[value].
value this field contains the requested information.

Return Code:
negative for error, 0 for success
ids_addr_get_option

118

ids_addr_init
Description:
This function initializes the Address Standardization sub-system. It must be the first call to
ids_addr_* family of functions. The max_memory parameter specifies the maximum amount of
memory (MB) to be used by the Address Standardization engine (within the Search Server process).

Prototype:
long i d s _ a d d r _ i n i t (
long sockh ,
long
max_memory
);

/ / Long i n

Parameters:
max_memory This field specifies the maximum amount of memory (MB) to be used by the Address
Standardization engine.

Return Code:
negative for error, 0 for success

ids_addr_parse
Description:
Use this function to parse an address. The individual field lengths after parsing an address are returned
in the field_length array. Fields with a length of zero have no value associated with them and can be
omitted from the list of fields retrieved with ids_addr_get_field_idx

Prototype:
long i d s _ a d d r _ p a r s e (
long sockh ,
long f i e l d _ l e n g t h ,
/ / LongArray o u t
long
f ie l d_ l en gt h _n u m
);

Parameters:
field_length An array containing the length of each parsed field

Return Code:
negative for error, 0 for success
119

CALLING FROM C WITHOUT ARRAYS

ids_addr_preload_country
Description:
Use this function to preload country database

Prototype:
long i d s _ a d d r _ p r e l o a d _ c o u n t r y (
long sockh ,
char preload_type ,
/ / String in
char preload_country , / / S t r i n g i n
char val_mode
/ / String in
);

Parameters:
preload_type Type of preload to perform
preload_country Country database to be preloaded
val_mode Validation mode to be used

Return Code:
negative for error, 0 for success

ids_addr_set_attrib
Description:
Use this function to specify the character set of the data (for both input and output). The default_country parameter specifies that default country to use when parsing cannot identify a country
from the address. This API must be called prior to parsing or validating an address. The values stay in
effect for the life of the session, or until they are changed.

Prototype:
long i d s _ a d d r _ s e t _ a t t r i b (
long sockh ,
char c h a r _ s e t ,
/ / String in
char d e f a u l t _ c o u n t r y / / S t r i n g i n
);

Parameters:
char_set The name of the character set used to encode the input and output.
default_country The default country used for validation when parsing cannot detect a country
name.
ids_addr_preload_country

120

Return Code:
negative for error, 0 for success

ids_addr_set_del_lines
Description:
Use this function to set delivery address line information

Prototype:
long i d s _ a d d r _ s e t _ d e l _ l i n e s (
long sockh ,
char d e l _ l i n e 1 ,
long
del_line1_size
char d e l _ l i n e 2 ,
long
del_line2_size
char d e l _ l i n e 3 ,
long
del_line3_size
char d e l _ l i n e 4 ,
long
del_line4_size
char d e l _ l i n e 5 ,
long
del_line5_size
char d e l _ l i n e 6 ,
long
del_line6_size
);

/ / Block in
,
/ / Block in
,
/ / Block in
,
/ / Block in
,
/ / Block in
,
/ / Block in

Parameters:
del_line1 delivery address line 1 input string
del_line2 delivery address line 2 input string
del_line3 delivery address line 3 input string
del_line4 delivery address line 4 input string
del_line5 delivery address line 5 input string
del_line6 delivery address line 6 input string

Return Code:
negative for error, 0 for success

ids_addr_set_field_case
Description:
Use this function to set individual input fields case option
121

CALLING FROM C WITHOUT ARRAYS

Prototype:
long i d s _ a d d r _ s e t _ f i e l d _ c a s e (
long sockh ,
long
field_idx ,
long
field_case
);

/ / Long i n
/ / Long i n

Parameters:
field_idx Specifies the nth field to set
field_case Specifies output field case option value. The allowed values are 0 = Unchanged, 1 =
Upper case, 2 = Lower case and 3 = Mixed case.

Return Code:
negative for error, 0 for success

ids_addr_set_field_ext
Description:
Use this function to set fields

Prototype:
long i d s _ a d d r _ s e t _ f i e l d _ e x t (
long sockh ,
long
field_operation ,
char field_name ,
long
field_item_line ,
char f i e l d _ t y p e ,
char f i e l d _ v a l u e ,
long
field_value_size
);

//
//
//
//
//

Long i n
String in
Long i n
String in
Block in

Parameters:
field_operation Field operation Option 0 for AddressElements Option 1 for AddressLines
field_name Refer AD Result.dtd for field names
field_item_line Represent field line number or field item number
field_type Refer AD Result.dtd for field attribute Type
field_value input field value

Return Code:
negative for error, 0 for success
ids_addr_set_field_ext

122

ids_addr_set_field_idx
Description:
Use this function to specify the value of an input field. This API is used to specify an input address that
has already been pre-parsed into separate fields.

Prototype:
long i d s _ a d d r _ s e t _ f i e l d _ i d x (
long sockh ,
long
field_idx ,
/ / Long i n
char f i e l d _ v a l u e ,
/ / Block in
long
field_value_size
);

Parameters:
field_idx Specifies the nth field to set
field_value Specifies a value for the nth field

Return Code:
negative for error, 0 for success

ids_addr_set_field_name
Description:
Use this function to set individual input fields by name

Prototype:
long i d s _ a d d r _ s e t _ f i e l d _ n a m e (
long sockh ,
char field_name ,
/ / String in
char f i e l d _ v a l u e ,
/ / Block in
long
field_value_size
);

Parameters:
field_name Specifies the name of the field to set
field_value Specifies a value for the field

Return Code:
negative for error, 0 for success
123

CALLING FROM C WITHOUT ARRAYS

ids_addr_set_lines
Description:
Use this function to specify the value of an input field. This API is used to specify an input address that
has already been pre-parsed into separate fields.

Prototype:
long i d s _ a d d r _ s e t _ l i n e s (
long sockh ,
char l i n e _ 1 ,
long
line_1_size ,
char l i n e _ 2 ,
long
line_2_size ,
char l i n e _ 3 ,
long
line_3_size ,
char l i n e _ 4 ,
long
line_4_size ,
char l i n e _ 5 ,
long
line_5_size ,
char l i n e _ 6 ,
long
line_6_size ,
char l i n e _ 7 ,
long
line_7_size ,
char l i n e _ 8 ,
long
line_8_size ,
char l i n e _ 9 ,
long
line_9_size ,
char l i n e _ 1 0 ,
long
line_10_size
);

/ / Block in
/ / Block in
/ / Block in
/ / Block in
/ / Block in
/ / Block in
/ / Block in
/ / Block in
/ / Block in
/ / Block in

Parameters:
line_1 The first line of the address
line_2 The second line of the address
line_3 The third line of the address
line_4 The fourth line of the address
line_5 The fifth line of the address
line_6 The sixth line of the address
line_7 The seventh line of the address
line_8 The eighth line of the address
line_9 The ninth line of the address
line_10 The tenth line of the address

Return Code:
negative for error, 0 for success
ids_addr_set_lines

124

ids_addr_set_option
Description:
Use this function to set values of options that control Address Standardization behavior. A list of
options appears in the Address Standardization section of this manual.

Prototype:
long i d s _ a d d r _ s e t _ o p t i o n (
long sockh ,
char param ,
char value
);

/ / String in
/ / String in

Parameters:
param This field specifies the name of the option to set.
value This field specifies a value for the option.

Return Code:
negative for error, 0 for success

ids_addr_std
Description:
Use this function to request IDS to standardize an address by validating it against USPS validation
tables and formatting it to comply with U.S. Postal Addressing Standards. This API requires the separately licensable IDS Address Standardization Module to be installed.

Prototype:
long i d s _ a d d r _ s t d (
long sockh ,
char firm_name ,
//
long
firm_name_size ,
char u r b a n i z a t i o n ,
//
long
urbanization_size ,
char address_one ,
//
long
address_one_size ,
char address_two ,
//
long
address_two_size ,
char l a s t _ l i n e ,
//
long
last_line_size
);

String io
String io
String io
String io
String io

Parameters:
firm_name It contains the name of the firm (may be blank).
125

CALLING FROM C WITHOUT ARRAYS

urbanization this field can contain name of an urban development within a geographic area. It is
only used with Puerto Rican addresses.
address_one this field contains the Delivery Address Line. It normally consists of a street number,
pre-directional, street name, street suffix, post-directional and possibly some secondary address components such as apartment number.
address_two this field contains additional Delivery Address Line components. It is normally only
used when address_one is very long.
last_line this field contains the Last Line information: the city name, state abbreviation and zip
code (and possibly the Zip + 4 code).

Return Code:
0 indicates an exact match to a valid address
1 indicates a no match (invalid address)
2 indicates a multi match (non-unique address), and
< 0 indicates an error

ids_addr_validate
Description:
Use this function to validate an address

Prototype:
long i d s _ a d d r _ v a l i d a t e (
long sockh ,
long s t a t u s ,
long n_suggest
);

/ / Long o u t
/ / Long o u t

Parameters:
status The status returned by the validation process
n_suggest The number of suggestions generated by validation

Return Code:
negative for error, 0 for success

ids_connect
Description:
Initiates a socket.
ids_addr_validate

126

Prototype:
long i d s _ c o n n e c t (
char host ,
long
port ,
long sockh
);

/ / String in
/ / Long i n
/ / Long o u t

Parameters:
host is the host to connect to.
port is the port to connect to.
sockh is a socket handle.

Return Code:
negative for error, 0 for success

ids_disconnect
Description:
Releases resources allocated to a socket.

Prototype:
long i d s _ d i s c o n n e c t (
long sockh ,
);

Parameters:
none

Return Code:
negative for error, 0 for success

ids_error_get
Description:
Get the error messages from the last API function that failed. This function should be called repeatedly
until it returns 1, meaning all messages have been retrieved.
Note: if a communication (socket) error occurred, this function will also fail. Refer to the
O PERATIONS M ANUAL, Error Log section for help in interpreting the Error Log.

127

CALLING FROM C WITHOUT ARRAYS

Prototype:
long i d s _ e r r o r _ g e t (
long sockh ,
char msg ,
long
msg_size
);

/ / String out

Parameters:
msg is the error message returned

Return Code:
0 for success, -ve for error and 1 for no more errors to retrieve.

ids_errors_get_all
Description:
Get the Server side error messages from the last API function that failed. This function should be called
repeatedly until it returns 1, meaning all messages have been retrieved.
Note: if a communication (socket) error occurred, this function will also fail. Refer to the
O PERATIONS M ANUAL, Error Log section for information on interpreting the Error Log.

Prototype:
long i d s _ e r r o r s _ g e t _ a l l (
long sockh ,
char msg ,
long
msg_size
);

/ / String out

Parameters:
msg is an error message.

Return Code:
negative for error, 0 for success

ids_identify
Description:
Identify a session to the console
ids_errors_get_all

128

Prototype:
long i d s _ i d e n t i f y (
long sockh ,
char i d e n t i f i c a t i o n
);

/ / String in

Parameters:
identification is user supplied identitification for display on the console

Return Code:
negative for error, 0 for success

ids_is_little_endian
Description:
Checks if the search server is running on a little endian platform

Prototype:
long i d s _ i s _ l i t t l e _ e n d i a n (
long sockh ,
long e n d i a n _ s t a t e
);

/ / Long o u t

Parameters:
endian_state Returns 1 if the search server is running on a little endian platform. Returns 0 for
others

Return Code:
negative for error, 0 for success

ids_match_explain
Description:
Explains the match result given search and file records As match_explain_count does not give the exact
number of output rows for this call, but instead provides a maximal estimate, some of the info blocks
returned will be filled with NULL bytes. Test a block for validity by checking the first byte is not NULL.
Info blocks returned are not all the same length either. They are NULL filled on the right.
129

CALLING FROM C WITHOUT ARRAYS

Prototype:
long i d s _ m a t c h _ e x p l a i n (
long sockh ,
char search ,
char m a t c h _ t o l e r a n c e
char s e a r c h r e c ,
long
searchrec_size ,
char f i l e r e c ,
long
filerec_size ,
char i n f o _ a r r a y ,
long
info_array_num ,
long
info_array_size
);

/ / String in
, / / String in
/ / Block in
/ / Block in
/ / BlockArray out

Parameters:
search is the name of the Search which was performed.
match_tolerance specifies either Conservative, Typical or Loose to nominate how aggressive
the matching scheme should be in rejecting candidates.
searchrec is the IDT record used to search with. It is returned by the Search Server.
filerec is the record to be matched agains the searchrec
info_array An array describing the match results. See the Match Explain API section for details

Return Code:
negative for error, 0 for success

ids_match_explain_count
Description:
Estimate number of info blocks required for a subsequent match_explain call

Prototype:
long i d s _ m a t c h _ e x p l a i n _ c o u n t (
long sockh ,
char search ,
long count
);

/ / String in
/ / Long o u t

Parameters:
search is the name of the Search which was performed.
count Returns the maximum number of info blocks required to explain the search results

Return Code:
negative for error, 0 for success
ids_match_explain_count

130

ids_pid_close
Description:
Closes resources opened with the ids_pid_open call.

Prototype:
long i d s _ p i d _ c l o s e (
long sockh ,
);

Parameters:
none

Return Code:
negative for error, 0 for success

ids_pid_member_count
Description:
Retrieve the number of member records in a cluster

Prototype:
long ids_pid_member_count (
long sockh ,
char p r e f i x ,
long
prefix_size ,
long
cluster_num ,
long count
);

/ / Block in
/ / Long i n
/ / Long o u t

Parameters:
prefix is the persistent ID prefix for the cluster to look up.
cluster_num is the cluster number for the cluster to look up.
count the number of member records found for the cluster

Return Code:
negative for error, 0 for success
131

CALLING FROM C WITHOUT ARRAYS

ids_pid_member_get
Description:
Called after ids_pid_member_count in a consecutive manner to retrieve the member records for a
cluster.

Prototype:
long ids_pid_member_get (
long sockh ,
char p r e f i x ,
long
prefix_size ,
long
cluster_num ,
char record ,
long
record_size ,
long r e c i d
);

/ / Block in
/ / Long i n
/ / Block out
/ / Long o u t

Parameters:
prefix is the persistent ID prefix for the cluster.
cluster_num cluster_num is the cluster number for the cluster.
record the member record in IDT layout.
recid is rhe Rescord-Id for the member record (corresponding to the RECID column from the IDT)

Return Code:
negative for error, 0 for success, and 1 for "end of set".

ids_pid_open
Description:
Open resources for use with Persistent-ID.

Prototype:
long ids_pid_open (
long sockh ,
char m u l t i _ s e a r c h
);

/ / String in

Parameters:
multi_search is the name of a multi-search which uses Persistent-ID. This function requires a prior
call to ids_system_open.
ids_pid_member_get

132

Return Code:
negative for error, 0 for success

ids_pid_search_get
Description:
Retrieve Preferred records which are a good match for the search record specified in the
ids_search_start or ids_system_search_start function. This function will return extended
matching information, including the match decision and the file (IDT) record-ID of the matching
records.

Prototype:
long i d s _ p i d _ s e a r c h _ g e t (
long sockh ,
char search ,
char f i l e _ r e c ,
long
file_rec_size ,
long s c o r e ,
char d e c i s i o n ,
long
decision_size ,
long f i l e _ r e c i d ,
long c l u s t e r _ c o u n t
);

/ / String in
/ / Block out
/ / Long o u t
/ / String out
/ / Long o u t
/ / Long o u t

Parameters:
search is the name of the Search which was performed.
file_rec is the matched File record.
score is the degree of similarity between the Search and File records (0-100).
decision is the match decision: A(ccept) or U(ndecided)
file_recid is the File Record-ID (corresponding to the RECID column from the IDT).
cluster_count is the number of clusters asociated with the cluster.

Return Code:
negative for error, 0 for success, and 1 for "end of set".

ids_pid_search_get_clusters
Description:
May be called after each call to ids_pid_search_get to retrieve the clusters associated with the
preferred record.
133

CALLING FROM C WITHOUT ARRAYS

Prototype:
long i d s _ p i d _ s e a r c h _ g e t _ c l u s t e r s (
long sockh ,
char search ,
//
long
file_recid ,
//
char p r e f i x s ,
//
long
prefixs_num ,
long
prefixs_size ,
long cluster_nums ,
//
long
cluster_nums_num
);

String in
Long i n
BlockArray out

LongArray o u t

Parameters:
search is the name of the Search which was performed.
file_recid is the Preferred Record-ID (corresponding to the RECID column from the IDT).
prefixs is the prefix for the associated cluster
cluster_nums is the number for the asociated cluster

Return Code:
negative for error, 0 for success

ids_pid_src_pk_get
Description:
Get persistent ids one at a time

Prototype:
long i d s _ p i d _ s r c _ p k _ g e t (
long sockh ,
char src_pk_value ,
/ / BlockArray out
long
src_pk_value_num ,
long
src_pk_value_size
);

Parameters:
src_pk_value the values of primary keys from the source table

Return Code:
negative for error, 0 for success
ids_pid_src_pk_get

134

ids_pid_src_pk_start
Description:
Search for persistent ids

Prototype:
long i d s _ p i d _ s r c _ p k _ s t a r t (
long sockh ,
char m u l t i _ s e a r c h ,
char src_pk ,
long
src_pk_num ,
long
src_pk_size
);

/ / String in
/ / BlockArray in

Parameters:
multi_search the name of the multi-search
src_pk the values of primary keys from the source table

Return Code:
negative for error, 0 for success

ids_ps_get_entity_list
Description:
Retrieves entity names supported by the current population

Prototype:
long i d s _ p s _ g e t _ e n t i t y _ l i s t (
long sockh ,
char gross_names ,
/ / StringArray out
long
gross_names_num ,
long
gross_names_size ,
char fine_names ,
/ / StringArray out
long
fine_names_num ,
long
fine_names_size
);

Parameters:
gross_names List of Gross entity names
fine_names List of Fine entity names

Return Code:
negative for error, 0 for success
135

CALLING FROM C WITHOUT ARRAYS

ids_ps_get_entity_max_elements
Description:
Retrieves number of entity array elements

Prototype:
long i d s _ p s _ g e t _ e n t i t y _ m a x _ e l e m e n t s (
long sockh ,
char type ,
/ / String in
long elements
/ / Long o u t
);

Parameters:
type Type of entity: Input, Gross, Fine, Standard, Format
elements maximum number of occurrences

Return Code:
negative for error, 0 for success

ids_ps_get_entity_max_length
Description:
Retrieves maximum length of an entity value

Prototype:
long i d s _ p s _ g e t _ e n t i t y _ m a x _ l e n g t h (
long sockh ,
char type ,
/ / String in
long l e n g t h
/ / Long o u t
);

Parameters:
type Type of entity: Input, Gross, Fine, Standard, Format
length maximum length (bytes) of an entity value

Return Code:
negative for error, 0 for success
ids_ps_get_entity_max_elements

136

ids_ps_parse
Description:
Parse, Standardize and Format API

Prototype:
long i d s _ p s _ p a r s e (
long sockh ,
char o p e r a t i o n ,
char input ,
long
input_size ,
char gross ,
long
gross_num ,
long
gross_size ,
char f i n e ,
long
fine_num ,
long
fine_size ,
char standard ,
long
standard_num ,
long
standard_size ,
char ps_format ,
long
ps_format_num ,
long
ps_format_size
);

/ / String in
/ / Block in
/ / BlockArray io

/ / BlockArray io

/ / BlockArray io

/ / BlockArray out

Parameters:
operation The operation(s) to perform: G, F, S, M
input Unparsed input string
gross Gross entities used as input or output
fine Fine entities used as input or output
standard Standardized entities used as input or output
ps_format Formatted output string

Return Code:
negative for error, 0 for success

ids_ps_set_encoding
Description:
Defines encoding used for the input/output data
137

CALLING FROM C WITHOUT ARRAYS

Prototype:
long i d s _ p s _ s e t _ e n c o d i n g (
long sockh ,
long
encoding
);

/ / Long i n

Parameters:
encoding 0=Population default, 8=UTF-8, 16=UTF-16

Return Code:
negative for error, 0 for success

ids_ps_set_entity_list
Description:
Defines a subset of entities for input/output

Prototype:
long i d s _ p s _ s e t _ e n t i t y _ l i s t (
long sockh ,
char type ,
/ / String in
char e n t i t y _ l i s t ,
/ / StringArray in
long
entity_list_num
);

Parameters:
type Type of entity: Gross or Fine
entity_list List of entity names

Return Code:
negative for error, 0 for success

ids_ps_set_population
Description:
Defines the System and Population used for parsing rules
ids_ps_set_entity_list

138

Prototype:
long i d s _ p s _ s e t _ p o p u l a t i o n (
long sockh ,
char system ,
char p o p u l a t i o n
);

/ / String in
/ / String in

Parameters:
system System Name
population Specifies a Population within the System

Return Code:
negative for error, 0 for success

ids_real_time_async_get
Description:
Used to retrieve the result count associated with a call to ids_real_time_async_start.
cluster_action_count specifies the number of results that are available for collection using
ids_real_time_sync_get.

Prototype:
long i d s _ r e a l _ t i m e _ a s y n c _ g e t (
long sockh ,
char r e f e r e n c e ,
/ / String in
long
block ,
/ / Long i n
long c l u s t e r _ a c t i o n _ c o u n t / / Long o u t
);

Parameters:
reference A
reference
number
ids_real_time_sync_start)

identifying

the

request

(returned

by

block 1 = wait for a response 0 = return immediately if no results are available yet
cluster_action_count The number of clusters generated These can be returned with call to
real_time_sync_get 1 = wait for a response

Return Code:
negative for error 0 for success positive for no results are available yet
139

CALLING FROM C WITHOUT ARRAYS

ids_real_time_async_start
Description:
Used to start a synchronizer transaction of the Real Time Synchronization server. This call works in an
asynchronous fashion and will return when the transaction has been placed on the servers work queue
rather than when the transaction has been processed. The record passed in must match the layout of
the IDT. This call must be followed by a call to ids_real_time_async_get, then by one or more
calls to ids_real_time_sync_get to retrieve the results.

Prototype:
long i d s _ r e a l _ t i m e _ a s y n c _ s t a r t (
long sockh ,
char r u l e b a s e ,
//
char system ,
//
char IDT ,
//
char sequence_number , / /
char o p e r a t i o n ,
//
char c l u s t e r _ r e c o r d , / /
long
cluster_record_size
long
source ,
//
char m u l t i _ s e a r c h ,
//
long
input_id ,
//
char r e f e r e n c e ,
//
long
reference_size
);

String in
String in
String in
String in
String in
Block in
,
Long i n
String in
Long i n
String out

Parameters:
rulebase is the name of the rulebase.
system The name of the system in the rulebase
IDT is the name of the IDT associated with the update.
sequence_number is a string that specifies the order of synchronization. Must obey the rules for
sequence numbers found in the O PERATIONS M ANUAL.
operation The synchronizer operation being performed: A for add or D for delete
cluster_record The record to be updated. The record must use the same layout as the IDT.
source Identifies the source of clustering: 0 = Real Time Synchronizer 1 = Flat file 2 = NSA table
multi_search The name of the multi-search which uses Persistent-ID. This parameter should be set
to an empty string for an IDT/IDX only transaction.
input_id The cluster id or record id as appropriate
reference A reference string identifying the request.
ids_real_time_sync_get call when retrieving results.

This must be passed to the

Return Code:
negative for error
0 for success positive for warnings:
ids_real_time_async_start

140

1-9 Reserved for future use


10 warnings: Duplicate PK detected on add to IDT with WARN_DUPLICATE_PK sync option.
11 warnings: Duplicate transaction was skipped.
12 warnings: Transaction was rejected because the sequence number was less than or equal to a previous transaction. The record was added to the reject table.

ids_real_time_flul_add
Description:
This API used to add force link and unlink rule.
ids_real_time_flul_init.

This call must be followed by

Prototype:
long i d s _ r e a l _ t i m e _ f l u l _ a d d (
long sockh ,
char r u l e _ t y p e ,
/ / String in
char s u b j e c t _ r e c _ p k , / / B l o c k i n
long
subject_rec_pk_size ,
char r e l a t i o n s h i p ,
/ / String in
char r e l a t e d _ r e c _ p k , / / B l o c k i n
long
related_rec_pk_size
);

Parameters:
rule_type This field is for specifying the type of the rule. A value of A represents that the rule needs
to be added to the system and D represents that a rule needs to be removed from the system
subject_rec_pk This field is for specifying the PK of the subject record
relationship This field is for specifying the relationship between the subject record and related
record. A value of L represents a Link rule between the subject record and the related record and a
value of U represents an Unlink rule between the subject record and the related record.
related_rec_pk This field is for specifying the PK of the record that is either linked or unlinked to
the subject record.

Return Code:
negative for error, 0 for success 3 when the Link rule is not allowed. Record unlinked with members of
subject cluster.

ids_real_time_flul_close
Description:
This API used to close and release force link and unlink module.
141

CALLING FROM C WITHOUT ARRAYS

Prototype:
long i d s _ r e a l _ t i m e _ f l u l _ c l o s e (
long sockh ,
);

Parameters:
none

Return Code:
negative for error, 0 for success

ids_real_time_flul_delete
Description:
This API used to delete force link and unlink rule from MR table. This call must be followed by
ids_real_time_flul_init.

Prototype:
long i d s _ r e a l _ t i m e _ f l u l _ d e l e t e (
long sockh ,
long
r u l e _ t y p e _ o p t i o n , / / Long i n
char record_pk ,
/ / Block in
long
record_pk_size
);

Parameters:
rule_type_option

0 Delete only disabled rules for input pk.

1 Delete only active rules for input pk.


2 Delete all rules for input pk.
record_pk This field is for specifying the PK of the record to be deleted

Return Code:
negative for error, 0 for success

ids_real_time_flul_find_rule
Description:
This API used to find link and unlink information for input IDT record. should be called after
ids_real_time_flul_init API.
ids_real_time_flul_delete

142

Prototype:
long i d s _ r e a l _ t i m e _ f l u l _ f i n d _ r u l e (
long sockh ,
char i d t _ r e c ,
/ / Block in
long
idt_rec_size ,
long
option
/ / Long i n
);

Parameters:
idt_rec This field is for specifying the PK of the record to be searched
option

0 Link Rule.

1 Unlink Rule.

Return Code:
negative for error, 0 for success

ids_real_time_flul_get_rule
Description:
This API used fetch link and unlink information for input IDT record.
ids_real_time_flul_find_rule API.

Should be called after

Prototype:
long i d s _ r e a l _ t i m e _ f l u l _ g e t _ r u l e (
long sockh ,
char i d t _ r e c ,
/ / Block out
long
idt_rec_size
);

Parameters:
idt_rec is the matched File record for input link or unlink rule.

Return Code:
negative for error, 0 for success

ids_real_time_flul_init
Description:
This API used to initialize force link and unlink module.
Memory allocated a part of
ids_real_time_flul_init is released using ids_real_time_flul_close.
143

CALLING FROM C WITHOUT ARRAYS

Prototype:
long i d s _ r e a l _ t i m e _ f l u l _ i n i t (
long sockh ,
char idt_name ,
char m u l t i _ s e a r c h
);

/ / String in
/ / String in

Parameters:
idt_name is the name of the IDT associated with the force link and unlink rule.
multi_search The name of the multi-search which uses Persistent-ID. This parameter should be set
to an empty string for an IDT only MR rule creation.

Return Code:
negative for error, 0 for success

ids_real_time_sync_get
Description:
Use to retrieve the results and free the resources associated with a call to
ids_real_time_sync_start or ids_real_time_async_start. Should be called until it
returns a non zero response.

Prototype:
long i d s _ r e a l _ t i m e _ s y n c _ g e t (
long sockh ,
char r e f e r e n c e ,
/ / String in
char c l u s t e r _ a c t i o n _ t y p e , / / S t r i n g o u t
long
cluster_action_type_size ,
char c l u s t e r _ a c t i o n _ i d , / / S t r i n g o u t
long
cluster_action_id_size ,
long c l u s t e r _ a c t i o n _ n u m b e r , / / Long o u t
char c l u s t e r _ a c t i o n _ n e w , / / S t r i n g o u t
long
cluster_action_new_size
);

Parameters:
reference A reference string identifying the request.
ids_real_time_sync_get call when retriving results.

This must be passed to the

cluster_action_type Identifies the action, ie add or delete


cluster_action_id The prefix which identifies the cluster
cluster_action_number The number which identifies the cluster
cluster_action_new Identifies whether the cluster is newly formed or existing
ids_real_time_sync_get

144

Return Code:
negative for error, 0 for success, 1 for end of results

ids_real_time_sync_start
Description:
Used to start a synchronizer transaction of the Real Time Synchronization server. This call works
in a synchronous fashion returning only when the transaction has been processed. The record
passed in must match the layout of the IDT. This call must be followed by one or more calls to
ids_real_time_sync_get to retrieve results.

Prototype:
long i d s _ r e a l _ t i m e _ s y n c _ s t a r t (
long sockh ,
char r u l e b a s e ,
/ / String in
char system ,
/ / String in
char IDT ,
/ / String in
char sequence_number , / / S t r i n g i n
char o p e r a t i o n ,
/ / String in
char c l u s t e r _ r e c o r d , / / B l o c k i n
long
cluster_record_size ,
long c l u s t e r _ a c t i o n _ c o u n t , / / Long o u t
char r e f e r e n c e ,
/ / String out
long
reference_size
);

Parameters:
rulebase is the name of the rulebase.
system The name of the system in the rulebase
IDT is the name of the IDT associated with the update.
sequence_number is a string that specifies the order of synchronization. Must obey the rules for
sequence numbers found in the O PERATIONS M ANUAL.
operation The synchronizer operation being performed: A for add or D for delete
cluster_record The record to be updated. The record must use the same layout as the IDT.
cluster_action_count The number of clusters generated. For IDT/IDX only processing this parameter will always be 0. These can be returned with ids_real_time_sync_get
reference A reference string identifying the request.
ids_real_time_sync_get call when retriving results.

Return Code:
negative for error
0 for success, and postive for warnings:
145

CALLING FROM C WITHOUT ARRAYS

This must be passed to the

1-9 Reserved for future use


10 warning: Duplicate PK detected on add to IDT with WARN_DUPLICATE_PK sync option.
11 warning: Transaction was skipped.
12 warning: Transaction was reject because the sequence number was lessa than or equal to a previous
transaction. The record was added to the reject table.
13 warning: Transaction became a No Op. e.g. Add followed by delete in the same commit cycle
equates to do nothing.
14 warning: Force server shutdown in progress.
15 warning: Could not perform delete as the IDT record was not found. This will normally trigger
error unless the appropriate option is set in the syncronization server configuration.

ids_scores_get
Description:
Retrieve an array of scores, one per match record. This API is used in conjunction with ids_search_start
when candidate records to be matched are provided by the caller. The records and their scores may be
retrieved either by repeatedly calling ids_search_get or by calling this function to retrieve all scores at
once. A limit of 1024 scores may be returned in a single call. When using this function, please ensure
that an Accept limit of 0 has been specified (so that all candidates are returned regardless of their score),
and specify a SORT= parameter in the Search-Definition to ensure that the records remain in the same
order as passed otherwise they will be sorted by descending score. This is perhaps best achieved by
inserting a record number in each row and sorting by that field. The size of the scores array must be
equal to the number of input records to be matched, and may not exceed 1024.

Prototype:
long i d s _ s c o r e s _ g e t (
long sockh ,
char searchname ,
long s c o r e s ,
long
scores_num
);

/ / String in
/ / LongArray o u t

Parameters:
searchname is the name of the associated search
scores is an array of scores, one per candidate record

Return Code:
negative for error, 0 for success

ids_search_comment_get
Description:
Returns the user defined comment stored with the search.
ids_scores_get

146

Prototype:
long ids_search_comment_get (
long sockh ,
char searchname ,
char comment ,
long
comment_size
);

/ / String in
/ / String out

Parameters:
searchname the search to count.
comment is the area to copy the string containing the comment. This string will be null-terminated.

Return Code:
negative for error, 0 for success

ids_search_dedupe_start
Description:
Search for duplicate records in the IDT. Refer to the Dup Finder section in this manual for details.

Prototype:
long i d s _ s e a r c h _ d e d u p e _ s t a r t (
long sockh ,
char search ,
char search_width ,
char m a t c h _ t o l e r a n c e
char parameters ,
long
parameters_num ,
long
parameters_size
char s e a r c h r e c ,
long
searchrec_size ,
char AnswersetName ,
long
flags ,
long r e c i d ,
long r e c s
);

//
//
, //
//

String in
String in
String in
BlockArray in

,
/ / Block io
//
//
//
//

String in
Long i n
Long i o
Long i o

Parameters:
search is the name of the search that is to be performed.
search_width specifies either Narrow, Typical or Exhaustive to nominate how many candidates should be selected.
match_tolerance specifies either Conservative, Typical or Loose to nominate how aggressive
the matching scheme should be in rejecting candidates.
parameters not used.
147

CALLING FROM C WITHOUT ARRAYS

searchrec is the IDT record used to search with. It is returned by the Search Server.
AnswersetName is used store the search results in an AnswerSet. The Answerset is used to identify
the Search results in the table and is constructed by concatenating the AnswersetName parameter with
the Search-Record-Id (10 bytes) . The maximum AnswersetName length is 22 characters. If you do not
wish to store the search results in an AnswerSet, set AnswersetName to an empty String.
flags flags for specifying options. This field is a bit-field. Valid values are: 2 = return search record
only. 4=remove search record from returned set.
recid the recid of the record to start a searching on. A value of 0 starts searching from the beginning
of the IDT. The returned value is the recid of the next record to be searched.
recs the number of records in the search set.

Return Code:
negative for error, 0 for success, and 1 for truncation of the search set.

ids_search_fields_count
Description:
Gets the number of fields required to assemble the search record.

Prototype:
long i d s _ s e a r c h _ f i e l d s _ c o u n t (
long sockh ,
char searchname ,
long f c
);

/ / String in
/ / Long o u t

Parameters:
searchname the search to count.
fc is the number of fields required to be filled in to assemble the search.

Return Code:
negative for error, 0 for success

ids_search_fields_get
Description:
Gets the number of fields required to assemble the search record.
ids_search_fields_count

148

Prototype:
long i d s _ s e a r c h _ f i e l d s _ g e t (
long sockh ,
char searchname ,
/ / String in
char fieldnames ,
/ / StringArray out
long
fieldnames_num ,
long
fieldnames_size
);

Parameters:
searchname the search to count.
fieldnames is the array returned which will contain the name of the fields.

Return Code:
negative for error, 0 for success

ids_search_filter
Description:
Sets a dynamic SQL filter to be used by a search. Refere to the SQL Filters section of the D ESIGNER
M ANUAL for details about SQL filters

Prototype:
long i d s _ s e a r c h _ f i l t e r (
long sockh ,
char search ,
char f i l t e r
);

/ / String in
/ / String in

Parameters:
search is the name of the Search that will use the filter
filter is a string containing an SQL expression or values for substituion variables

Return Code:
negative for error, 0 for success

ids_search_finish
Description:
Release resources associated with ids_search_start.
149

CALLING FROM C WITHOUT ARRAYS

Prototype:
long i d s _ s e a r c h _ f i n i s h (
long sockh ,
char s e a r c h
);

/ / String in

Parameters:
search is the name of the search that was performed

Return Code:
negative for error, 0 for success

ids_search_get
Description:
Retrieve file records that are a good match for the search record specified in the ids_search_start
or ids_system_search_start function.

Prototype:
long i d s _ s e a r c h _ g e t (
long sockh ,
char searchname ,
//
char s e a r c h r e t u r n ,
//
long
searchreturn_size ,
long s c o r e ,
//
long sreps ,
//
long
sreps_num ,
long f r e p s ,
//
long
freps_num
);

String in
Block out
Long o u t
LongArray o u t
LongArray o u t

Parameters:
searchname is the name the search to used by the call.
searchreturn is an area into which a string from the set is copied.
score is the score calculated for the string.
sreps is an array of the ordinal values of the repeating fields in the search record that were used in
the match.
Note: sreps and freps are only meaningful when using SSA-NAME3 v1, the SEQUENCES
option has been set in the Search-Definition, and the search and file records contain repeating
groups
freps is an array of the ordinal values of the repeating fields in the file record that were used in the
match.
ids_search_get

150

For example, a record structure with a repeating name (2 fields) and a repeating address (2
fields) , if the first name field in the search record matched the second name field in the file
record while the first address field of the source matched the first address field of the file; the
contents of these two arrays would be; sreps[0] = 0, srep[1] = 0, freps[0] = 1, frep[1] = 0

Return Code:
negative for error, 0 for success, and 1 for "end of set".

ids_search_get_complete
Description:
Retrieve file records which are a good match for the search record specified in the ids_search_start
or ids_system_search_start function. This function will return extended matching information
in the info field as long as the Search-Definition specifies the SEQUENCES option, and SSA-NAME3
v1 is used.

Prototype:
long i d s _ s e a r c h _ g e t _ c o m p l e t e (
long sockh ,
char search ,
//
char s e a r c h r e t u r n ,
//
long
searchreturn_size ,
long s c o r e ,
//
char i n f o ,
//
long
info_size
);

String in
Block out
Long o u t
Block out

Parameters:
search is the name of the search which was performed.
searchreturn is an area into which a string from the set is copied.
score is the score calculated for the string.
info an encoded list of values used to determine which occurrence of a repeating field matched the
value in the search record. The info field has a length of 4*(1+3*100) bytes. It contains 4 groups, each
one representing the result from one of the four possible scoring phases: Key-Pre-Score, Key-Score,
Pre-Score and Score respectively. If a phase was used, its data starts with a 1, otherwise 0 if the phase
was not used. The indicator is followed by 100 three-digit numbers, one each for each method in the
scoring-scheme for this phase, up to a limit of 100 methods per scheme (scoring phase). The three-digit
number is an index (base 1) representing the occurrence in the file record that was the best match for
the data in the search record.

Return Code:
negative for error, 0 for success, and 1 for "end of set".
151

CALLING FROM C WITHOUT ARRAYS

ids_search_get_detail
Description:
Retrieve file records which are a good match for the search record specified in the ids_search_start
or ids_system_search_start function. This function will return extended matching information,
including the match decision and the file (IDT) record-ID of the matching records.

Prototype:
long i d s _ s e a r c h _ g e t _ d e t a i l (
long sockh ,
char search ,
char f i l e _ r e c ,
long
file_rec_size ,
long s c o r e ,
char d e c i s i o n ,
long
decision_size ,
long f i l e _ r e c i d
);

/ / String in
/ / Block out
/ / Long o u t
/ / String out
/ / Long o u t

Parameters:
search is the name of the Search which was performed.
file_rec is the matched File record.
score is the degree of similarity between the Search and File records (0-100).
decision is the match decision: A(ccept) or U(ndecided)
file_recid is the File Record-ID (corresponding to the RECID column from the IDT).

Return Code:
negative for error, 0 for success, and 1 for "end of set".

ids_search_IDT_get
Description:
Gets the name of the IDT associated with the search.

Prototype:
long i d s _ s e a r c h _ I D T _ g e t (
long sockh ,
char searchname ,
char IDT ,
long
IDT_size
);

/ / String in
/ / String out

ids_search_get_detail

152

Parameters:
searchname is the name the search to used by the call.
IDT is the area into which the IDT name will be copied

Return Code:
negative for error, 0 for success

ids_search_layout
Description:
Get the names and descriptions of the fields in the current input or output view. If no view has been
defined, the IDT layout will be returned.

Prototype:
long i d s _ s e a r c h _ l a y o u t (
long sockh ,
char search ,
char viewType ,
char func ,
char names ,
long
names_num ,
long
names_size ,
long l e n g t h s ,
long
lengths_num ,
long o f f s e t s ,
long
offsets_num ,
long r e p e a t s ,
long
repeats_num ,
char formats ,
long
formats_num ,
long
formats_size
);

//
//
//
//

String in
String in
String in
StringArray out

/ / LongArray o u t
/ / LongArray o u t
/ / LongArray o u t
/ / StringArray out

Parameters:
search is the name of the Search which was performed.
viewType the type of view: input or output.
func describes the order of fields.
names is the area into which an array containing the fieldnames will be copied.
lengths is the area into which an array containing the lengths of the fields will be copied.
offsets is the area into which an array containing the offsets of the fields will be copied.
repeats is the area into which an array containing the number of repeats in a field will be copied.
formats is the area into which an array containing the format a field will be copied. The format of a
fields is a 50 character string in the following format:
153

CALLING FROM C WITHOUT ARRAYS

Character 0:

Justification (Left or Right)

Character 1:

Compression (Fixed, Variable or Long)

Characters2 - 3:

Fill (2 characters containing the fill character in hexadecimal)

Character 4:

Fill type (Text or Binary)

Characters 5 - 6:

Base (2 characters containing the base in decimal)

Character 7:

Format (Text, Numeric, Variable or Binary)

Character 8 - 9:

Reserved

Characters 10 - 11:

Binary key number (2 hexadecimal digits)

Character 12:

Character width (Wide, Narrow)

Characters 13 - 50:

Reserved

Note: It is recommended that the FORMATS_SIZE constant be used to prevent errors from
undersized strings.

Return Code:
negative for error, 0 for success

ids_search_start
Description:
Performs a search using a pre-constructed search-record (searchrec). Alternatively you can supply
fields (parameters) and have ids_search_start construct the record. The order of the field values
in parameters should be the same as that returned by ids_search_fields_get. You can either search the
database or search against a supplied list of records (records). There is a limit of 64K bytes of data that
can be sent to the Server. If the supplied list of records is too large, split it into smaller groups and make
multiple calls.
Note: The first search for a given System incurs an additional overhead to allocate database
resources and access the Rulebase. Switching between searches on a particular connection
is equivalent to starting a new search and therefore incurs some overhead. Applications requiring the best possible search performance should be designed to avoid switching between
searches. The easiest way to do this is to use separate (dedicated) connections for each Search.

Prototype:
long i d s _ s e a r c h _ s t a r t (
long sockh ,
char search ,
char search_width ,
char m a t c h _ t o l e r a n c e
char parameters ,
long
parameters_num ,
long
parameters_size
char s e a r c h r e c ,
long
searchrec_size ,

//
//
, //
//

String in
String in
String in
BlockArray in

,
/ / Block io

ids_search_start

154

char
long
char
long
long

AnswersetName ,
recs ,
r ec o rd s ,
records_num ,
records_size

/ / String in
/ / Long o u t
/ / BlockArray in

);

Parameters:
search is the name of the search to be performed.
search_width specifies either Narrow, Typical or Exhaustive to nominate how many candidates should be selected. If left blank, the Search_Level in the Controls will be used.
match_tolerance specifies either Conservative, Typical or Loose to nominate how aggressive
the matching scheme should be in rejecting candidates. If left blank, the Match_Level in the Controls
will be used.
parameters contains the field values used to construct a search record (searchrec). The order
of the field values must correspond to the order of fields returned by ids_search_fields_get. If
insufficient fields are supplied, the remaining fields in the constructed search record will be blank filled.
searchrec is the record that we will search on (in IDT format, or the input view if specified). If
searchrec is specified it will be used to search (provided no parameters are supplied). Alternatively if parameters are specified then the search will be on a record constructed on those parameters
and returned to the user.
AnswersetName is used store the search results in an AnswerSet. AnswersetName is used to identify
the Search results in the table. The maximum AnswersetName length is 32 characters. If you do not
wish to store the search results in an AnswerSet, set AnswersetName to an empty String.
recs number of records that matched the search criteria. The count reflects the number of records
prior to sorting the result set. If the sort uses the Unique_Keys option to remove duplicates, the
resulting set may contain less than recs records. In this case, you must use the response code from
ids_search_get to determine when the end of set has been reached.
records contains a list of records to search on. If you wish to search on the database then specify this
as containing 0 records.

Return Code:
negative for error, 0 for success, and 1 for truncation of the search set, and 2 for exceeding
SEARCH_LIMIT

ids_search_tolerances_count
Description:
Returns the match tolerances count that have for the search. The match tolerance defines how aggressively the matching scheme should be in rejecting candidates.

Prototype:
155

CALLING FROM C WITHOUT ARRAYS

long i d s _ s e a r c h _ t o l e r a n c e s _ c o u n t (
long sockh ,
char searchname ,
/ / String in
long count
/ / Long o u t
);

Parameters:
searchname is the name the search to used by the call.
count is the number of widths for the search by the call.

Return Code:
negative for error, 0 for success

ids_search_tolerances_get
Description:
Returns the match tolerances that have been defined for the search. The match tolerance defines how
aggressively the matching scheme should be in rejecting candidates.

Prototype:
long i d s _ s e a r c h _ t o l e r a n c e s _ g e t (
long sockh ,
char searchname ,
/ / String in
char t o l e r a n c e s ,
/ / StringArray out
long
tolerances_num ,
long
tolerances_size
);

Parameters:
searchname the search to count.
tolerances is the list of null terminated strings returned by the call.

Return Code:
negative for error, 0 for success

ids_search_view_get
Description:
Returns the name of the current input or output view, together with information about the
view: view_field_count is needed to dynamically allocate the arrays used for calls to
ids_search_layout and view_length is used to dynamically allocate memory for input/output
records.
ids_search_tolerances_get

156

Prototype:
long i d s _ s e a r c h _ v i e w _ g e t (
long sockh ,
char search ,
//
char viewType ,
//
char viewName ,
//
long
viewName_size ,
long viewFieldCount , / /
long viewRecLen
//
);

String in
String in
String out
Long o u t
Long o u t

Parameters:
search is the name of the Search
viewType the type of the view (input or output)
viewName is the name of the view to query
viewFieldCount the number of fields in the view
viewRecLen is the length of the view

Return Code:
negative for error, 0 for success

ids_search_view_set
Description:
Sets a view as the active input or output view

Prototype:
long i d s _ s e a r c h _ v i e w _ s e t (
long sockh ,
char search ,
char viewType ,
char viewName
);

/ / String in
/ / String in
/ / String in

Parameters:
search is the name of the Search
viewType the type of the view (input or output)
viewName the name of the view to use

Return Code:
negative for error, 0 for success
157

CALLING FROM C WITHOUT ARRAYS

ids_search_widths_count
Description:
Returns the count of search widths that have been defined for the search. The search width defines how
many items are selected by the search

Prototype:
long i d s _ s e a r c h _ w i d t h s _ c o u n t (
long sockh ,
char searchname ,
long count
);

/ / String in
/ / Long o u t

Parameters:
searchname is the name the search to used by the call.
count is the number of widths for the search by the call.

Return Code:
negative for error, 0 for success

ids_search_widths_get
Description:
Returns the search widths that have been defined for the search. The search width defines how many
items are selected by the search

Prototype:
long i d s _ s e a r c h _ w i d t h s _ g e t (
long sockh ,
char searchname ,
char widths ,
long
widths_num ,
long
widths_size
);

/ / String in
/ / StringArray out

Parameters:
searchname is the name the search to used by the call.
widths is the list of null terminated strings returned by the call.

Return Code:
negative for error, 0 for success
ids_search_widths_count

158

ids_server_version_get
Description:
Get the version information associated with the server.

Prototype:
long i d s _ s e r v e r _ v e r s i o n _ g e t (
long sockh ,
char s e r v e r _ v e r s i o n , / / S t r i n g o u t
long
server_version_size
);

Parameters:
server_version is the area into which the string containing the version information will be copied.

Return Code:
negative for error, 0 for success

ids_session_close
Description:
Closes the session currently allocated. This will cause the databases kept open by the connection server
to close and prevent the reuse of the session by subsequent calls by ids_session_open.

Prototype:
long i d s _ s e s s i o n _ c l o s e (
long sockh ,
);

Parameters:
none

Return Code:
negative for error, 0 for success

ids_session_open
Description:
Allocates resources for a socket. This is an API to the IDS Connection Server. The IDS Connection
Server sits between the client and the IDS Search Server. A session prevents the IDS Search Server
159

CALLING FROM C WITHOUT ARRAYS

from reopening databases by keeping the databases open between connections. A timeout value can be
specified when starting the IDS Connection Server. If the session has not been reused or closed before
the timeout period it will be closed automatically.

Prototype:
long i d s _ s e s s i o n _ o p e n (
long sockh ,
long s e s s i o n
);

/ / Long i o

Parameters:
session is the number of the session to open (-1 for a new session).

Return Code:
negative for error, 0 for success

ids_set_encoding
Description:
Informs the Search Server of the encoding used for fields of type W (UNICODE data). ISS stores and
retrieves W fields using an UTF-16 encoding. Search records should use this encoding for W columns
if possible. If they do not, the caller must use this API to inform the Search Server of the alternate
encoding used so that the Server can convert the data prior to using it. The W fields in each record of
the result set will be converted (if necessary) to the callers encoding prior to return. If no encoding is
specified, ISS assumes that the search data matches the file data and no conversion is performed. Refer
to the Globalization section of the O PERATIONS manual for further details and restrictions.

Prototype:
long i d s _ s e t _ e n c o d i n g (
long sockh ,
long
encoding
);

/ / Long i n

Parameters:
encoding 6=UTF-16/UCS-2 (LE), 7=UTF-16/UCS-2 (BE), 8=UTF-8, 4=UCS-4

Return Code:
negative for error, 0 for success

ids_set_vpd_user
ids_set_encoding

160

Description:
Provides the Search Server with information required to set a Virtual Private Database context. Refer
to the D ESIGNER M ANUAL, VPD section for details about VPD.

Prototype:
long i d s _ s e t _ v p d _ u s e r (
long sockh ,
char vpd_user ,
char vpd_ctx
);

/ / String in
/ / String in

Parameters:
vpd_user Connection string of the actual user
vpd_ctx the name of the PL/SQL context setting package

Return Code:
negative for error, 0 for success

ids_system_close
Description:
closes the system and frees any remaining resources.

Prototype:
long i d s _ s y s t e m _ c l o s e (
long sockh ,
);

Parameters:
none

Return Code:
negative for error, 0 for success

ids_system_idtname_count
Description:
Returns the number of active idt names. (i.e. those whose IDT has been loaded).
161

CALLING FROM C WITHOUT ARRAYS

Prototype:
long ids_system_idtname_count (
long sockh ,
long i d t c o u n t
/ / Long o u t
);

Parameters:
idtcount is the number of idtnames defined on the system

Return Code:
negative for error, 0 for success

ids_system_idtname_get
Description:
Get the names of all IDTs that are active. (i.e. those whose IDT has been loaded).

Prototype:
long ids_system_idtname_get (
long sockh ,
char idtnames ,
long
idtnames_num ,
long
idtnames_size
);

/ / StringArray out

Parameters:
idtnames is the area into which an array of the idtnames defined on the rulebase will be copied (the
idtnames are all null terminated strings).

Return Code:
negative for error, 0 for success

ids_system_notify
Description:
Notifies search server on a system.

Prototype:
ids_system_idtname_get

162

long i d s _ s y s t e m _ n o t i f y (
long sockh ,
char r u l e b a s e ,
char sysname ,
char message
);

/ / String in
/ / String in
/ / String in

Parameters:
rulebase is the name of the rulebase.
sysname is the name of the system
message is a messagevto be delivered

Return Code:
negative for error, 0 for success

ids_system_open
Description:
opens a system.

Prototype:
long ids_system_open (
long sockh ,
char r u l e b a s e ,
char system ,
char v e r b o s i t y ,
char Options
);

//
//
//
//

String
String
String
String

in
in
in
in

Parameters:
rulebase is the name of the rulebase.
system The name of the system in the rulebase
verbosity specifies the verbosity level. See the Verbosity section for details.
Options

LOGOUT filename for server output for this session.

LOGERR filename for server errors for this session.


LOGTEST filename for server search trace for this session.
SHOWALLSEARCHES modifies the behavior of
WORKDIR used to inform the search server as to which directory is to be used as the working directory for this session.

Return Code:
negative for error, 0 for success
163

CALLING FROM C WITHOUT ARRAYS

ids_system_pid_searches_count
Description:
Gets the number of persistent ID based multi-searches defined on a system.

Prototype:
long i d s _ s y s t e m _ p i d _ s e a r c h e s _ c o u n t (
long sockh ,
long s e a r c h c o u n t
/ / Long o u t
);

Parameters:
searchcount is the number of persistent ID based multi-searches defined on a system

Return Code:
negative for error, 0 for success

ids_system_pid_searches_get
Description:
Get the names of all persistent ID based multi-searches defined in the system

Prototype:
long i d s _ s y s t e m _ p i d _ s e a r c h e s _ g e t (
long sockh ,
char s e a r c h e s ,
//
long
searches_num ,
long
searches_size ,
char p i d _ p r e f i x ,
//
long
pid_prefix_num ,
long
pid_prefix_size ,
long pid_opts ,
//
long
pid_opts_num ,
long p r e f _ r e c _ o p t s ,
//
long
pref_rec_opts_num
);

StringArray out

BlockArray out

LongArray o u t
LongArray o u t

Parameters:
searches is the area into which an array of the persistent ID based multi-searches defined on the
rulebase will be copied (the searches are all null terminated strings).
pid_prefix the area in which the Persistent ID prefix for the searches will be copied
pid_opts the area into which an array containing the Persistent_ID options for each search will be
copied
pref_rec_opts the area into which an array containing the options for the preferred record generation for each search will be copied
ids_system_pid_searches_count

164

Return Code:
negative for error, 0 for success

ids_system_search_finish
Description:
Finishes the search and closes the system.

Prototype:
long i d s _ s y s t e m _ s e a r c h _ f i n i s h (
long sockh ,
);

Parameters:
none

Return Code:
negative for error, 0 for success

ids_system_search_start
Description:
Opens a system and constructs and initialises a search using the fields passed to it in parameters. Refer
to ids_search_start for a more detailed description of the parameters.

Prototype:
long i d s _ s y s t e m _ s e a r c h _ s t a r t (
long sockh ,
char r u l e b a s e ,
char system ,
char v e r b o s i t y ,
char options ,
char search ,
char parameters ,
long
parameters_num ,
long
parameters_size
char AnswersetName ,
long d a t a l e n ,
long r e c s
);

//
//
//
//
//
//
,

/ / String in
/ / Long o u t
/ / Long o u t

Parameters:
rulebase is the name of the rulebase.
165

String in
String in
String in
String in
String in
BlockArray in

CALLING FROM C WITHOUT ARRAYS

system The name of the system in the rulebase


verbosity specifies the verbosity level. See the Verbosity section for details.
options consists of one or more keywords and their respective values in the form
KEYWORD1=VALUE1,KEYWORD2=VALUE2,
search is the name of the search in the system in the Rulebase that will be used.
parameters is the array which contains the field values to be used to construct the search.
AnswersetName is used store the search results in an AnswerSet. AnswersetName is used to identify
the Search results in the table. The maximum AnswersetName length is 32 characters. If you do not
wish to store the search results in an AnswerSet, set AnswersetName to an empty String.
datalen will return the length of a record.
recs count of records that matched the search criteria

Return Code:
negative for error, 0 for success

ids_system_searches_count
Description:
Returns the number of runnable searches. (i.e. those whose IDX has been loaded). To return the number
of defined searches, add the SHOWALLSEARCHES keyword to the option string of ids_system_open.

Prototype:
long i d s _ s y s t e m _ s e a r c h e s _ c o u n t (
long sockh ,
long s e a r c h c o u n t
/ / Long o u t
);

Parameters:
searchcount is the number of searches defined on the system

Return Code:
negative for error, 0 for success

ids_system_searches_get
Description:
Get the names of all searches that are runnable. (i.e. those whose IDX has been loaded). To return the names of all defined searches, add the SHOWALLSEARCHES keyword to the option string of
ids_system_open.
ids_system_searches_count

166

Prototype:
long i d s _ s y s t e m _ s e a r c h e s _ g e t (
long sockh ,
char s e a r c h e s ,
long
searches_num ,
long
searches_size
);

/ / StringArray out

Parameters:
searches is the area into which an array of the searches defined on the rulebase will be copied (the
searches are all null terminated strings).

Return Code:
negative for error, 0 for success

ids_systems_count
Description:
the number of systems in the rulebase.

Prototype:
long i d s _ s y s t e m s _ c o u n t (
long sockh ,
char r u l e b a s e ,
long systemscount
);

/ / String in
/ / Long o u t

Parameters:
rulebase is the name of the rulebase.
systemscount the number of systems in the rulebase.

Return Code:
negative for error, 0 for success

ids_systems_get
Description:
Get the names of all the systems defined in the rulebase.
167

CALLING FROM C WITHOUT ARRAYS

Prototype:
long i d s _ s y s t e m s _ g e t (
long sockh ,
char r u l e b a s e ,
char systems ,
long
systems_num ,
long
systems_size
);

/ / String in
/ / StringArray out

Parameters:
rulebase is the name of the rulebase.
systems is the area into which an array of the systems defined in the rulebase will be copied (the
systems are all null terminated strings).

Return Code:
negative for error, 0 for success

ids_systems_get

168

Calling from C#
In C# the API methods are made available in the shareable assembly ssasecs.dll. This contains
the classes ids, which contains the API, as well as SSAAPIException and SSASocketException,
which are based on ApplicationException. All of these are in the ssa namespace.
The ids methods throw exceptions of the classes SSAAPIException and SSASocketException
that must be caught. If SSASocketException is caught, the communication channel is closed and no
further calls to the API can be made without reconnecting.

Installation - Win32 client


The shareable assembly can be installed in the global assembly cache with Microsofts gacutil utility:
gacutil /i %SSABIN%\ssasecs.dll

You can then create applications that use it with:


csc /reference:%SSABIN%\ssasecs.dll myprog.cs

Constants
Constants are public properties of the ids class, in uppercase using underscores, eg. ids.MSG_SIZE.

Response code
The response code returned from certain calls is also a public property called rc i.e. ids.rc.

Parameter types
Note: values in BOLD represent information that must be provided to the function.

Constructor
Description:
Used to create a ssa.ids object. This object is then used to make the required API calls to the Search
or Connection Server.

Prototype:
using s s a ;
public i d s (
String
int
) throws SSAException ;
169

CALLING FROM C#

hostname ,
port

/ / String in
/ / long in

Parameters:
hostname is the name or IP address of the computer where the MDM-RE Server is running
port the port number of the MDM-RE Server for which a socket connection is to be established

Returns:
object allocated on success; SSAException on error

addr_get_cass_field
Description:
Use this function to retrieve a validated CASS field. The suggestion_idx specifies the suggestion
from which to select the field value. (1..n for validated data, where n is the n_suggest parameter
returned by ids_addr_validate).

Prototype:
using s s a ;
public byte [ ] a d d r _ g e t _ c a s s _ f i e l d (
int
suggest_idx ,
/ / Long i n
int
field_idx
/ / Long i n
);

Parameters:
suggest_idx Specifies the nth suggestion from which to get a cass field
field_idx Specifies a cass field within the nth suggestion
field_value The cass field value

Return Code:
negative for error, 0 for success

addr_get_cass_field_cnt
Description:
This function returns the maximum number of CASS address fields created as a result of a parse or validate call. Use this value to dynamically allocate the field_length array for the ids_addr_parse
API.
addr_get_cass_field

170

Prototype:
using s s a ;
public i n t a d d r _ g e t _ c a s s _ f i e l d _ c n t ( ) ;

Parameters:
count Returns the max number of cass address fields

Return Code:
negative for error, 0 for success

addr_get_cass_field_info
Description:
This function returns the maximum length of an input address line. It may be used to dynamically
allocate the input lines used for the ids_addr_set_lines API.

Prototype:
using s s a ;
public i n t [ ] a d d r _ g e t _ c a s s _ f i e l d _ i n f o (
int
suggest_idx
/ / Long i n
);

Parameters:
suggest_idx Specifies the suggestion from which to retrieve information
field_length An array containing the length of each cass address field

Return Code:
negative for error, 0 for success

addr_get_del_lines_ext
Description:
Use this function to retrieve delivery address line information

Prototype:
171

CALLING FROM C#

using s s a ;
public s t r u c t a d d r _ g e t _ d e l _ l i n e s _ e x t _ s t r u c t a d d r _ g e t _ d e l _ l i n e s _ e x t (
int
suggest_idx ,
/ / Long i n
int
del_case
/ / Long i n
);

Parameters:
suggest_idx Specifies the suggestion from which to get delivery address lines
del_case Specifies delivery address line case option value. The allowed values are 0 = Unchanged, 1
= Upper case, 2 = Lower case and 3 = Mixed case.
del_line1 delivery address line 1 output string
del_line2 delivery address line 2 output string
del_line3 delivery address line 3 output string
del_line4 delivery address line 4 output string
del_line5 delivery address line 5 output string
del_line6 delivery address line 6 output string

Return Code:
negative for error, 0 for success

addr_get_field
Description:
Use this function to retrieve a validated field. The suggestion_idx specifies the suggestion from
which to select the field value. (1..n for validated data, where n is the n_suggest parameter returned
by ids_addr_validate). val_status and val_mods return a code that describes how the field
matched to validation data and whether or not it was modified by validation. Refer to the Address
Validation section of this manual for a list of codes.

Prototype:
using s s a ;
public s t r u c t a d d r _ g e t _ f i e l d _ s t r u c t a d d r _ g e t _ f i e l d (
int
suggest_idx ,
/ / Long i n
int
field_idx
/ / Long i n
);

Parameters:
suggest_idx Specifies the nth suggestion from which to get a field
field_idx Specifies a field within the nth suggestion
field_value The field value
field_val_status Specifies how this field matched the validation data
field_val_mods Specifies how this field was modified by validation data
addr_get_field

172

Return Code:
negative for error, 0 for success

addr_get_field_count
Description:
This function returns the maximum number of address fields created as a result of a parse or validate
call. Use this value to dynamically allocate the field_length array for the ids_addr_parse API.

Prototype:
using s s a ;
public i n t a d d r _ g e t _ f i e l d _ c o u n t ( ) ;

Parameters:
count Returns the max number of address fields

Return Code:
negative for error, 0 for success

addr_get_field_ext
Description:
Use this function to retrieve all getter fields

Prototype:
using s s a ;
public byte [ ] a d d r _ g e t _ f i e l d _ e x t
int
suggest_idx ,
//
int
field_operation , / /
s t r i n g field_name ,
//
int
field_item_line , / /
string field_type
//
);

(
Long i n
Long i n
String in
Long i n
String in

Parameters:
suggest_idx Specifies the suggestion from which to get fields
field_operation Field operation Option 0 for AddressElements Option 1 for AddressLines Option
2 for AddressComplete Option 3 for EnrichmentData Option 4 for ResultDataParameter Option 5 for
EnrichmentDataStatus
173

CALLING FROM C#

field_name Refer AD Result.dtd for field names


field_item_line Represent field line number or field item number
field_type Refer AD Result.dtd for field attribute Type
field_value Cleansed field output

Return Code:
negative for error, 0 for success

addr_get_field_idx
Description:
Use this function to retrieve a parsed or validated field. The suggestion_idx specifies the suggestion from which to select the field value. (0 for parsed data, 1..n for validated data, where n is the
n_suggest parameter returned by ids_addr_validate).

Prototype:
using s s a ;
public byte [ ] a d d r _ g e t _ f i e l d _ i d x (
int
suggest_idx ,
/ / Long i n
int
field_idx
/ / Long i n
);

Parameters:
suggest_idx Specifies the nth suggestion from which to get a field. On successful parse, use 0 for
ASM/AD version 4, 1 for ASM/AD version 5
field_idx Specifies a field within the nth suggestion
field_value The field value

Return Code:
negative for error, 0 for success

addr_get_field_info_ext
Description:
Use this function to retrieve a list of individual field lengths after validating an address. Fields with a
length of zero have no value associated with them and can be omitted from the list of fields retrieved
with ids_addr_get_field_idx
addr_get_field_idx

174

Prototype:
using s s a ;
public s t r u c t a d d r _ g e t _ f i e l d _ i n f o _ e x t _ s t r u c t a d d r _ g e t _ f i e l d _ i n f o _ e x t (
int
suggest_idx
/ / Long i n
);

Parameters:
suggest_idx Specifies the suggestion from which to retrieve information
field_length An array containing the length of each address field
addr_label_encoded The returned label
addr_label_charset The character set used in the address label
score The returned labels score

Return Code:
negative for error, 0 for success

addr_get_field_len
Description:
This function returns the maximum length of an individual address field. It may be used to dynamically
allocate the field parameter used for the ids_addr_get_field_idx API.

Prototype:
using s s a ;
public i n t a d d r _ g e t _ f i e l d _ l e n ( ) ;

Parameters:
max_len Returns the max address field length in bytes

Return Code:
negative for error, 0 for success

addr_get_line_len
Description:
This function returns the maximum length of an input address line. It may be used to dynamically
allocate the input lines used for the ids_addr_set_lines API.
175

CALLING FROM C#

Prototype:
using s s a ;
public i n t a d d r _ g e t _ l i n e _ l e n ( ) ;

Parameters:
max_len Returns the max line length in bytes

Return Code:
negative for error, 0 for success

addr_get_option
Description:
Use this function to obtain values of options that control Address Standardization behavior. A list of
options appears in the Address Standardization section of this manual.

Prototype:
using s s a ;
public s t r i n g a d d r _ g e t _ o p t i o n (
s t r i n g param
/ / String in
);

Parameters:
param This field specifies the name of the option to get.
value Returns the value of the option.

Return Code:
negative for error, 0 for success

addr_info
Description:
Use this function to request additional information about an input address. This call must always be
preceded with a call to ids_addr_std.
addr_get_option

176

Prototype:
using s s a ;
public s t r i n g a d d r _ i n f o (
string controls
);

/ / String in

Parameters:
controls this field contains the request information. It must me specified in the form ITEM=[value].
value this field contains the requested information.

Return Code:
negative for error, 0 for success

addr_init
Description:
This function initializes the Address Standardization sub-system. It must be the first call to
ids_addr_* family of functions. The max_memory parameter specifies the maximum amount of
memory (MB) to be used by the Address Standardization engine (within the Search Server process).

Prototype:
using s s a ;
public void a d d r _ i n i t (
int
max_memory
);

/ / Long i n

Parameters:
max_memory This field specifies the maximum amount of memory (MB) to be used by the Address
Standardization engine.

Return Code:
negative for error, 0 for success

addr_parse
Description:
Use this function to parse an address. The individual field lengths after parsing an address are returned
in the field_length array. Fields with a length of zero have no value associated with them and can be
omitted from the list of fields retrieved with ids_addr_get_field_idx
177

CALLING FROM C#

Prototype:
using s s a ;
public i n t [ ] addr_parse ( ) ;

Parameters:
field_length An array containing the length of each parsed field

Return Code:
negative for error, 0 for success

addr_preload_country
Description:
Use this function to preload country database

Prototype:
using s s a ;
public void addr_preload_country (
s t r i n g preload_type ,
/ / String in
s t r i n g preload_country , / / S t r i n g i n
s t r i n g val_mode
/ / String in
);

Parameters:
preload_type Type of preload to perform
preload_country Country database to be preloaded
val_mode Validation mode to be used

Return Code:
negative for error, 0 for success

addr_set_attrib
Description:
Use this function to specify the character set of the data (for both input and output). The default_country parameter specifies that default country to use when parsing cannot identify a country
from the address. This API must be called prior to parsing or validating an address. The values stay in
effect for the life of the session, or until they are changed.
addr_preload_country

178

Prototype:
using s s a ;
public void a d d r _ s e t _ a t t r i b (
string char_set ,
/ / String in
string default_country / / String in
);

Parameters:
char_set The name of the character set used to encode the input and output.
default_country The default country used for validation when parsing cannot detect a country
name.

Return Code:
negative for error, 0 for success

addr_set_del_lines
Description:
Use this function to set delivery address line information

Prototype:
using s s a ;
public void a d d r _ s e t _ d e l _ l i n e s (
byte [ ] d e l _ l i n e 1 ,
/ / Block
byte [ ] d e l _ l i n e 2 ,
/ / Block
byte [ ] d e l _ l i n e 3 ,
/ / Block
byte [ ] d e l _ l i n e 4 ,
/ / Block
byte [ ] d e l _ l i n e 5 ,
/ / Block
byte [ ] d e l _ l i n e 6
/ / Block
);

Parameters:
del_line1 delivery address line 1 input string
del_line2 delivery address line 2 input string
del_line3 delivery address line 3 input string
del_line4 delivery address line 4 input string
del_line5 delivery address line 5 input string
del_line6 delivery address line 6 input string

Return Code:
negative for error, 0 for success
179

CALLING FROM C#

in
in
in
in
in
in

addr_set_field_case
Description:
Use this function to set individual input fields case option

Prototype:
using s s a ;
public void a d d r _ s e t _ f i e l d _ c a s e (
int
field_idx ,
/ / Long i n
int
field_case
/ / Long i n
);

Parameters:
field_idx Specifies the nth field to set
field_case Specifies output field case option value. The allowed values are 0 = Unchanged, 1 =
Upper case, 2 = Lower case and 3 = Mixed case.

Return Code:
negative for error, 0 for success

addr_set_field_ext
Description:
Use this function to set fields

Prototype:
using s s a ;
public void a d d r _ s e t _ f i e l d _ e x t (
int
f i e l d _ o p e r a t i o n , / / Long i n
s t r i n g field_name ,
/ / String in
int
f i e l d _ i t e m _ l i n e , / / Long i n
string field_type ,
/ / String in
byte [ ] f i e l d _ v a l u e
/ / Block in
);

Parameters:
field_operation Field operation Option 0 for AddressElements Option 1 for AddressLines
field_name Refer AD Result.dtd for field names
field_item_line Represent field line number or field item number
field_type Refer AD Result.dtd for field attribute Type
field_value input field value
addr_set_field_case

180

Return Code:
negative for error, 0 for success

addr_set_field_idx
Description:
Use this function to specify the value of an input field. This API is used to specify an input address that
has already been pre-parsed into separate fields.

Prototype:
using s s a ;
public void a d d r _ s e t _ f i e l d _ i d x (
int
field_idx ,
/ / Long i n
byte [ ] f i e l d _ v a l u e
/ / Block in
);

Parameters:
field_idx Specifies the nth field to set
field_value Specifies a value for the nth field

Return Code:
negative for error, 0 for success

addr_set_field_name
Description:
Use this function to set individual input fields by name

Prototype:
using s s a ;
public void a d d r _ s e t _ f i e l d _ n a m e (
s t r i n g field_name ,
/ / String in
byte [ ] f i e l d _ v a l u e
/ / Block in
);

Parameters:
field_name Specifies the name of the field to set
field_value Specifies a value for the field
181

CALLING FROM C#

Return Code:
negative for error, 0 for success

addr_set_lines
Description:
Use this function to specify the value of an input field. This API is used to specify an input address that
has already been pre-parsed into separate fields.

Prototype:
using s s a ;
public void a d d r _ s e t _ l i n e s (
byte [ ] l i n e _ 1 ,
byte [ ] l i n e _ 2 ,
byte [ ] l i n e _ 3 ,
byte [ ] l i n e _ 4 ,
byte [ ] l i n e _ 5 ,
byte [ ] l i n e _ 6 ,
byte [ ] l i n e _ 7 ,
byte [ ] l i n e _ 8 ,
byte [ ] l i n e _ 9 ,
byte [ ] l i n e _ 1 0
);

//
//
//
//
//
//
//
//
//
//

Block
Block
Block
Block
Block
Block
Block
Block
Block
Block

in
in
in
in
in
in
in
in
in
in

Parameters:
line_1 The first line of the address
line_2 The second line of the address
line_3 The third line of the address
line_4 The fourth line of the address
line_5 The fifth line of the address
line_6 The sixth line of the address
line_7 The seventh line of the address
line_8 The eighth line of the address
line_9 The ninth line of the address
line_10 The tenth line of the address

Return Code:
negative for error, 0 for success
addr_set_lines

182

addr_set_option
Description:
Use this function to set values of options that control Address Standardization behavior. A list of
options appears in the Address Standardization section of this manual.

Prototype:
using s s a ;
public void a d d r _ s e t _ o p t i o n (
s t r i n g param ,
s t r i n g value
);

/ / String in
/ / String in

Parameters:
param This field specifies the name of the option to set.
value This field specifies a value for the option.

Return Code:
negative for error, 0 for success

addr_std
Description:
Use this function to request IDS to standardize an address by validating it against USPS validation
tables and formatting it to comply with U.S. Postal Addressing Standards. This API requires the separately licensable IDS Address Standardization Module to be installed.

Prototype:
using s s a ;
public void
ref
ref
ref
ref
ref
);

addr_std (
s t r i n g firm_name ,
string urbanization ,
s t r i n g address_one ,
s t r i n g address_two ,
string last_line

//
//
//
//
//

String
String
String
String
String

io
io
io
io
io

Parameters:
firm_name It contains the name of the firm (may be blank).
urbanization this field can contain name of an urban development within a geographic area. It is
only used with Puerto Rican addresses.
183

CALLING FROM C#

address_one this field contains the Delivery Address Line. It normally consists of a street number,
pre-directional, street name, street suffix, post-directional and possibly some secondary address components such as apartment number.
address_two this field contains additional Delivery Address Line components. It is normally only
used when address_one is very long.
last_line this field contains the Last Line information: the city name, state abbreviation and zip
code (and possibly the Zip + 4 code).

Return Code:
0 indicates an exact match to a valid address
1 indicates a no match (invalid address)
2 indicates a multi match (non-unique address), and
< 0 indicates an error

addr_validate
Description:
Use this function to validate an address

Prototype:
using s s a ;
public s t r u c t a d d r _ v a l i d a t e _ s t r u c t a d d r _ v a l i d a t e ( ) ;

Parameters:
status The status returned by the validation process
n_suggest The number of suggestions generated by validation

Return Code:
negative for error, 0 for success

disconnect
Description:
Releases resources allocated to a socket.
addr_validate

184

Prototype:
using s s a ;
public void d i s c o n n e c t ( ) ;

Parameters:
none

Return Code:
negative for error, 0 for success

error_get
Description:
Get the error messages from the last API function that failed. This function should be called repeatedly
until it returns 1, meaning all messages have been retrieved.
Note: if a communication (socket) error occurred, this function will also fail. Refer to the
O PERATIONS M ANUAL, Error Log section for help in interpreting the Error Log.

Prototype:
using s s a ;
public s t r i n g e r r o r _ g e t ( ) ;

Parameters:
msg is the error message returned

Return Code:
0 for success, -ve for error and 1 for no more errors to retrieve.

errors_get_all
Description:
Get the Server side error messages from the last API function that failed. This function should be called
repeatedly until it returns 1, meaning all messages have been retrieved.
Note: if a communication (socket) error occurred, this function will also fail. Refer to the
O PERATIONS M ANUAL, Error Log section for information on interpreting the Error Log.

185

CALLING FROM C#

Prototype:
using s s a ;
public s t r i n g e r r o r s _ g e t _ a l l ( ) ;

Parameters:
msg is an error message.

Return Code:
negative for error, 0 for success

identify
Description:
Identify a session to the console

Prototype:
using s s a ;
public void i d e n t i f y (
string
identification
);

/ / String in

Parameters:
identification is user supplied identitification for display on the console

Return Code:
negative for error, 0 for success

is_little_endian
Description:
Checks if the search server is running on a little endian platform

Prototype:
using s s a ;
public i n t i s _ l i t t l e _ e n d i a n ( ) ;

Parameters:
endian_state Returns 1 if the search server is running on a little endian platform. Returns 0 for
others
identify

186

Return Code:
negative for error, 0 for success

match_explain
Description:
Explains the match result given search and file records As match_explain_count does not give the exact
number of output rows for this call, but instead provides a maximal estimate, some of the info blocks
returned will be filled with NULL bytes. Test a block for validity by checking the first byte is not NULL.
Info blocks returned are not all the same length either. They are NULL filled on the right.

Prototype:
using s s a ;
public byte [ ] [ ]
string
string
byte [ ]
byte [ ]
);

match_explain (
search ,
/ / String in
match_tolerance , / / S t r i n g in
searchrec ,
/ / Block in
filerec
/ / Block in

Parameters:
search is the name of the Search which was performed.
match_tolerance specifies either Conservative, Typical or Loose to nominate how aggressive
the matching scheme should be in rejecting candidates.
searchrec is the IDT record used to search with. It is returned by the Search Server.
filerec is the record to be matched agains the searchrec
info_array An array describing the match results. See the Match Explain API section for details

Return Code:
negative for error, 0 for success

match_explain_count
Description:
Estimate number of info blocks required for a subsequent match_explain call

Prototype:
187

CALLING FROM C#

using s s a ;
public i n t match_explain_count (
string search
/ / String in
);

Parameters:
search is the name of the Search which was performed.
count Returns the maximum number of info blocks required to explain the search results

Return Code:
negative for error, 0 for success

pid_close
Description:
Closes resources opened with the ids_pid_open call.

Prototype:
using s s a ;
public void p i d _ c l o s e ( ) ;

Parameters:
none

Return Code:
negative for error, 0 for success

pid_member_count
Description:
Retrieve the number of member records in a cluster

Prototype:
using s s a ;
public i n t pid_member_count (
byte [ ] p r e f i x ,
int
cluster_num
);

/ / Block in
/ / Long i n

pid_close

188

Parameters:
prefix is the persistent ID prefix for the cluster to look up.
cluster_num is the cluster number for the cluster to look up.
count the number of member records found for the cluster

Return Code:
negative for error, 0 for success

pid_member_get
Description:
Called after ids_pid_member_count in a consecutive manner to retrieve the member records for a
cluster.

Prototype:
using s s a ;
public s t r u c t pid_member_get_struct pid_member_get (
byte [ ] p r e f i x ,
/ / Block in
int
cluster_num
/ / Long i n
);

Parameters:
prefix is the persistent ID prefix for the cluster.
cluster_num cluster_num is the cluster number for the cluster.
record the member record in IDT layout.
recid is rhe Rescord-Id for the member record (corresponding to the RECID column from the IDT)

Return Code:
negative for error, 0 for success, and 1 for "end of set".

pid_open
Description:
Open resources for use with Persistent-ID.
189

CALLING FROM C#

Prototype:
using s s a ;
public void pid_open (
string multi_search
);

/ / String in

Parameters:
multi_search is the name of a multi-search which uses Persistent-ID. This function requires a prior
call to ids_system_open.

Return Code:
negative for error, 0 for success

pid_search_get
Description:
Retrieve Preferred records which are a good match for the search record specified in the
ids_search_start or ids_system_search_start function. This function will return extended
matching information, including the match decision and the file (IDT) record-ID of the matching
records.

Prototype:
using s s a ;
public s t r u c t p i d _ s e a r c h _ g e t _ s t r u c t p i d _ s e a r c h _ g e t (
string search
/ / String in
);

Parameters:
search is the name of the Search which was performed.
file_rec is the matched File record.
score is the degree of similarity between the Search and File records (0-100).
decision is the match decision: A(ccept) or U(ndecided)
file_recid is the File Record-ID (corresponding to the RECID column from the IDT).
cluster_count is the number of clusters asociated with the cluster.

Return Code:
negative for error, 0 for success, and 1 for "end of set".
pid_search_get

190

pid_search_get_clusters
Description:
May be called after each call to ids_pid_search_get to retrieve the clusters associated with the
preferred record.

Prototype:
using s s a ;
public s t r u c t p i d _ s e a r c h _ g e t _ c l u s t e r s _ s t r u c t p i d _ s e a r c h _ g e t _ c l u s t e r s (
s t r i n g search ,
/ / String in
int
file_recid
/ / Long i n
);

Parameters:
search is the name of the Search which was performed.
file_recid is the Preferred Record-ID (corresponding to the RECID column from the IDT).
prefixs is the prefix for the associated cluster
cluster_nums is the number for the asociated cluster

Return Code:
negative for error, 0 for success

pid_src_pk_get
Description:
Get persistent ids one at a time

Prototype:
using s s a ;
public byte [ ] [ ] p i d _ s r c _ p k _ g e t ( ) ;

Parameters:
src_pk_value the values of primary keys from the source table

Return Code:
negative for error, 0 for success
191

CALLING FROM C#

pid_src_pk_start
Description:
Search for persistent ids

Prototype:
using s s a ;
public void p i d _ s r c _ p k _ s t a r t (
string multi_search ,
byte [ ] [ [ ] src_pk
);

/ / String in
/ / BlockArray in

Parameters:
multi_search the name of the multi-search
src_pk the values of primary keys from the source table

Return Code:
negative for error, 0 for success

ps_get_entity_list
Description:
Retrieves entity names supported by the current population

Prototype:
using s s a ;
public s t r u c t p s _ g e t _ e n t i t y _ l i s t _ s t r u c t p s _ g e t _ e n t i t y _ l i s t ( ) ;

Parameters:
gross_names List of Gross entity names
fine_names List of Fine entity names

Return Code:
negative for error, 0 for success

ps_get_entity_max_elements
Description:
Retrieves number of entity array elements
pid_src_pk_start

192

Prototype:
using s s a ;
public i n t p s _ g e t _ e n t i t y _ m a x _ e l e m e n t s (
s t r i n g type
/ / String in
);

Parameters:
type Type of entity: Input, Gross, Fine, Standard, Format
elements maximum number of occurrences

Return Code:
negative for error, 0 for success

ps_get_entity_max_length
Description:
Retrieves maximum length of an entity value

Prototype:
using s s a ;
public i n t p s _ g e t _ e n t i t y _ m a x _ l e n g t h (
s t r i n g type
/ / String in
);

Parameters:
type Type of entity: Input, Gross, Fine, Standard, Format
length maximum length (bytes) of an entity value

Return Code:
negative for error, 0 for success

ps_parse
Description:
Parse, Standardize and Format API
193

CALLING FROM C#

Prototype:
using s s a ;
public byte [ ] [ ] ps_parse (
st ri ng operation ,
byte [ ] input ,
r e f byte [ ] [ ] gross ,
r e f byte [ ] [ ] f i n e ,
r e f byte [ ] [ ] standard
);

/ / String in
/ / Block in
/ / BlockArray io
/ / BlockArray io
/ / BlockArray io

Parameters:
operation The operation(s) to perform: G, F, S, M
input Unparsed input string
gross Gross entities used as input or output
fine Fine entities used as input or output
standard Standardized entities used as input or output
ps_format Formatted output string

Return Code:
negative for error, 0 for success

ps_set_encoding
Description:
Defines encoding used for the input/output data

Prototype:
using s s a ;
public void p s _ s e t _ e n c o d i n g (
int
encoding
);

/ / Long i n

Parameters:
encoding 0=Population default, 8=UTF-8, 16=UTF-16

Return Code:
negative for error, 0 for success
ps_set_encoding

194

ps_set_entity_list
Description:
Defines a subset of entities for input/output

Prototype:
using s s a ;
public void p s _ s e t _ e n t i t y _ l i s t (
s t r i n g type ,
/ / String in
string [ ] e n t i t y _ l i s t
/ / StringArray in
);

Parameters:
type Type of entity: Gross or Fine
entity_list List of entity names

Return Code:
negative for error, 0 for success

ps_set_population
Description:
Defines the System and Population used for parsing rules

Prototype:
using s s a ;
public void p s _ s e t _ p o p u l a t i o n (
s t r i n g system ,
/ / String in
s t r i n g population
/ / String in
);

Parameters:
system System Name
population Specifies a Population within the System

Return Code:
negative for error, 0 for success
195

CALLING FROM C#

real_time_async_get
Description:
Used to retrieve the result count associated with a call to ids_real_time_async_start.
cluster_action_count specifies the number of results that are available for collection using
ids_real_time_sync_get.

Prototype:
using s s a ;
public i n t r e a l _ t i m e _ a s y n c _ g e t (
string reference ,
/ / String in
int
block
/ / Long i n
);

Parameters:
reference A
reference
number
ids_real_time_sync_start)

identifying

the

request

(returned

by

block 1 = wait for a response 0 = return immediately if no results are available yet
cluster_action_count The number of clusters generated These can be returned with call to
real_time_sync_get 1 = wait for a response

Return Code:
negative for error 0 for success positive for no results are available yet

real_time_async_start
Description:
Used to start a synchronizer transaction of the Real Time Synchronization server. This call works in an
asynchronous fashion and will return when the transaction has been placed on the servers work queue
rather than when the transaction has been processed. The record passed in must match the layout of
the IDT. This call must be followed by a call to ids_real_time_async_get, then by one or more
calls to ids_real_time_sync_get to retrieve the results.

Prototype:
using s s a ;
public s t r i n g r e a l _ t i m e _ a s y n c _ s t a r t (
string rulebase ,
/ / String in
s t r i n g system ,
/ / String in
s t r i n g IDT ,
/ / String in
s t r i n g sequence_number , / / S t r i n g i n
st ri ng operation ,
/ / String in
byte [ ] c l u s t e r _ r e c o r d , / / B l o c k i n
real_time_async_get

196

int
string
int

source ,
multi_search ,
input_id

/ / Long i n
/ / String in
/ / Long i n

);

Parameters:
rulebase is the name of the rulebase.
system The name of the system in the rulebase
IDT is the name of the IDT associated with the update.
sequence_number is a string that specifies the order of synchronization. Must obey the rules for
sequence numbers found in the O PERATIONS M ANUAL.
operation The synchronizer operation being performed: A for add or D for delete
cluster_record The record to be updated. The record must use the same layout as the IDT.
source Identifies the source of clustering: 0 = Real Time Synchronizer 1 = Flat file 2 = NSA table
multi_search The name of the multi-search which uses Persistent-ID. This parameter should be set
to an empty string for an IDT/IDX only transaction.
input_id The cluster id or record id as appropriate
reference A reference string identifying the request.
ids_real_time_sync_get call when retrieving results.

This must be passed to the

Return Code:
negative for error
0 for success positive for warnings:
1-9 Reserved for future use
10 warnings: Duplicate PK detected on add to IDT with WARN_DUPLICATE_PK sync option.
11 warnings: Duplicate transaction was skipped.
12 warnings: Transaction was rejected because the sequence number was less than or equal to a previous transaction. The record was added to the reject table.

real_time_flul_add
Description:
This API used to add force link and unlink rule.
ids_real_time_flul_init.
197

CALLING FROM C#

This call must be followed by

Prototype:
using s s a ;
public void r e a l _ t i m e _ f l u l _ a d d
string rule_type ,
byte [ ] s u b j e c t _ r e c _ p k ,
string relationship ,
byte [ ] r e l a t e d _ r e c _ p k
);

(
//
//
//
//

String in
Block in
String in
Block in

Parameters:
rule_type This field is for specifying the type of the rule. A value of A represents that the rule needs
to be added to the system and D represents that a rule needs to be removed from the system
subject_rec_pk This field is for specifying the PK of the subject record
relationship This field is for specifying the relationship between the subject record and related
record. A value of L represents a Link rule between the subject record and the related record and a
value of U represents an Unlink rule between the subject record and the related record.
related_rec_pk This field is for specifying the PK of the record that is either linked or unlinked to
the subject record.

Return Code:
negative for error, 0 for success 3 when the Link rule is not allowed. Record unlinked with members of
subject cluster.

real_time_flul_close
Description:
This API used to close and release force link and unlink module.

Prototype:
using s s a ;
public void r e a l _ t i m e _ f l u l _ c l o s e ( ) ;

Parameters:
none

Return Code:
negative for error, 0 for success
real_time_flul_close

198

real_time_flul_delete
Description:
This API used to delete force link and unlink rule from MR table. This call must be followed by
ids_real_time_flul_init.

Prototype:
using s s a ;
public void r e a l _ t i m e _ f l u l _ d e l e t e (
int
r u l e _ t y p e _ o p t i o n , / / Long i n
byte [ ] record_pk
/ / Block in
);

Parameters:
rule_type_option

0 Delete only disabled rules for input pk.

1 Delete only active rules for input pk.


2 Delete all rules for input pk.
record_pk This field is for specifying the PK of the record to be deleted

Return Code:
negative for error, 0 for success

real_time_flul_find_rule
Description:
This API used to find link and unlink information for input IDT record. should be called after
ids_real_time_flul_init API.

Prototype:
using s s a ;
public void r e a l _ t i m e _ f l u l _ f i n d _ r u l e (
byte [ ] i d t _ r e c ,
/ / Block in
int
option
/ / Long i n
);

Parameters:
idt_rec This field is for specifying the PK of the record to be searched
option

0 Link Rule.

1 Unlink Rule.
199

CALLING FROM C#

Return Code:
negative for error, 0 for success

real_time_flul_get_rule
Description:
This API used fetch link and unlink information for input IDT record.
ids_real_time_flul_find_rule API.

Should be called after

Prototype:
using s s a ;
public byte [ ] r e a l _ t i m e _ f l u l _ g e t _ r u l e ( ) ;

Parameters:
idt_rec is the matched File record for input link or unlink rule.

Return Code:
negative for error, 0 for success

real_time_flul_init
Description:
This API used to initialize force link and unlink module.
Memory allocated a part of
ids_real_time_flul_init is released using ids_real_time_flul_close.

Prototype:
using s s a ;
public void r e a l _ t i m e _ f l u l _ i n i t (
s t r i n g idt_name ,
/ / String in
string multi_search
/ / String in
);

Parameters:
idt_name is the name of the IDT associated with the force link and unlink rule.
multi_search The name of the multi-search which uses Persistent-ID. This parameter should be set
to an empty string for an IDT only MR rule creation.
real_time_flul_get_rule

200

Return Code:
negative for error, 0 for success

real_time_sync_get
Description:
Use to retrieve the results and free the resources associated with a call to
ids_real_time_sync_start or ids_real_time_async_start. Should be called until it
returns a non zero response.

Prototype:
using s s a ;
public s t r u c t r e a l _ t i m e _ s y n c _ g e t _ s t r u c t r e a l _ t i m e _ s y n c _ g e t (
string reference
/ / String in
);

Parameters:
reference A reference string identifying the request.
ids_real_time_sync_get call when retriving results.

This must be passed to the

cluster_action_type Identifies the action, ie add or delete


cluster_action_id The prefix which identifies the cluster
cluster_action_number The number which identifies the cluster
cluster_action_new Identifies whether the cluster is newly formed or existing

Return Code:
negative for error, 0 for success, 1 for end of results

real_time_sync_start
Description:
Used to start a synchronizer transaction of the Real Time Synchronization server. This call works
in a synchronous fashion returning only when the transaction has been processed. The record
passed in must match the layout of the IDT. This call must be followed by one or more calls to
ids_real_time_sync_get to retrieve results.

Prototype:
201

CALLING FROM C#

using s s a ;
public s t r u c t r e a l _ t i m e _ s y n c _ s t a r t _ s t r u c t r e a l _ t i m e _ s y n c _ s t a r t (
string rulebase ,
/ / String in
s t r i n g system ,
/ / String in
s t r i n g IDT ,
/ / String in
s t r i n g sequence_number , / / S t r i n g i n
st ri ng operation ,
/ / String in
byte [ ] c l u s t e r _ r e c o r d
/ / Block in
);

Parameters:
rulebase is the name of the rulebase.
system The name of the system in the rulebase
IDT is the name of the IDT associated with the update.
sequence_number is a string that specifies the order of synchronization. Must obey the rules for
sequence numbers found in the O PERATIONS M ANUAL.
operation The synchronizer operation being performed: A for add or D for delete
cluster_record The record to be updated. The record must use the same layout as the IDT.
cluster_action_count The number of clusters generated. For IDT/IDX only processing this parameter will always be 0. These can be returned with ids_real_time_sync_get
reference A reference string identifying the request.
ids_real_time_sync_get call when retriving results.

This must be passed to the

Return Code:
negative for error
0 for success, and postive for warnings:
1-9 Reserved for future use
10 warning: Duplicate PK detected on add to IDT with WARN_DUPLICATE_PK sync option.
11 warning: Transaction was skipped.
12 warning: Transaction was reject because the sequence number was lessa than or equal to a previous
transaction. The record was added to the reject table.
13 warning: Transaction became a No Op. e.g. Add followed by delete in the same commit cycle
equates to do nothing.
14 warning: Force server shutdown in progress.
15 warning: Could not perform delete as the IDT record was not found. This will normally trigger
error unless the appropriate option is set in the syncronization server configuration.
real_time_sync_start

202

scores_get
Description:
Retrieve an array of scores, one per match record. This API is used in conjunction with ids_search_start
when candidate records to be matched are provided by the caller. The records and their scores may be
retrieved either by repeatedly calling ids_search_get or by calling this function to retrieve all scores at
once. A limit of 1024 scores may be returned in a single call. When using this function, please ensure
that an Accept limit of 0 has been specified (so that all candidates are returned regardless of their score),
and specify a SORT= parameter in the Search-Definition to ensure that the records remain in the same
order as passed otherwise they will be sorted by descending score. This is perhaps best achieved by
inserting a record number in each row and sorting by that field. The size of the scores array must be
equal to the number of input records to be matched, and may not exceed 1024.

Prototype:
using s s a ;
public i n t [ ] s c o r e s _ g e t (
s t r i n g searchname
);

/ / String in

Parameters:
searchname is the name of the associated search
scores is an array of scores, one per candidate record

Return Code:
negative for error, 0 for success

search_comment_get
Description:
Returns the user defined comment stored with the search.

Prototype:
using s s a ;
public s t r i n g search_comment_get (
s t r i n g searchname
/ / String in
);

Parameters:
searchname the search to count.
comment is the area to copy the string containing the comment. This string will be null-terminated.
203

CALLING FROM C#

Return Code:
negative for error, 0 for success

search_dedupe_start
Description:
Search for duplicate records in the IDT. Refer to the Dup Finder section in this manual for details.

Prototype:
using s s a ;
public void s e a r c h _ d e d u p e _ s t a r t
s t r i n g search ,
s t r i n g search_width ,
s t r i n g match_tolerance ,
byte [ ] [ [ ] parameters ,
r e f byte [ ] s e a r c h r e c ,
s t r i n g AnswersetName ,
int
flags ,
ref int recid ,
ref int recs
);

(
/ / String in
/ / String in
/ / String in
/ / BlockArray in
/ / Block io
/ / String in
/ / Long i n
/ / Long i o
/ / Long i o

Parameters:
search is the name of the search that is to be performed.
search_width specifies either Narrow, Typical or Exhaustive to nominate how many candidates should be selected.
match_tolerance specifies either Conservative, Typical or Loose to nominate how aggressive
the matching scheme should be in rejecting candidates.
parameters not used.
searchrec is the IDT record used to search with. It is returned by the Search Server.
AnswersetName is used store the search results in an AnswerSet. The Answerset is used to identify
the Search results in the table and is constructed by concatenating the AnswersetName parameter with
the Search-Record-Id (10 bytes) . The maximum AnswersetName length is 22 characters. If you do not
wish to store the search results in an AnswerSet, set AnswersetName to an empty String.
flags flags for specifying options. This field is a bit-field. Valid values are: 2 = return search record
only. 4=remove search record from returned set.
recid the recid of the record to start a searching on. A value of 0 starts searching from the beginning
of the IDT. The returned value is the recid of the next record to be searched.
recs the number of records in the search set.

Return Code:
negative for error, 0 for success, and 1 for truncation of the search set.
search_dedupe_start

204

search_fields_count
Description:
Gets the number of fields required to assemble the search record.

Prototype:
using s s a ;
public i n t s e a r c h _ f i e l d s _ c o u n t (
s t r i n g searchname
/ / String in
);

Parameters:
searchname the search to count.
fc is the number of fields required to be filled in to assemble the search.

Return Code:
negative for error, 0 for success

search_fields_get
Description:
Gets the number of fields required to assemble the search record.

Prototype:
using s s a ;
public s t r i n g [ ] s e a r c h _ f i e l d s _ g e t (
s t r i n g searchname
/ / String in
);

Parameters:
searchname the search to count.
fieldnames is the array returned which will contain the name of the fields.

Return Code:
negative for error, 0 for success
205

CALLING FROM C#

search_filter
Description:
Sets a dynamic SQL filter to be used by a search. Refere to the SQL Filters section of the D ESIGNER
M ANUAL for details about SQL filters

Prototype:
using s s a ;
public void s e a r c h _ f i l t e r (
s t r i n g search ,
string
filter
);

/ / String in
/ / String in

Parameters:
search is the name of the Search that will use the filter
filter is a string containing an SQL expression or values for substituion variables

Return Code:
negative for error, 0 for success

search_finish
Description:
Release resources associated with ids_search_start.

Prototype:
using s s a ;
public void s e a r c h _ f i n i s h (
string search
);

/ / String in

Parameters:
search is the name of the search that was performed

Return Code:
negative for error, 0 for success
search_filter

206

search_get
Description:
Retrieve file records that are a good match for the search record specified in the ids_search_start
or ids_system_search_start function.

Prototype:
using s s a ;
public s t r u c t s e a r c h _ g e t _ s t r u c t s e a r c h _ g e t (
s t r i n g searchname
/ / String in
);

Parameters:
searchname is the name the search to used by the call.
searchreturn is an area into which a string from the set is copied.
score is the score calculated for the string.
sreps is an array of the ordinal values of the repeating fields in the search record that were used in
the match.
Note: sreps and freps are only meaningful when using SSA-NAME3 v1, the SEQUENCES
option has been set in the Search-Definition, and the search and file records contain repeating
groups

freps is an array of the ordinal values of the repeating fields in the file record that were used in the
match.
For example, a record structure with a repeating name (2 fields) and a repeating address (2
fields) , if the first name field in the search record matched the second name field in the file
record while the first address field of the source matched the first address field of the file; the
contents of these two arrays would be; sreps[0] = 0, srep[1] = 0, freps[0] = 1, frep[1] = 0

Return Code:
negative for error, 0 for success, and 1 for "end of set".

search_get_complete
Description:
Retrieve file records which are a good match for the search record specified in the ids_search_start
or ids_system_search_start function. This function will return extended matching information
in the info field as long as the Search-Definition specifies the SEQUENCES option, and SSA-NAME3
v1 is used.
207

CALLING FROM C#

Prototype:
using s s a ;
public s t r u c t s e a r c h _ g e t _ c o m p l e t e _ s t r u c t s e a r c h _ g e t _ c o m p l e t e (
string search
/ / String in
);

Parameters:
search is the name of the search which was performed.
searchreturn is an area into which a string from the set is copied.
score is the score calculated for the string.
info an encoded list of values used to determine which occurrence of a repeating field matched the
value in the search record. The info field has a length of 4*(1+3*100) bytes. It contains 4 groups, each
one representing the result from one of the four possible scoring phases: Key-Pre-Score, Key-Score,
Pre-Score and Score respectively. If a phase was used, its data starts with a 1, otherwise 0 if the phase
was not used. The indicator is followed by 100 three-digit numbers, one each for each method in the
scoring-scheme for this phase, up to a limit of 100 methods per scheme (scoring phase). The three-digit
number is an index (base 1) representing the occurrence in the file record that was the best match for
the data in the search record.

Return Code:
negative for error, 0 for success, and 1 for "end of set".

search_get_detail
Description:
Retrieve file records which are a good match for the search record specified in the ids_search_start
or ids_system_search_start function. This function will return extended matching information,
including the match decision and the file (IDT) record-ID of the matching records.

Prototype:
using s s a ;
public s t r u c t s e a r c h _ g e t _ d e t a i l _ s t r u c t s e a r c h _ g e t _ d e t a i l (
string search
/ / String in
);

Parameters:
search is the name of the Search which was performed.
file_rec is the matched File record.
score is the degree of similarity between the Search and File records (0-100).
decision is the match decision: A(ccept) or U(ndecided)
file_recid is the File Record-ID (corresponding to the RECID column from the IDT).
search_get_detail

208

Return Code:
negative for error, 0 for success, and 1 for "end of set".

search_IDT_get
Description:
Gets the name of the IDT associated with the search.

Prototype:
using s s a ;
public s t r i n g search_IDT_get (
s t r i n g searchname
);

/ / String in

Parameters:
searchname is the name the search to used by the call.
IDT is the area into which the IDT name will be copied

Return Code:
negative for error, 0 for success

search_layout
Description:
Get the names and descriptions of the fields in the current input or output view. If no view has been
defined, the IDT layout will be returned.

Prototype:
using s s a ;
public s t r u c t s e a r c h _ l a y o u t _ s t r u c t
s t r i n g search ,
//
s t r i n g viewType ,
//
s t r i n g func
//
);

search_layout (
String in
String in
String in

Parameters:
search is the name of the Search which was performed.
viewType the type of view: input or output.
209

CALLING FROM C#

func describes the order of fields.


names is the area into which an array containing the fieldnames will be copied.
lengths is the area into which an array containing the lengths of the fields will be copied.
offsets is the area into which an array containing the offsets of the fields will be copied.
repeats is the area into which an array containing the number of repeats in a field will be copied.
formats is the area into which an array containing the format a field will be copied. The format of a
fields is a 50 character string in the following format:
Character 0:

Justification (Left or Right)

Character 1:

Compression (Fixed, Variable or Long)

Characters2 - 3:

Fill (2 characters containing the fill character in hexadecimal)

Character 4:

Fill type (Text or Binary)

Characters 5 - 6:

Base (2 characters containing the base in decimal)

Character 7:

Format (Text, Numeric, Variable or Binary)

Character 8 - 9:

Reserved

Characters 10 - 11:

Binary key number (2 hexadecimal digits)

Character 12:

Character width (Wide, Narrow)

Characters 13 - 50:

Reserved

Note: It is recommended that the FORMATS_SIZE constant be used to prevent errors from
undersized strings.

Return Code:
negative for error, 0 for success

search_start
Description:
Performs a search using a pre-constructed search-record (searchrec). Alternatively you can supply
fields (parameters) and have ids_search_start construct the record. The order of the field values
in parameters should be the same as that returned by ids_search_fields_get. You can either search the
database or search against a supplied list of records (records). There is a limit of 64K bytes of data that
can be sent to the Server. If the supplied list of records is too large, split it into smaller groups and make
multiple calls.
Note: The first search for a given System incurs an additional overhead to allocate database
resources and access the Rulebase. Switching between searches on a particular connection
is equivalent to starting a new search and therefore incurs some overhead. Applications requiring the best possible search performance should be designed to avoid switching between
searches. The easiest way to do this is to use separate (dedicated) connections for each Search.

search_start

210

Prototype:
using s s a ;
public i n t s e a r c h _ s t a r t (
s t r i n g search ,
//
s t r i n g search_width ,
//
s t r i n g match_tolerance , / /
byte [ ] [ [ ] parameters ,
r e f byte [ ] s e a r c h r e c ,
s t r i n g AnswersetName ,
//
byte [ ] [ [ ] r e c o r d s
);

String in
String in
String in
/ / BlockArray in
/ / Block io
String in
/ / BlockArray in

Parameters:
search is the name of the search to be performed.
search_width specifies either Narrow, Typical or Exhaustive to nominate how many candidates should be selected. If left blank, the Search_Level in the Controls will be used.
match_tolerance specifies either Conservative, Typical or Loose to nominate how aggressive
the matching scheme should be in rejecting candidates. If left blank, the Match_Level in the Controls
will be used.
parameters contains the field values used to construct a search record (searchrec). The order
of the field values must correspond to the order of fields returned by ids_search_fields_get. If
insufficient fields are supplied, the remaining fields in the constructed search record will be blank filled.
searchrec is the record that we will search on (in IDT format, or the input view if specified). If
searchrec is specified it will be used to search (provided no parameters are supplied). Alternatively if parameters are specified then the search will be on a record constructed on those parameters
and returned to the user.
AnswersetName is used store the search results in an AnswerSet. AnswersetName is used to identify
the Search results in the table. The maximum AnswersetName length is 32 characters. If you do not
wish to store the search results in an AnswerSet, set AnswersetName to an empty String.
recs number of records that matched the search criteria. The count reflects the number of records
prior to sorting the result set. If the sort uses the Unique_Keys option to remove duplicates, the
resulting set may contain less than recs records. In this case, you must use the response code from
ids_search_get to determine when the end of set has been reached.
records contains a list of records to search on. If you wish to search on the database then specify this
as containing 0 records.

Return Code:
negative for error, 0 for success, and 1 for truncation of the search set, and 2 for exceeding
SEARCH_LIMIT

search_tolerances_count
Description:
Returns the match tolerances count that have for the search. The match tolerance defines how aggressively the matching scheme should be in rejecting candidates.
211

CALLING FROM C#

Prototype:
using s s a ;
public i n t s e a r c h _ t o l e r a n c e s _ c o u n t (
s t r i n g searchname
/ / String in
);

Parameters:
searchname is the name the search to used by the call.
count is the number of widths for the search by the call.

Return Code:
negative for error, 0 for success

search_tolerances_get
Description:
Returns the match tolerances that have been defined for the search. The match tolerance defines how
aggressively the matching scheme should be in rejecting candidates.

Prototype:
using s s a ;
public s t r i n g [ ] s e a r c h _ t o l e r a n c e s _ g e t (
s t r i n g searchname
/ / String in
);

Parameters:
searchname the search to count.
tolerances is the list of null terminated strings returned by the call.

Return Code:
negative for error, 0 for success

search_view_get
Description:
Returns the name of the current input or output view, together with information about the
view: view_field_count is needed to dynamically allocate the arrays used for calls to
ids_search_layout and view_length is used to dynamically allocate memory for input/output
records.
search_tolerances_get

212

Prototype:
using s s a ;
public s t r u c t s e a r c h _ v i e w _ g e t _ s t r u c t s e a r c h _ v i e w _ g e t (
s t r i n g search ,
/ / String in
s t r i n g viewType
/ / String in
);

Parameters:
search is the name of the Search
viewType the type of the view (input or output)
viewName is the name of the view to query
viewFieldCount the number of fields in the view
viewRecLen is the length of the view

Return Code:
negative for error, 0 for success

search_view_set
Description:
Sets a view as the active input or output view

Prototype:
using s s a ;
public void s e a r c h _ v i e w _ s e t (
s t r i n g search ,
s t r i n g viewType ,
s t r i n g viewName
);

/ / String in
/ / String in
/ / String in

Parameters:
search is the name of the Search
viewType the type of the view (input or output)
viewName the name of the view to use

Return Code:
negative for error, 0 for success
213

CALLING FROM C#

search_widths_count
Description:
Returns the count of search widths that have been defined for the search. The search width defines how
many items are selected by the search

Prototype:
using s s a ;
public i n t se arc h_w id ths _co unt (
s t r i n g searchname
/ / String in
);

Parameters:
searchname is the name the search to used by the call.
count is the number of widths for the search by the call.

Return Code:
negative for error, 0 for success

search_widths_get
Description:
Returns the search widths that have been defined for the search. The search width defines how many
items are selected by the search

Prototype:
using s s a ;
public s t r i n g [ ] s e a r c h _ w i d t h s _ g e t (
s t r i n g searchname
/ / String in
);

Parameters:
searchname is the name the search to used by the call.
widths is the list of null terminated strings returned by the call.

Return Code:
negative for error, 0 for success
search_widths_count

214

server_version_get
Description:
Get the version information associated with the server.

Prototype:
using s s a ;
public s t r i n g s e r v e r _ v e r s i o n _ g e t ( ) ;

Parameters:
server_version is the area into which the string containing the version information will be copied.

Return Code:
negative for error, 0 for success

session_close
Description:
Closes the session currently allocated. This will cause the databases kept open by the connection server
to close and prevent the reuse of the session by subsequent calls by ids_session_open.

Prototype:
using s s a ;
public void s e s s i o n _ c l o s e ( ) ;

Parameters:
none

Return Code:
negative for error, 0 for success

session_open
Description:
Allocates resources for a socket. This is an API to the IDS Connection Server. The IDS Connection
Server sits between the client and the IDS Search Server. A session prevents the IDS Search Server
from reopening databases by keeping the databases open between connections. A timeout value can be
specified when starting the IDS Connection Server. If the session has not been reused or closed before
the timeout period it will be closed automatically.
215

CALLING FROM C#

Prototype:
using s s a ;
public void s e s s i o n _ o p e n (
ref int session
);

/ / Long i o

Parameters:
session is the number of the session to open (-1 for a new session).

Return Code:
negative for error, 0 for success

set_encoding
Description:
Informs the Search Server of the encoding used for fields of type W (UNICODE data). ISS stores and
retrieves W fields using an UTF-16 encoding. Search records should use this encoding for W columns
if possible. If they do not, the caller must use this API to inform the Search Server of the alternate
encoding used so that the Server can convert the data prior to using it. The W fields in each record of
the result set will be converted (if necessary) to the callers encoding prior to return. If no encoding is
specified, ISS assumes that the search data matches the file data and no conversion is performed. Refer
to the Globalization section of the O PERATIONS manual for further details and restrictions.

Prototype:
using s s a ;
public void s e t _ e n c o d i n g (
int
encoding
);

/ / Long i n

Parameters:
encoding 6=UTF-16/UCS-2 (LE), 7=UTF-16/UCS-2 (BE), 8=UTF-8, 4=UCS-4

Return Code:
negative for error, 0 for success

set_vpd_user
Description:
Provides the Search Server with information required to set a Virtual Private Database context. Refer
to the D ESIGNER M ANUAL, VPD section for details about VPD.
set_encoding

216

Prototype:
using s s a ;
public void set_vpd_user (
s t r i n g vpd_user ,
s t r i n g vpd_ctx
);

/ / String in
/ / String in

Parameters:
vpd_user Connection string of the actual user
vpd_ctx the name of the PL/SQL context setting package

Return Code:
negative for error, 0 for success

system_close
Description:
closes the system and frees any remaining resources.

Prototype:
using s s a ;
public void s y s t e m _ c l o s e ( ) ;

Parameters:
none

Return Code:
negative for error, 0 for success

system_idtname_count
Description:
Returns the number of active idt names. (i.e. those whose IDT has been loaded).

Prototype:
using s s a ;
public i n t system_idtname_count ( ) ;
217

CALLING FROM C#

Parameters:
idtcount is the number of idtnames defined on the system

Return Code:
negative for error, 0 for success

system_idtname_get
Description:
Get the names of all IDTs that are active. (i.e. those whose IDT has been loaded).

Prototype:
using s s a ;
public s t r i n g [ ] system_idtname_get ( ) ;

Parameters:
idtnames is the area into which an array of the idtnames defined on the rulebase will be copied (the
idtnames are all null terminated strings).

Return Code:
negative for error, 0 for success

system_notify
Description:
Notifies search server on a system.

Prototype:
using s s a ;
public void s y s t e m _ n o t i f y (
string rulebase ,
s t r i n g sysname ,
s t r i n g message
);

/ / String in
/ / String in
/ / String in

Parameters:
rulebase is the name of the rulebase.
sysname is the name of the system
message is a messagevto be delivered
system_idtname_get

218

Return Code:
negative for error, 0 for success

system_open
Description:
opens a system.

Prototype:
using s s a ;
public void system_open (
string rulebase ,
s t r i n g system ,
string verbosity ,
s t r i n g Options
);

//
//
//
//

String
String
String
String

in
in
in
in

Parameters:
rulebase is the name of the rulebase.
system The name of the system in the rulebase
verbosity specifies the verbosity level. See the Verbosity section for details.
Options

LOGOUT filename for server output for this session.

LOGERR filename for server errors for this session.


LOGTEST filename for server search trace for this session.
SHOWALLSEARCHES modifies the behavior of
WORKDIR used to inform the search server as to which directory is to be used as the working directory for this session.

Return Code:
negative for error, 0 for success

system_pid_searches_count
Description:
Gets the number of persistent ID based multi-searches defined on a system.
219

CALLING FROM C#

Prototype:
using s s a ;
public i n t s y s t e m _ p i d _ s e a r c h e s _ c o u n t ( ) ;

Parameters:
searchcount is the number of persistent ID based multi-searches defined on a system

Return Code:
negative for error, 0 for success

system_pid_searches_get
Description:
Get the names of all persistent ID based multi-searches defined in the system

Prototype:
using s s a ;
public s t r u c t s y s t e m _ p i d _ s e a r c h e s _ g e t _ s t r u c t s y s t e m _ p i d _ s e a r c h e s _ g e t ( ) ;

Parameters:
searches is the area into which an array of the persistent ID based multi-searches defined on the
rulebase will be copied (the searches are all null terminated strings).
pid_prefix the area in which the Persistent ID prefix for the searches will be copied
pid_opts the area into which an array containing the Persistent_ID options for each search will be
copied
pref_rec_opts the area into which an array containing the options for the preferred record generation for each search will be copied

Return Code:
negative for error, 0 for success

system_search_finish
Description:
Finishes the search and closes the system.
system_pid_searches_get

220

Prototype:
using s s a ;
public void s y s t e m _ s e a r c h _ f i n i s h ( ) ;

Parameters:
none

Return Code:
negative for error, 0 for success

system_search_start
Description:
Opens a system and constructs and initialises a search using the fields passed to it in parameters. Refer
to ids_search_start for a more detailed description of the parameters.

Prototype:
using s s a ;
public s t r u c t s y s t e m _ s e a r c h _ s t a r t _ s t r u c t s y s t e m _ s e a r c h _ s t a r t (
string rulebase ,
/ / String in
s t r i n g system ,
/ / String in
string verbosity ,
/ / String in
s t r i n g options ,
/ / String in
s t r i n g search ,
/ / String in
byte [ ] [ [ ] parameters ,
/ / BlockArray in
s t r i n g AnswersetName
/ / String in
);

Parameters:
rulebase is the name of the rulebase.
system The name of the system in the rulebase
verbosity specifies the verbosity level. See the Verbosity section for details.
options consists of one or more keywords and their respective values in the form
KEYWORD1=VALUE1,KEYWORD2=VALUE2,
search is the name of the search in the system in the Rulebase that will be used.
parameters is the array which contains the field values to be used to construct the search.
AnswersetName is used store the search results in an AnswerSet. AnswersetName is used to identify
the Search results in the table. The maximum AnswersetName length is 32 characters. If you do not
wish to store the search results in an AnswerSet, set AnswersetName to an empty String.
datalen will return the length of a record.
recs count of records that matched the search criteria
221

CALLING FROM C#

Return Code:
negative for error, 0 for success

system_searches_count
Description:
Returns the number of runnable searches. (i.e. those whose IDX has been loaded). To return the number
of defined searches, add the SHOWALLSEARCHES keyword to the option string of ids_system_open.

Prototype:
using s s a ;
public i n t s y s t e m _ s e a r c h e s _ c o u n t ( ) ;

Parameters:
searchcount is the number of searches defined on the system

Return Code:
negative for error, 0 for success

system_searches_get
Description:
Get the names of all searches that are runnable. (i.e. those whose IDX has been loaded). To return the names of all defined searches, add the SHOWALLSEARCHES keyword to the option string of
ids_system_open.

Prototype:
using s s a ;
public s t r i n g [ ] s y s t e m _ s e a r c h e s _ g e t ( ) ;

Parameters:
searches is the area into which an array of the searches defined on the rulebase will be copied (the
searches are all null terminated strings).

Return Code:
negative for error, 0 for success
system_searches_count

222

systems_count
Description:
the number of systems in the rulebase.

Prototype:
using s s a ;
public i n t systems_count (
string rulebase
);

/ / String in

Parameters:
rulebase is the name of the rulebase.
systemscount the number of systems in the rulebase.

Return Code:
negative for error, 0 for success

systems_get
Description:
Get the names of all the systems defined in the rulebase.

Prototype:
using s s a ;
public s t r i n g [ ] s y s t e m s _ g e t (
string rulebase
);

/ / String in

Parameters:
rulebase is the name of the rulebase.
systems is the area into which an array of the systems defined in the rulebase will be copied (the
systems are all null terminated strings).

Return Code:
negative for error, 0 for success

223

CALLING FROM C#

Calling from Cobol (z/OS)


MDM-RE can be called from MVS Cobol under TSO, batch and/or CICS .
Static calls from Cobol are supported by including the copy book %SSAINC%\ssasecbs.cpy in the
Working-Storage section of a program.
Dynamic calls from Cobol are supported by including the copy books

ssasecbw.cpy in the Working-Storage section, and

ssasecbp.cpy in the Procedure Division.

Two sample programs are provided. idscob1.cob demonstrates calls from TSO/batch and
idscob2.cob is suitable for calls from CICS. These are built using the sample JCL, clcob1.jcl and
clcob2.jcl respectively.
To use MDM-RE from TSO/batch user applications you need to have Language Environment support.
This is required to run Cobol programs compiled with the more recent LE/370 Cobol compilers.
Language Environment and TCP/IP (CICS Sockets) must be installed and enabled in CICS in order to
use the MDM-RE CICS API.

Constants
Constants are declared as variables in Working-Storage, in uppercase using hyphens. Constants are
prefixed with SSA-, eg. SSA-MSG-SIZE.

Installation
Two load dataset files are provided in TSO Transmit format. The following two dataset files are not
part of the standard release package and must be requested from Global Customer Support if required.

ssa.xmit.iss\ssaversion{}.load
ssa.xmit.iss\ssaversion{}.cics.load

These datasets should be transferred to MVS datasets using the TSO Receive facility and named
SSA.MDM-RE9.5.3.LOAD and SSA.MDM-RE9.5.3.CICS.LOAD respectively.

Installation (TSO/batch)
API programs must be linked with a stub called CIC001 in order to resolve the MDM-RE entry points. When using static calls from Cobol, the stub will dynamically load two other modules (SSASEA and SSAIOK) which must be present in the STEPLIB. These modules are found in
SSA.MDM-RE9.5.3.LOAD.
224

Installation (CICS) -static calls


If using static calls, API programs must be linked with a stub called CIC001 in order to resolve the
MDM-RE entry points. When using static calls from Cobol, the stub will dynamically load two other
modules (SSASEA and CSSAIOK) which must be defined to CICS. Note: these modules are different
than those provided for the TSO/batch interface.
To install, add the dataset SSA.MDM-RE9.5.3.CICS.LOAD to your CICS STEPLIB (DFHRPL).
Define SSASEA and CSSAIOK to your CICS environment.

Installation (CICS) - dynamic calls


To install, add the dataset SSA.MDM-RE9.5.3.CICS.LOAD to your CICS STEPLIB (DFHRPL).
Define CIC001, SSAN3FN, SSASEA and CSSAIOK to your CICS environment.

Defining programs to CICS


Use the CEDA commands: (use a group defined on your CICS system).
CEDA DEF PROGRAM(CSSAIOK) GROUP(SSAGROUP)
CEDA INS PROGRAM(CSSAIOK) GROUP(SSAGROUP)

Repeat for other three programs


Example Program Definition
VIEW PROGRAM(CSSAIOK) GROUP(SSAGROUP)
OBJECT CHARACTERISTICS CICS RELEASE = 0610
CEDA View PROGram( CSSAIOK )
PROGram : CSSAIOK
Group : SSAGROUP
DEscription :
Language : C
Cobol | Assembler | Le370 | C | Pli
RELoad : No
No | Yes
RESident : No
No | Yes
USAge :
Normal | Transient
USElpacopy : No
No | Yes
Status : Enabled
Enabled | Disabled
RSl : 00
0-24 | Public
CEdf : Yes
Yes | No
DAtalocation : Any
Below | Any
EXECKey : User
User | Cics
COncurrency : Quasirent Quasirent | Threadsafe
REMOTE ATTRIBUTES
DYnamic : No
No | Yes
+ REMOTESystem :

Parameter types
The API functions return a response code. A negative response code indicates a transport error, after
which the communication channel is closed and no further API calls can be made without reconnecting.
225

CALLING FROM COBOL (Z/OS)

IDS-ADDR-GET-CASS-FIELD
Description:
Use this function to retrieve a validated CASS field. The suggestion_idx specifies the suggestion
from which to select the field value. (1..n for validated data, where n is the n_suggest parameter
returned by ids_addr_validate).

Prototype:
CALL IDSADDRGETCASSFIELD USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY VALUE
SUGGESTIDX,
BY VALUE
FIELDIDX ,
BY REFERENCE
FIELDVALUE,
BY VALUE
FIELDVALUESIZE
END CALL

Parameters:
SUGGEST-IDX Specifies the nth suggestion from which to get a cass field
FIELD-IDX Specifies a cass field within the nth suggestion
FIELD-VALUE The cass field value

Return Code:
negative for error, 0 for success

IDS-ADDR-GET-CASS-FIELD-CNT
Description:
This function returns the maximum number of CASS address fields created as a result of a parse or validate call. Use this value to dynamically allocate the field_length array for the ids_addr_parse
API.

Prototype:
CALL IDSADDRGETCASSFIELDCNT USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
COUNT
END CALL

Parameters:
COUNT Returns the max number of cass address fields
IDS-ADDR-GET-CASS-FIELD

226

Return Code:
negative for error, 0 for success

IDS-ADDR-GET-CASS-FIELD-INFO
Description:
This function returns the maximum length of an input address line. It may be used to dynamically
allocate the input lines used for the ids_addr_set_lines API.

Prototype:
CALL IDSADDRGETCASSFIELDINFO USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY VALUE
SUGGESTIDX,
BY REFERENCE
FIELDLENGTH,
BY VALUE
FIELDLENGTHNUM
END CALL

Parameters:
SUGGEST-IDX Specifies the suggestion from which to retrieve information
FIELD-LENGTH An array containing the length of each cass address field

Return Code:
negative for error, 0 for success

IDS-ADDR-GET-DEL-LINES-EXT
Description:
Use this function to retrieve delivery address line information

Prototype:
CALL IDSADDRGETDELLINESEXT USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY VALUE
SUGGESTIDX,
BY VALUE
DELCASE,
BY REFERENCE
DELLINE1 ,
BY VALUE
DELLINE1SIZE ,
BY REFERENCE
DELLINE2 ,
BY VALUE
DELLINE2SIZE ,
BY REFERENCE
DELLINE3 ,
BY VALUE
DELLINE3SIZE ,
BY REFERENCE
DELLINE4 ,
227

CALLING FROM COBOL (Z/OS)

BY
BY
BY
BY
BY
END CALL

VALUE
REFERENCE
VALUE
REFERENCE
VALUE

DELLINE4SIZE ,
DELLINE5 ,
DELLINE5SIZE ,
DELLINE6 ,
DELLINE6SIZE

Parameters:
SUGGEST-IDX Specifies the suggestion from which to get delivery address lines
DEL-CASE Specifies delivery address line case option value. The allowed values are 0 = Unchanged, 1
= Upper case, 2 = Lower case and 3 = Mixed case.
DEL-LINE1 delivery address line 1 output string
DEL-LINE2 delivery address line 2 output string
DEL-LINE3 delivery address line 3 output string
DEL-LINE4 delivery address line 4 output string
DEL-LINE5 delivery address line 5 output string
DEL-LINE6 delivery address line 6 output string

Return Code:
negative for error, 0 for success

IDS-ADDR-GET-FIELD
Description:
Use this function to retrieve a validated field. The suggestion_idx specifies the suggestion from
which to select the field value. (1..n for validated data, where n is the n_suggest parameter returned
by ids_addr_validate). val_status and val_mods return a code that describes how the field
matched to validation data and whether or not it was modified by validation. Refer to the Address
Validation section of this manual for a list of codes.

Prototype:
CALL IDSADDRGETFIELD
BY REFERENCE
BY VALUE
BY VALUE
BY VALUE
BY REFERENCE
BY VALUE
BY REFERENCE
BY REFERENCE
END CALL

USING
RC,
SOCKH,
SUGGESTIDX,
FIELDIDX ,
FIELDVALUE,
FIELDVALUESIZE ,
FIELDVALSTATUS,
FIELDVALMODS

Parameters:
SUGGEST-IDX Specifies the nth suggestion from which to get a field
IDS-ADDR-GET-FIELD

228

FIELD-IDX Specifies a field within the nth suggestion


FIELD-VALUE The field value
FIELD-VAL-STATUS Specifies how this field matched the validation data
FIELD-VAL-MODS Specifies how this field was modified by validation data

Return Code:
negative for error, 0 for success

IDS-ADDR-GET-FIELD-COUNT
Description:
This function returns the maximum number of address fields created as a result of a parse or validate
call. Use this value to dynamically allocate the field_length array for the ids_addr_parse API.

Prototype:
CALL IDSADDRGETFIELDCOUNT USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
COUNT
END CALL

Parameters:
COUNT Returns the max number of address fields

Return Code:
negative for error, 0 for success

IDS-ADDR-GET-FIELD-EXT
Description:
Use this function to retrieve all getter fields

Prototype:
CALL IDSADDRGETFIELDEXT USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY VALUE
SUGGESTIDX,
BY VALUE
FIELDOPERATION,
BY REFERENCE
FIELDNAME,
BY VALUE
FIELDITEMLINE ,
229

CALLING FROM COBOL (Z/OS)

BY REFERENCE
BY REFERENCE
BY VALUE
END CALL

FIELDTYPE ,
FIELDVALUE,
FIELDVALUESIZE

Parameters:
SUGGEST-IDX Specifies the suggestion from which to get fields
FIELD-OPERATION Field operation Option 0 for AddressElements Option 1 for AddressLines Option
2 for AddressComplete Option 3 for EnrichmentData Option 4 for ResultDataParameter Option 5 for
EnrichmentDataStatus
FIELD-NAME Refer AD Result.dtd for field names
FIELD-ITEM-LINE Represent field line number or field item number
FIELD-TYPE Refer AD Result.dtd for field attribute Type
FIELD-VALUE Cleansed field output

Return Code:
negative for error, 0 for success

IDS-ADDR-GET-FIELD-IDX
Description:
Use this function to retrieve a parsed or validated field. The suggestion_idx specifies the suggestion from which to select the field value. (0 for parsed data, 1..n for validated data, where n is the
n_suggest parameter returned by ids_addr_validate).

Prototype:
CALL IDSADDRGETFIELDIDX USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY VALUE
SUGGESTIDX,
BY VALUE
FIELDIDX ,
BY REFERENCE
FIELDVALUE,
BY VALUE
FIELDVALUESIZE
END CALL

Parameters:
SUGGEST-IDX Specifies the nth suggestion from which to get a field. On successful parse, use 0 for
ASM/AD version 4, 1 for ASM/AD version 5
FIELD-IDX Specifies a field within the nth suggestion
FIELD-VALUE The field value
IDS-ADDR-GET-FIELD-IDX

230

Return Code:
negative for error, 0 for success

IDS-ADDR-GET-FIELD-INFO-EXT
Description:
Use this function to retrieve a list of individual field lengths after validating an address. Fields with a
length of zero have no value associated with them and can be omitted from the list of fields retrieved
with ids_addr_get_field_idx

Prototype:
CALL IDSADDRGETFIELDINFOEXT USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY VALUE
SUGGESTIDX,
BY REFERENCE
FIELDLENGTH,
BY VALUE
FIELDLENGTHNUM,
BY REFERENCE
ADDRLABELENCODED,
BY VALUE
ADDRLABELENCODEDSIZE,
BY REFERENCE
ADDRLABELCHARSET,
BY VALUE
ADDRLABELCHARSETSIZE,
BY REFERENCE
SCORE
END CALL

Parameters:
SUGGEST-IDX Specifies the suggestion from which to retrieve information
FIELD-LENGTH An array containing the length of each address field
ADDR-LABEL-ENCODED The returned label
ADDR-LABEL-CHARSET The character set used in the address label
SCORE The returned labels score

Return Code:
negative for error, 0 for success

IDS-ADDR-GET-FIELD-LEN
Description:
This function returns the maximum length of an individual address field. It may be used to dynamically
allocate the field parameter used for the ids_addr_get_field_idx API.
231

CALLING FROM COBOL (Z/OS)

Prototype:
CALL IDSADDRGETFIELDLEN USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
MAXLEN
END CALL

Parameters:
MAX-LEN Returns the max address field length in bytes

Return Code:
negative for error, 0 for success

IDS-ADDR-GET-LINE-LEN
Description:
This function returns the maximum length of an input address line. It may be used to dynamically
allocate the input lines used for the ids_addr_set_lines API.

Prototype:
CALL IDSADDRGETLINELEN USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
MAXLEN
END CALL

Parameters:
MAX-LEN Returns the max line length in bytes

Return Code:
negative for error, 0 for success

IDS-ADDR-GET-OPTION
Description:
Use this function to obtain values of options that control Address Standardization behavior. A list of
options appears in the Address Standardization section of this manual.
IDS-ADDR-GET-LINE-LEN

232

Prototype:
CALL IDSADDRGETOPTION USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
PARAM,
BY REFERENCE
VALUE,
BY VALUE
VALUESIZE
END CALL

Parameters:
PARAM This field specifies the name of the option to get.
VALUE Returns the value of the option.

Return Code:
negative for error, 0 for success

IDS-ADDR-INFO
Description:
Use this function to request additional information about an input address. This call must always be
preceded with a call to ids_addr_std.

Prototype:
CALL IDSADDRINFO USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
CONTROLS,
BY REFERENCE
VALUE,
BY VALUE
VALUESIZE
END CALL

Parameters:
CONTROLS this field contains the request information. It must me specified in the form ITEM=[value].
VALUE this field contains the requested information.

Return Code:
negative for error, 0 for success

IDS-ADDR-INIT
Description:
This function initializes the Address Standardization sub-system. It must be the first call to
ids_addr_* family of functions. The max_memory parameter specifies the maximum amount of
memory (MB) to be used by the Address Standardization engine (within the Search Server process).
233

CALLING FROM COBOL (Z/OS)

Prototype:
CALL IDSADDRINIT USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY VALUE
MAXMEMORY
END CALL

Parameters:
MAX-MEMORY This field specifies the maximum amount of memory (MB) to be used by the Address
Standardization engine.

Return Code:
negative for error, 0 for success

IDS-ADDR-PARSE
Description:
Use this function to parse an address. The individual field lengths after parsing an address are returned
in the field_length array. Fields with a length of zero have no value associated with them and can be
omitted from the list of fields retrieved with ids_addr_get_field_idx

Prototype:
CALL IDSADDRPARSE USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
FIELDLENGTH,
BY VALUE
FIELDLENGTHNUM
END CALL

Parameters:
FIELD-LENGTH An array containing the length of each parsed field

Return Code:
negative for error, 0 for success

IDS-ADDR-PRELOAD-COUNTRY
Description:
Use this function to preload country database
IDS-ADDR-PARSE

234

Prototype:
CALL IDSADDRPRELOADCOUNTRY USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
PRELOADTYPE,
BY REFERENCE
PRELOADCOUNTRY,
BY REFERENCE
VALMODE
END CALL

Parameters:
PRELOAD-TYPE Type of preload to perform
PRELOAD-COUNTRY Country database to be preloaded
VAL-MODE Validation mode to be used

Return Code:
negative for error, 0 for success

IDS-ADDR-SET-ATTRIB
Description:
Use this function to specify the character set of the data (for both input and output). The default_country parameter specifies that default country to use when parsing cannot identify a country
from the address. This API must be called prior to parsing or validating an address. The values stay in
effect for the life of the session, or until they are changed.

Prototype:
CALL IDSADDRSETATTRIB USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
CHARSET,
BY REFERENCE
DEFAULTCOUNTRY
END CALL

Parameters:
CHAR-SET The name of the character set used to encode the input and output.
DEFAULT-COUNTRY The default country used for validation when parsing cannot detect a country
name.

Return Code:
negative for error, 0 for success
235

CALLING FROM COBOL (Z/OS)

IDS-ADDR-SET-DEL-LINES
Description:
Use this function to set delivery address line information

Prototype:
CALL IDSADDRSETDELLINES USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
DELLINE1 ,
BY REFERENCE
DELLINE2 ,
BY REFERENCE
DELLINE3 ,
BY REFERENCE
DELLINE4 ,
BY REFERENCE
DELLINE5 ,
BY REFERENCE
DELLINE6
END CALL

Parameters:
DEL-LINE1 delivery address line 1 input string
DEL-LINE2 delivery address line 2 input string
DEL-LINE3 delivery address line 3 input string
DEL-LINE4 delivery address line 4 input string
DEL-LINE5 delivery address line 5 input string
DEL-LINE6 delivery address line 6 input string

Return Code:
negative for error, 0 for success

IDS-ADDR-SET-FIELD-CASE
Description:
Use this function to set individual input fields case option

Prototype:
CALL IDSADDRSETFIELDCASE USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY VALUE
FIELDIDX ,
BY VALUE
FIELDCASE
END CALL
IDS-ADDR-SET-DEL-LINES

236

Parameters:
FIELD-IDX Specifies the nth field to set
FIELD-CASE Specifies output field case option value. The allowed values are 0 = Unchanged, 1 =
Upper case, 2 = Lower case and 3 = Mixed case.

Return Code:
negative for error, 0 for success

IDS-ADDR-SET-FIELD-EXT
Description:
Use this function to set fields

Prototype:
CALL IDSADDRSETFIELDEXT USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY VALUE
FIELDOPERATION,
BY REFERENCE
FIELDNAME,
BY VALUE
FIELDITEMLINE ,
BY REFERENCE
FIELDTYPE ,
BY REFERENCE
FIELDVALUE
END CALL

Parameters:
FIELD-OPERATION Field operation Option 0 for AddressElements Option 1 for AddressLines
FIELD-NAME Refer AD Result.dtd for field names
FIELD-ITEM-LINE Represent field line number or field item number
FIELD-TYPE Refer AD Result.dtd for field attribute Type
FIELD-VALUE input field value

Return Code:
negative for error, 0 for success

IDS-ADDR-SET-FIELD-IDX
Description:
Use this function to specify the value of an input field. This API is used to specify an input address that
has already been pre-parsed into separate fields.
237

CALLING FROM COBOL (Z/OS)

Prototype:
CALL IDSADDRSETFIELDIDX USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY VALUE
FIELDIDX ,
BY REFERENCE
FIELDVALUE
END CALL

Parameters:
FIELD-IDX Specifies the nth field to set
FIELD-VALUE Specifies a value for the nth field

Return Code:
negative for error, 0 for success

IDS-ADDR-SET-FIELD-NAME
Description:
Use this function to set individual input fields by name

Prototype:
CALL IDSADDRSETFIELDNAME USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
FIELDNAME,
BY REFERENCE
FIELDVALUE
END CALL

Parameters:
FIELD-NAME Specifies the name of the field to set
FIELD-VALUE Specifies a value for the field

Return Code:
negative for error, 0 for success

IDS-ADDR-SET-LINES
Description:
Use this function to specify the value of an input field. This API is used to specify an input address that
has already been pre-parsed into separate fields.
IDS-ADDR-SET-FIELD-NAME

238

Prototype:
CALL IDSADDRSETLINES
BY REFERENCE
BY VALUE
BY REFERENCE
BY REFERENCE
BY REFERENCE
BY REFERENCE
BY REFERENCE
BY REFERENCE
BY REFERENCE
BY REFERENCE
BY REFERENCE
BY REFERENCE
END CALL

USING
RC,
SOCKH,
LINE1 ,
LINE2 ,
LINE3 ,
LINE4 ,
LINE5 ,
LINE6 ,
LINE7 ,
LINE8 ,
LINE9 ,
LINE10

Parameters:
LINE-1 The first line of the address
LINE-2 The second line of the address
LINE-3 The third line of the address
LINE-4 The fourth line of the address
LINE-5 The fifth line of the address
LINE-6 The sixth line of the address
LINE-7 The seventh line of the address
LINE-8 The eighth line of the address
LINE-9 The ninth line of the address
LINE-10 The tenth line of the address

Return Code:
negative for error, 0 for success

IDS-ADDR-SET-OPTION
Description:
Use this function to set values of options that control Address Standardization behavior. A list of
options appears in the Address Standardization section of this manual.

Prototype:
CALL IDSADDRSETOPTION USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
PARAM,
BY REFERENCE
VALUE
END CALL
239

CALLING FROM COBOL (Z/OS)

Parameters:
PARAM This field specifies the name of the option to set.
VALUE This field specifies a value for the option.

Return Code:
negative for error, 0 for success

IDS-ADDR-STD
Description:
Use this function to request IDS to standardize an address by validating it against USPS validation
tables and formatting it to comply with U.S. Postal Addressing Standards. This API requires the separately licensable IDS Address Standardization Module to be installed.

Prototype:
CALL IDSADDRSTD USING
BY REFERENCE
BY VALUE
BY REFERENCE
BY VALUE
BY REFERENCE
BY VALUE
BY REFERENCE
BY VALUE
BY REFERENCE
BY VALUE
BY REFERENCE
BY VALUE
END CALL

RC,
SOCKH,
FIRMNAME,
FIRMNAMESIZE,
URBANIZATION,
URBANIZATIONSIZE,
ADDRESSONE,
ADDRESSONESIZE,
ADDRESSTWO,
ADDRESSTWOSIZE,
LASTLINE ,
LASTLINESIZE

Parameters:
FIRM-NAME It contains the name of the firm (may be blank).
URBANIZATION this field can contain name of an urban development within a geographic area. It is
only used with Puerto Rican addresses.
ADDRESS-ONE this field contains the Delivery Address Line. It normally consists of a street number,
pre-directional, street name, street suffix, post-directional and possibly some secondary address components such as apartment number.
ADDRESS-TWO this field contains additional Delivery Address Line components. It is normally only
used when address_one is very long.
LAST-LINE this field contains the Last Line information: the city name, state abbreviation and zip
code (and possibly the Zip + 4 code).
IDS-ADDR-STD

240

Return Code:
0 indicates an exact match to a valid address
1 indicates a no match (invalid address)
2 indicates a multi match (non-unique address), and
< 0 indicates an error

IDS-ADDR-VALIDATE
Description:
Use this function to validate an address

Prototype:
CALL IDSADDRVALIDATE USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
STATUS,
BY REFERENCE
NSUGGEST
END CALL

Parameters:
STATUS The status returned by the validation process
N-SUGGEST The number of suggestions generated by validation

Return Code:
negative for error, 0 for success

IDS-CONNECT
Description:
Initiates a socket.

Prototype:
CALL IDSCONNECT USING
BY REFERENCE
BY REFERENCE
BY VALUE
BY REFERENCE
END CALL

Parameters:
HOST is the host to connect to.
241

CALLING FROM COBOL (Z/OS)

RC,
HOST,
PORT,
SOCKH

PORT is the port to connect to.


SOCKH is a socket handle.

Return Code:
negative for error, 0 for success

IDS-DISCONNECT
Description:
Releases resources allocated to a socket.

Prototype:
CALL IDSDISCONNECT USING
BY REFERENCE
RC,
BY VALUE
SOCKH
END CALL

Parameters:
none

Return Code:
negative for error, 0 for success

IDS-ERROR-GET
Description:
Get the error messages from the last API function that failed. This function should be called repeatedly
until it returns 1, meaning all messages have been retrieved.
Note: if a communication (socket) error occurred, this function will also fail. Refer to the
O PERATIONS M ANUAL, Error Log section for help in interpreting the Error Log.

Prototype:
CALL IDSERRORGET USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
MSG,
BY VALUE
MSGSIZE
END CALL

Parameters:
MSG is the error message returned
IDS-DISCONNECT

242

Return Code:
0 for success, -ve for error and 1 for no more errors to retrieve.

IDS-ERRORS-GET-ALL
Description:
Get the Server side error messages from the last API function that failed. This function should be called
repeatedly until it returns 1, meaning all messages have been retrieved.
Note: if a communication (socket) error occurred, this function will also fail. Refer to the
O PERATIONS M ANUAL, Error Log section for information on interpreting the Error Log.

Prototype:
CALL IDSERRORSGETALL
BY REFERENCE
BY VALUE
BY REFERENCE
BY VALUE
END CALL

USING
RC,
SOCKH,
MSG,
MSGSIZE

Parameters:
MSG is an error message.

Return Code:
negative for error, 0 for success

IDS-IDENTIFY
Description:
Identify a session to the console

Prototype:
CALL IDSIDENTIFY USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
IDENTIFICATION
END CALL

Parameters:
IDENTIFICATION is user supplied identitification for display on the console
243

CALLING FROM COBOL (Z/OS)

Return Code:
negative for error, 0 for success

IDS-IS-LITTLE-ENDIAN
Description:
Checks if the search server is running on a little endian platform

Prototype:
CALL IDSISLITTLEENDIAN USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
ENDIANSTATE
END CALL

Parameters:
ENDIAN-STATE Returns 1 if the search server is running on a little endian platform. Returns 0 for
others

Return Code:
negative for error, 0 for success

IDS-MATCH-EXPLAIN
Description:
Explains the match result given search and file records As match_explain_count does not give the exact
number of output rows for this call, but instead provides a maximal estimate, some of the info blocks
returned will be filled with NULL bytes. Test a block for validity by checking the first byte is not NULL.
Info blocks returned are not all the same length either. They are NULL filled on the right.

Prototype:
CALL IDSMATCHEXPLAIN USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
SEARCH,
BY REFERENCE
MATCHTOLERANCE,
BY REFERENCE
SEARCHREC,
BY REFERENCE
FILEREC ,
BY REFERENCE
INFOARRAY,
BY VALUE
INFOARRAYNUM,
BY VALUE
INFOARRAYSIZE
END CALL
IDS-IS-LITTLE-ENDIAN

244

Parameters:
SEARCH is the name of the Search which was performed.
MATCH-TOLERANCE specifies either Conservative, Typical or Loose to nominate how aggressive
the matching scheme should be in rejecting candidates.
SEARCHREC is the IDT record used to search with. It is returned by the Search Server.
FILEREC is the record to be matched agains the searchrec
INFO-ARRAY An array describing the match results. See the Match Explain API section for details

Return Code:
negative for error, 0 for success

IDS-MATCH-EXPLAIN-COUNT
Description:
Estimate number of info blocks required for a subsequent match_explain call

Prototype:
CALL IDSMATCHEXPLAINCOUNT USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
SEARCH,
BY REFERENCE
COUNT
END CALL

Parameters:
SEARCH is the name of the Search which was performed.
COUNT Returns the maximum number of info blocks required to explain the search results

Return Code:
negative for error, 0 for success

IDS-PID-CLOSE
Description:
Closes resources opened with the ids_pid_open call.
245

CALLING FROM COBOL (Z/OS)

Prototype:
CALL IDSPIDCLOSE USING
BY REFERENCE
RC,
BY VALUE
SOCKH
END CALL

Parameters:
none

Return Code:
negative for error, 0 for success

IDS-PID-MEMBER-COUNT
Description:
Retrieve the number of member records in a cluster

Prototype:
CALL IDSPIDMEMBERCOUNT USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
PREFIX ,
BY VALUE
CLUSTERNUM,
BY REFERENCE
COUNT
END CALL

Parameters:
PREFIX is the persistent ID prefix for the cluster to look up.
CLUSTER-NUM is the cluster number for the cluster to look up.
COUNT the number of member records found for the cluster

Return Code:
negative for error, 0 for success

IDS-PID-MEMBER-GET
Description:
Called after ids_pid_member_count in a consecutive manner to retrieve the member records for a
cluster.
IDS-PID-MEMBER-COUNT

246

Prototype:
CALL IDSPIDMEMBERGET
BY REFERENCE
BY VALUE
BY REFERENCE
BY VALUE
BY REFERENCE
BY VALUE
BY REFERENCE
END CALL

USING
RC,
SOCKH,
PREFIX ,
CLUSTERNUM,
RECORD,
RECORDSIZE,
RECID

Parameters:
PREFIX is the persistent ID prefix for the cluster.
CLUSTER-NUM cluster_num is the cluster number for the cluster.
RECORD the member record in IDT layout.
RECID is rhe Rescord-Id for the member record (corresponding to the RECID column from the IDT)

Return Code:
negative for error, 0 for success, and 1 for "end of set".

IDS-PID-OPEN
Description:
Open resources for use with Persistent-ID.

Prototype:
CALL IDSPIDOPEN USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
MULTISEARCH
END CALL

Parameters:
MULTI-SEARCH is the name of a multi-search which uses Persistent-ID. This function requires a prior
call to ids_system_open.

Return Code:
negative for error, 0 for success
247

CALLING FROM COBOL (Z/OS)

IDS-PID-SEARCH-GET
Description:
Retrieve Preferred records which are a good match for the search record specified in the
ids_search_start or ids_system_search_start function. This function will return extended
matching information, including the match decision and the file (IDT) record-ID of the matching
records.

Prototype:
CALL IDSPIDSEARCHGET
BY REFERENCE
BY VALUE
BY REFERENCE
BY REFERENCE
BY VALUE
BY REFERENCE
BY REFERENCE
BY VALUE
BY REFERENCE
BY REFERENCE
END CALL

USING
RC,
SOCKH,
SEARCH,
FILEREC ,
FILERECSIZE ,
SCORE,
DECISION ,
DECISIONSIZE ,
FILERECID ,
CLUSTERCOUNT

Parameters:
SEARCH is the name of the Search which was performed.
FILE-REC is the matched File record.
SCORE is the degree of similarity between the Search and File records (0-100).
DECISION is the match decision: A(ccept) or U(ndecided)
FILE-RECID is the File Record-ID (corresponding to the RECID column from the IDT).
CLUSTER-COUNT is the number of clusters asociated with the cluster.

Return Code:
negative for error, 0 for success, and 1 for "end of set".

IDS-PID-SEARCH-GET-CLUSTERS
Description:
May be called after each call to ids_pid_search_get to retrieve the clusters associated with the
preferred record.

Prototype:
IDS-PID-SEARCH-GET

248

CALL IDSPIDSEARCHGETCLUSTERS USING


BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
SEARCH,
BY VALUE
FILERECID ,
BY REFERENCE
PREFIXS ,
BY VALUE
PREFIXSNUM,
BY VALUE
PREFIXSSIZE ,
BY REFERENCE
CLUSTERNUMS,
BY VALUE
CLUSTERNUMSNUM
END CALL

Parameters:
SEARCH is the name of the Search which was performed.
FILE-RECID is the Preferred Record-ID (corresponding to the RECID column from the IDT).
PREFIXS is the prefix for the associated cluster
CLUSTER-NUMS is the number for the asociated cluster

Return Code:
negative for error, 0 for success

IDS-PID-SRC-PK-GET
Description:
Get persistent ids one at a time

Prototype:
CALL IDSPIDSRCPKGET
BY REFERENCE
BY VALUE
BY REFERENCE
BY VALUE
BY VALUE
END CALL

USING
RC,
SOCKH,
SRCPKVALUE,
SRCPKVALUENUM,
SRCPKVALUESIZE

Parameters:
SRC-PK-VALUE the values of primary keys from the source table

Return Code:
negative for error, 0 for success
249

CALLING FROM COBOL (Z/OS)

IDS-PID-SRC-PK-START
Description:
Search for persistent ids

Prototype:
CALL IDSPIDSRCPKSTART USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
MULTISEARCH,
BY REFERENCE
SRCPK
END CALL

Parameters:
MULTI-SEARCH the name of the multi-search
SRC-PK the values of primary keys from the source table

Return Code:
negative for error, 0 for success

IDS-PS-GET-ENTITY-LIST
Description:
Retrieves entity names supported by the current population

Prototype:
CALL IDSPSGETENTITYLIST USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
GROSSNAMES,
BY VALUE
GROSSNAMESNUM,
BY VALUE
GROSSNAMESSIZE,
BY REFERENCE
FINENAMES,
BY VALUE
FINENAMESNUM,
BY VALUE
FINENAMESSIZE
END CALL

Parameters:
GROSS-NAMES List of Gross entity names
FINE-NAMES List of Fine entity names

Return Code:
negative for error, 0 for success
IDS-PID-SRC-PK-START

250

IDS-PS-GET-ENTITY-MAX-ELEMENTS
Description:
Retrieves number of entity array elements

Prototype:
CALL IDSPSGETENTITYMAXELEMENTS USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
TYPE ,
BY REFERENCE
ELEMENTS
END CALL

Parameters:
TYPE Type of entity: Input, Gross, Fine, Standard, Format
ELEMENTS maximum number of occurrences

Return Code:
negative for error, 0 for success

IDS-PS-GET-ENTITY-MAX-LENGTH
Description:
Retrieves maximum length of an entity value

Prototype:
CALL IDSPSGETENTITYMAXLENGTH USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
TYPE ,
BY REFERENCE
LENGTH
END CALL

Parameters:
TYPE Type of entity: Input, Gross, Fine, Standard, Format
LENGTH maximum length (bytes) of an entity value

Return Code:
negative for error, 0 for success
251

CALLING FROM COBOL (Z/OS)

IDS-PS-PARSE
Description:
Parse, Standardize and Format API

Prototype:
CALL IDSPSPARSE USING
BY REFERENCE
BY VALUE
BY REFERENCE
BY REFERENCE
BY REFERENCE
BY VALUE
BY VALUE
BY REFERENCE
BY VALUE
BY VALUE
BY REFERENCE
BY VALUE
BY VALUE
BY REFERENCE
BY VALUE
BY VALUE
END CALL

RC,
SOCKH,
OPERATION,
INPUT,
GROSS,
GROSSNUM,
GROSSSIZE ,
FINE ,
FINENUM,
FINESIZE ,
STANDARD,
STANDARDNUM,
STANDARDSIZE,
PSFORMAT,
PSFORMATNUM,
PSFORMATSIZE

Parameters:
OPERATION The operation(s) to perform: G, F, S, M
INPUT Unparsed input string
GROSS Gross entities used as input or output
FINE Fine entities used as input or output
STANDARD Standardized entities used as input or output
PS-FORMAT Formatted output string

Return Code:
negative for error, 0 for success

IDS-PS-SET-ENCODING
Description:
Defines encoding used for the input/output data
IDS-PS-PARSE

252

Prototype:
CALL IDSPSSETENCODING USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY VALUE
ENCODING
END CALL

Parameters:
ENCODING 0=Population default, 8=UTF-8, 16=UTF-16

Return Code:
negative for error, 0 for success

IDS-PS-SET-ENTITY-LIST
Description:
Defines a subset of entities for input/output

Prototype:
CALL IDSPSSETENTITYLIST USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
TYPE ,
BY REFERENCE
ENTITYLIST
END CALL

Parameters:
TYPE Type of entity: Gross or Fine
ENTITY-LIST List of entity names

Return Code:
negative for error, 0 for success

IDS-PS-SET-POPULATION
Description:
Defines the System and Population used for parsing rules
253

CALLING FROM COBOL (Z/OS)

Prototype:
CALL IDSPSSETPOPULATION USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
SYSTEM ,
BY REFERENCE
POPULATION
END CALL

Parameters:
SYSTEM System Name
POPULATION Specifies a Population within the System

Return Code:
negative for error, 0 for success

IDS-REAL-TIME-ASYNC-GET
Description:
Used to retrieve the result count associated with a call to ids_real_time_async_start.
cluster_action_count specifies the number of results that are available for collection using
ids_real_time_sync_get.

Prototype:
CALL IDSREALTIMEASYNCGET USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
REFERENCE,
BY VALUE
BLOCK,
BY REFERENCE
CLUSTERACTIONCOUNT
END CALL

Parameters:
REFERENCE A
reference
number
ids_real_time_sync_start)

identifying

the

request

(returned

by

BLOCK 1 = wait for a response 0 = return immediately if no results are available yet
CLUSTER-ACTION-COUNT The number of clusters generated These can be returned with call to
real_time_sync_get 1 = wait for a response

Return Code:
negative for error 0 for success positive for no results are available yet
IDS-REAL-TIME-ASYNC-GET

254

IDS-REAL-TIME-ASYNC-START
Description:
Used to start a synchronizer transaction of the Real Time Synchronization server. This call works in an
asynchronous fashion and will return when the transaction has been placed on the servers work queue
rather than when the transaction has been processed. The record passed in must match the layout of
the IDT. This call must be followed by a call to ids_real_time_async_get, then by one or more
calls to ids_real_time_sync_get to retrieve the results.

Prototype:
CALL IDSREALTIMEASYNCSTART USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
RULEBASE,
BY REFERENCE
SYSTEM ,
BY REFERENCE
IDT ,
BY REFERENCE
SEQUENCENUMBER,
BY REFERENCE
OPERATION,
BY REFERENCE
CLUSTERRECORD,
BY VALUE
SOURCE,
BY REFERENCE
MULTISEARCH,
BY VALUE
INPUTID ,
BY REFERENCE
REFERENCE,
BY VALUE
REFERENCESIZE
END CALL

Parameters:
RULEBASE is the name of the rulebase.
SYSTEM The name of the system in the rulebase
IDT is the name of the IDT associated with the update.
SEQUENCE-NUMBER is a string that specifies the order of synchronization. Must obey the rules for
sequence numbers found in the O PERATIONS M ANUAL.
OPERATION The synchronizer operation being performed: A for add or D for delete
CLUSTER-RECORD The record to be updated. The record must use the same layout as the IDT.
SOURCE Identifies the source of clustering: 0 = Real Time Synchronizer 1 = Flat file 2 = NSA table
MULTI-SEARCH The name of the multi-search which uses Persistent-ID. This parameter should be set
to an empty string for an IDT/IDX only transaction.
INPUT-ID The cluster id or record id as appropriate
REFERENCE A reference string identifying the request.
ids_real_time_sync_get call when retrieving results.

Return Code:
negative for error
0 for success positive for warnings:
255

CALLING FROM COBOL (Z/OS)

This must be passed to the

1-9 Reserved for future use


10 warnings: Duplicate PK detected on add to IDT with WARN_DUPLICATE_PK sync option.
11 warnings: Duplicate transaction was skipped.
12 warnings: Transaction was rejected because the sequence number was less than or equal to a previous transaction. The record was added to the reject table.

IDS-REAL-TIME-FLUL-ADD
Description:
This API used to add force link and unlink rule.
ids_real_time_flul_init.

This call must be followed by

Prototype:
CALL IDSREALTIMEFLULADD USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
RULETYPE,
BY REFERENCE
SUBJECTRECPK,
BY REFERENCE
RELATIONSHIP ,
BY REFERENCE
RELATEDRECPK
END CALL

Parameters:
RULE-TYPE This field is for specifying the type of the rule. A value of A represents that the rule needs
to be added to the system and D represents that a rule needs to be removed from the system
SUBJECT-REC-PK This field is for specifying the PK of the subject record
RELATIONSHIP This field is for specifying the relationship between the subject record and related
record. A value of L represents a Link rule between the subject record and the related record and a
value of U represents an Unlink rule between the subject record and the related record.
RELATED-REC-PK This field is for specifying the PK of the record that is either linked or unlinked to
the subject record.

Return Code:
negative for error, 0 for success 3 when the Link rule is not allowed. Record unlinked with members of
subject cluster.

IDS-REAL-TIME-FLUL-CLOSE
Description:
This API used to close and release force link and unlink module.
IDS-REAL-TIME-FLUL-ADD

256

Prototype:
CALL IDSREALTIMEFLULCLOSE USING
BY REFERENCE
RC,
BY VALUE
SOCKH
END CALL

Parameters:
none

Return Code:
negative for error, 0 for success

IDS-REAL-TIME-FLUL-DELETE
Description:
This API used to delete force link and unlink rule from MR table. This call must be followed by
ids_real_time_flul_init.

Prototype:
CALL IDSREALTIMEFLULDELETE USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY VALUE
RULETYPEOPTION,
BY REFERENCE
RECORDPK
END CALL

Parameters:
RULE-TYPE-OPTION

0 Delete only disabled rules for input pk.

1 Delete only active rules for input pk.


2 Delete all rules for input pk.
RECORD-PK This field is for specifying the PK of the record to be deleted

Return Code:
negative for error, 0 for success

IDS-REAL-TIME-FLUL-FIND-RULE
Description:
This API used to find link and unlink information for input IDT record. should be called after
ids_real_time_flul_init API.
257

CALLING FROM COBOL (Z/OS)

Prototype:
CALL IDSREALTIMEFLULFINDRULE USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
IDTREC ,
BY VALUE
OPTION
END CALL

Parameters:
IDT-REC This field is for specifying the PK of the record to be searched
OPTION

0 Link Rule.

1 Unlink Rule.

Return Code:
negative for error, 0 for success

IDS-REAL-TIME-FLUL-GET-RULE
Description:
This API used fetch link and unlink information for input IDT record.
ids_real_time_flul_find_rule API.

Should be called after

Prototype:
CALL IDSREALTIMEFLULGETRULE USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
IDTREC ,
BY VALUE
IDTRECSIZE
END CALL

Parameters:
IDT-REC is the matched File record for input link or unlink rule.

Return Code:
negative for error, 0 for success

IDS-REAL-TIME-FLUL-INIT
Description:
This API used to initialize force link and unlink module.
Memory allocated a part of
ids_real_time_flul_init is released using ids_real_time_flul_close.
IDS-REAL-TIME-FLUL-GET-RULE

258

Prototype:
CALL IDSREALTIMEFLULINIT USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
IDTNAME,
BY REFERENCE
MULTISEARCH
END CALL

Parameters:
IDT-NAME is the name of the IDT associated with the force link and unlink rule.
MULTI-SEARCH The name of the multi-search which uses Persistent-ID. This parameter should be set
to an empty string for an IDT only MR rule creation.

Return Code:
negative for error, 0 for success

IDS-REAL-TIME-SYNC-GET
Description:
Use to retrieve the results and free the resources associated with a call to
ids_real_time_sync_start or ids_real_time_async_start. Should be called until it
returns a non zero response.

Prototype:
CALL IDSREALTIMESYNCGET USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
REFERENCE,
BY REFERENCE
CLUSTERACTIONTYPE,
BY VALUE
CLUSTERACTIONTYPESIZE,
BY REFERENCE
CLUSTERACTIONID,
BY VALUE
CLUSTERACTIONIDSIZE,
BY REFERENCE
CLUSTERACTIONNUMBER,
BY REFERENCE
CLUSTERACTIONNEW,
BY VALUE
CLUSTERACTIONNEWSIZE
END CALL

Parameters:
REFERENCE A reference string identifying the request.
ids_real_time_sync_get call when retriving results.

This must be passed to the

CLUSTER-ACTION-TYPE Identifies the action, ie add or delete


CLUSTER-ACTION-ID The prefix which identifies the cluster
CLUSTER-ACTION-NUMBER The number which identifies the cluster
CLUSTER-ACTION-NEW Identifies whether the cluster is newly formed or existing
259

CALLING FROM COBOL (Z/OS)

Return Code:
negative for error, 0 for success, 1 for end of results

IDS-REAL-TIME-SYNC-START
Description:
Used to start a synchronizer transaction of the Real Time Synchronization server. This call works
in a synchronous fashion returning only when the transaction has been processed. The record
passed in must match the layout of the IDT. This call must be followed by one or more calls to
ids_real_time_sync_get to retrieve results.

Prototype:
CALL IDSREALTIMESYNCSTART USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
RULEBASE,
BY REFERENCE
SYSTEM ,
BY REFERENCE
IDT ,
BY REFERENCE
SEQUENCENUMBER,
BY REFERENCE
OPERATION,
BY REFERENCE
CLUSTERRECORD,
BY REFERENCE
CLUSTERACTIONCOUNT,
BY REFERENCE
REFERENCE,
BY VALUE
REFERENCESIZE
END CALL

Parameters:
RULEBASE is the name of the rulebase.
SYSTEM The name of the system in the rulebase
IDT is the name of the IDT associated with the update.
SEQUENCE-NUMBER is a string that specifies the order of synchronization. Must obey the rules for
sequence numbers found in the O PERATIONS M ANUAL.
OPERATION The synchronizer operation being performed: A for add or D for delete
CLUSTER-RECORD The record to be updated. The record must use the same layout as the IDT.
CLUSTER-ACTION-COUNT The number of clusters generated. For IDT/IDX only processing this parameter will always be 0. These can be returned with ids_real_time_sync_get
REFERENCE A reference string identifying the request.
ids_real_time_sync_get call when retriving results.

This must be passed to the

Return Code:
negative for error
0 for success, and postive for warnings:
IDS-REAL-TIME-SYNC-START

260

1-9 Reserved for future use


10 warning: Duplicate PK detected on add to IDT with WARN_DUPLICATE_PK sync option.
11 warning: Transaction was skipped.
12 warning: Transaction was reject because the sequence number was lessa than or equal to a previous
transaction. The record was added to the reject table.
13 warning: Transaction became a No Op. e.g. Add followed by delete in the same commit cycle
equates to do nothing.
14 warning: Force server shutdown in progress.
15 warning: Could not perform delete as the IDT record was not found. This will normally trigger
error unless the appropriate option is set in the syncronization server configuration.

IDS-SCORES-GET
Description:
Retrieve an array of scores, one per match record. This API is used in conjunction with ids_search_start
when candidate records to be matched are provided by the caller. The records and their scores may be
retrieved either by repeatedly calling ids_search_get or by calling this function to retrieve all scores at
once. A limit of 1024 scores may be returned in a single call. When using this function, please ensure
that an Accept limit of 0 has been specified (so that all candidates are returned regardless of their score),
and specify a SORT= parameter in the Search-Definition to ensure that the records remain in the same
order as passed otherwise they will be sorted by descending score. This is perhaps best achieved by
inserting a record number in each row and sorting by that field. The size of the scores array must be
equal to the number of input records to be matched, and may not exceed 1024.

Prototype:
CALL IDSSCORESGET USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
SEARCHNAME,
BY REFERENCE
SCORES ,
BY VALUE
SCORESNUM
END CALL

Parameters:
SEARCHNAME is the name of the associated search
SCORES is an array of scores, one per candidate record

Return Code:
negative for error, 0 for success

IDS-SEARCH-COMMENT-GET
Description:
Returns the user defined comment stored with the search.
261

CALLING FROM COBOL (Z/OS)

Prototype:
CALL IDSSEARCHCOMMENTGET USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
SEARCHNAME,
BY REFERENCE
COMMENT,
BY VALUE
COMMENTSIZE
END CALL

Parameters:
SEARCHNAME the search to count.
COMMENT is the area to copy the string containing the comment. This string will be null-terminated.

Return Code:
negative for error, 0 for success

IDS-SEARCH-DEDUPE-START
Description:
Search for duplicate records in the IDT. Refer to the Dup Finder section in this manual for details.

Prototype:
CALL IDSSEARCHDEDUPESTART USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
SEARCH,
BY REFERENCE
SEARCHWIDTH,
BY REFERENCE
MATCHTOLERANCE,
BY REFERENCE
PARAMETERS,
BY REFERENCE
SEARCHREC,
BY VALUE
SEARCHRECSIZE,
BY REFERENCE
ANSWERSETNAME,
BY VALUE
FLAGS ,
BY REFERENCE
RECID ,
BY REFERENCE
RECS
END CALL

Parameters:
SEARCH is the name of the search that is to be performed.
SEARCH-WIDTH specifies either Narrow, Typical or Exhaustive to nominate how many candidates should be selected.
MATCH-TOLERANCE specifies either Conservative, Typical or Loose to nominate how aggressive
the matching scheme should be in rejecting candidates.
PARAMETERS not used.
IDS-SEARCH-DEDUPE-START

262

SEARCHREC is the IDT record used to search with. It is returned by the Search Server.
ANSWERSETNAME is used store the search results in an AnswerSet. The Answerset is used to identify
the Search results in the table and is constructed by concatenating the AnswersetName parameter with
the Search-Record-Id (10 bytes) . The maximum AnswersetName length is 22 characters. If you do not
wish to store the search results in an AnswerSet, set AnswersetName to an empty String.
FLAGS flags for specifying options. This field is a bit-field. Valid values are: 2 = return search record
only. 4=remove search record from returned set.
RECID the recid of the record to start a searching on. A value of 0 starts searching from the beginning
of the IDT. The returned value is the recid of the next record to be searched.
RECS the number of records in the search set.

Return Code:
negative for error, 0 for success, and 1 for truncation of the search set.

IDS-SEARCH-FIELDS-COUNT
Description:
Gets the number of fields required to assemble the search record.

Prototype:
CALL IDSSEARCHFIELDSCOUNT USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
SEARCHNAME,
BY REFERENCE
FC
END CALL

Parameters:
SEARCHNAME the search to count.
FC is the number of fields required to be filled in to assemble the search.

Return Code:
negative for error, 0 for success

IDS-SEARCH-FIELDS-GET
Description:
Gets the number of fields required to assemble the search record.
263

CALLING FROM COBOL (Z/OS)

Prototype:
CALL IDSSEARCHFIELDSGET USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
SEARCHNAME,
BY REFERENCE
FIELDNAMES,
BY VALUE
FIELDNAMESNUM,
BY VALUE
FIELDNAMESSIZE
END CALL

Parameters:
SEARCHNAME the search to count.
FIELDNAMES is the array returned which will contain the name of the fields.

Return Code:
negative for error, 0 for success

IDS-SEARCH-FILTER
Description:
Sets a dynamic SQL filter to be used by a search. Refere to the SQL Filters section of the D ESIGNER
M ANUAL for details about SQL filters

Prototype:
CALL IDSSEARCHFILTER USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
SEARCH,
BY REFERENCE
FILTER
END CALL

Parameters:
SEARCH is the name of the Search that will use the filter
FILTER is a string containing an SQL expression or values for substituion variables

Return Code:
negative for error, 0 for success

IDS-SEARCH-FINISH
Description:
Release resources associated with ids_search_start.
IDS-SEARCH-FILTER

264

Prototype:
CALL IDSSEARCHFINISH USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
SEARCH
END CALL

Parameters:
SEARCH is the name of the search that was performed

Return Code:
negative for error, 0 for success

IDS-SEARCH-GET
Description:
Retrieve file records that are a good match for the search record specified in the ids_search_start
or ids_system_search_start function.

Prototype:
CALL IDSSEARCHGET USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
SEARCHNAME,
BY REFERENCE
SEARCHRETURN,
BY VALUE
SEARCHRETURNSIZE,
BY REFERENCE
SCORE,
BY REFERENCE
SREPS ,
BY VALUE
SREPSNUM,
BY REFERENCE
FREPS ,
BY VALUE
FREPSNUM
END CALL

Parameters:
SEARCHNAME is the name the search to used by the call.
SEARCHRETURN is an area into which a string from the set is copied.
SCORE is the score calculated for the string.
SREPS is an array of the ordinal values of the repeating fields in the search record that were used in
the match.
Note: sreps and freps are only meaningful when using SSA-NAME3 v1, the SEQUENCES
option has been set in the Search-Definition, and the search and file records contain repeating
groups

265

CALLING FROM COBOL (Z/OS)

FREPS is an array of the ordinal values of the repeating fields in the file record that were used in the
match.
For example, a record structure with a repeating name (2 fields) and a repeating address (2
fields) , if the first name field in the search record matched the second name field in the file
record while the first address field of the source matched the first address field of the file; the
contents of these two arrays would be; sreps[0] = 0, srep[1] = 0, freps[0] = 1, frep[1] = 0

Return Code:
negative for error, 0 for success, and 1 for "end of set".

IDS-SEARCH-GET-COMPLETE
Description:
Retrieve file records which are a good match for the search record specified in the ids_search_start
or ids_system_search_start function. This function will return extended matching information
in the info field as long as the Search-Definition specifies the SEQUENCES option, and SSA-NAME3
v1 is used.

Prototype:
CALL IDSSEARCHGETCOMPLETE USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
SEARCH,
BY REFERENCE
SEARCHRETURN,
BY VALUE
SEARCHRETURNSIZE,
BY REFERENCE
SCORE,
BY REFERENCE
INFO ,
BY VALUE
INFOSIZE
END CALL

Parameters:
SEARCH is the name of the search which was performed.
SEARCHRETURN is an area into which a string from the set is copied.
SCORE is the score calculated for the string.
INFO an encoded list of values used to determine which occurrence of a repeating field matched the
value in the search record. The info field has a length of 4*(1+3*100) bytes. It contains 4 groups, each
one representing the result from one of the four possible scoring phases: Key-Pre-Score, Key-Score,
Pre-Score and Score respectively. If a phase was used, its data starts with a 1, otherwise 0 if the phase
was not used. The indicator is followed by 100 three-digit numbers, one each for each method in the
scoring-scheme for this phase, up to a limit of 100 methods per scheme (scoring phase). The three-digit
number is an index (base 1) representing the occurrence in the file record that was the best match for
the data in the search record.
IDS-SEARCH-GET-COMPLETE

266

Return Code:
negative for error, 0 for success, and 1 for "end of set".

IDS-SEARCH-GET-DETAIL
Description:
Retrieve file records which are a good match for the search record specified in the ids_search_start
or ids_system_search_start function. This function will return extended matching information,
including the match decision and the file (IDT) record-ID of the matching records.

Prototype:
CALL IDSSEARCHGETDETAIL USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
SEARCH,
BY REFERENCE
FILEREC ,
BY VALUE
FILERECSIZE ,
BY REFERENCE
SCORE,
BY REFERENCE
DECISION ,
BY VALUE
DECISIONSIZE ,
BY REFERENCE
FILERECID
END CALL

Parameters:
SEARCH is the name of the Search which was performed.
FILE-REC is the matched File record.
SCORE is the degree of similarity between the Search and File records (0-100).
DECISION is the match decision: A(ccept) or U(ndecided)
FILE-RECID is the File Record-ID (corresponding to the RECID column from the IDT).

Return Code:
negative for error, 0 for success, and 1 for "end of set".

IDS-SEARCH-IDT-GET
Description:
Gets the name of the IDT associated with the search.
267

CALLING FROM COBOL (Z/OS)

Prototype:
CALL IDSSEARCHIDTGET
BY REFERENCE
BY VALUE
BY REFERENCE
BY REFERENCE
BY VALUE
END CALL

USING
RC,
SOCKH,
SEARCHNAME,
IDT ,
IDTSIZE

Parameters:
SEARCHNAME is the name the search to used by the call.
IDT is the area into which the IDT name will be copied

Return Code:
negative for error, 0 for success

IDS-SEARCH-LAYOUT
Description:
Get the names and descriptions of the fields in the current input or output view. If no view has been
defined, the IDT layout will be returned.

Prototype:
CALL IDSSEARCHLAYOUT USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
SEARCH,
BY REFERENCE
VIEWTYPE ,
BY REFERENCE
FUNC,
BY REFERENCE
NAMES,
BY VALUE
NAMESNUM,
BY VALUE
NAMESSIZE,
BY REFERENCE
LENGTHS,
BY VALUE
LENGTHSNUM,
BY REFERENCE
OFFSETS ,
BY VALUE
OFFSETSNUM,
BY REFERENCE
REPEATS ,
BY VALUE
REPEATSNUM,
BY REFERENCE
FORMATS,
BY VALUE
FORMATSNUM,
BY VALUE
FORMATSSIZE
END CALL

Parameters:
SEARCH is the name of the Search which was performed.
VIEWTYPE the type of view: input or output.
IDS-SEARCH-LAYOUT

268

FUNC describes the order of fields.


NAMES is the area into which an array containing the fieldnames will be copied.
LENGTHS is the area into which an array containing the lengths of the fields will be copied.
OFFSETS is the area into which an array containing the offsets of the fields will be copied.
REPEATS is the area into which an array containing the number of repeats in a field will be copied.
FORMATS is the area into which an array containing the format a field will be copied. The format of a
fields is a 50 character string in the following format:
Character 0:

Justification (Left or Right)

Character 1:

Compression (Fixed, Variable or Long)

Characters2 - 3:

Fill (2 characters containing the fill character in hexadecimal)

Character 4:

Fill type (Text or Binary)

Characters 5 - 6:

Base (2 characters containing the base in decimal)

Character 7:

Format (Text, Numeric, Variable or Binary)

Character 8 - 9:

Reserved

Characters 10 - 11:

Binary key number (2 hexadecimal digits)

Character 12:

Character width (Wide, Narrow)

Characters 13 - 50:

Reserved

Note: It is recommended that the FORMATS_SIZE constant be used to prevent errors from
undersized strings.

Return Code:
negative for error, 0 for success

IDS-SEARCH-START
Description:
Performs a search using a pre-constructed search-record (searchrec). Alternatively you can supply
fields (parameters) and have ids_search_start construct the record. The order of the field values
in parameters should be the same as that returned by ids_search_fields_get. You can either search the
database or search against a supplied list of records (records). There is a limit of 64K bytes of data that
can be sent to the Server. If the supplied list of records is too large, split it into smaller groups and make
multiple calls.
Note: The first search for a given System incurs an additional overhead to allocate database
resources and access the Rulebase. Switching between searches on a particular connection
is equivalent to starting a new search and therefore incurs some overhead. Applications requiring the best possible search performance should be designed to avoid switching between
searches. The easiest way to do this is to use separate (dedicated) connections for each Search.

269

CALLING FROM COBOL (Z/OS)

Prototype:
CALL IDSSEARCHSTART USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
SEARCH,
BY REFERENCE
SEARCHWIDTH,
BY REFERENCE
MATCHTOLERANCE,
BY REFERENCE
PARAMETERS,
BY REFERENCE
SEARCHREC,
BY VALUE
SEARCHRECSIZE,
BY REFERENCE
ANSWERSETNAME,
BY REFERENCE
RECS ,
BY REFERENCE
RECORDS
END CALL

Parameters:
SEARCH is the name of the search to be performed.
SEARCH-WIDTH specifies either Narrow, Typical or Exhaustive to nominate how many candidates should be selected. If left blank, the Search_Level in the Controls will be used.
MATCH-TOLERANCE specifies either Conservative, Typical or Loose to nominate how aggressive
the matching scheme should be in rejecting candidates. If left blank, the Match_Level in the Controls
will be used.
PARAMETERS contains the field values used to construct a search record (searchrec). The order
of the field values must correspond to the order of fields returned by ids_search_fields_get. If
insufficient fields are supplied, the remaining fields in the constructed search record will be blank filled.
SEARCHREC is the record that we will search on (in IDT format, or the input view if specified). If
searchrec is specified it will be used to search (provided no parameters are supplied). Alternatively if parameters are specified then the search will be on a record constructed on those parameters
and returned to the user.
ANSWERSETNAME is used store the search results in an AnswerSet. AnswersetName is used to identify
the Search results in the table. The maximum AnswersetName length is 32 characters. If you do not
wish to store the search results in an AnswerSet, set AnswersetName to an empty String.
RECS number of records that matched the search criteria. The count reflects the number of records
prior to sorting the result set. If the sort uses the Unique_Keys option to remove duplicates, the
resulting set may contain less than recs records. In this case, you must use the response code from
ids_search_get to determine when the end of set has been reached.
RECORDS contains a list of records to search on. If you wish to search on the database then specify this
as containing 0 records.

Return Code:
negative for error, 0 for success, and 1 for truncation of the search set, and 2 for exceeding
SEARCH_LIMIT

IDS-SEARCH-TOLERANCES-COUNT
Description:
Returns the match tolerances count that have for the search. The match tolerance defines how aggressively the matching scheme should be in rejecting candidates.
IDS-SEARCH-TOLERANCES-COUNT

270

Prototype:
CALL IDSSEARCHTOLERANCESCOUNT USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
SEARCHNAME,
BY REFERENCE
COUNT
END CALL

Parameters:
SEARCHNAME is the name the search to used by the call.
COUNT is the number of widths for the search by the call.

Return Code:
negative for error, 0 for success

IDS-SEARCH-TOLERANCES-GET
Description:
Returns the match tolerances that have been defined for the search. The match tolerance defines how
aggressively the matching scheme should be in rejecting candidates.

Prototype:
CALL IDSSEARCHTOLERANCESGET USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
SEARCHNAME,
BY REFERENCE
TOLERANCES,
BY VALUE
TOLERANCESNUM,
BY VALUE
TOLERANCESSIZE
END CALL

Parameters:
SEARCHNAME the search to count.
TOLERANCES is the list of null terminated strings returned by the call.

Return Code:
negative for error, 0 for success

IDS-SEARCH-VIEW-GET
271

CALLING FROM COBOL (Z/OS)

Description:
Returns the name of the current input or output view, together with information about the
view: view_field_count is needed to dynamically allocate the arrays used for calls to
ids_search_layout and view_length is used to dynamically allocate memory for input/output
records.

Prototype:
CALL IDSSEARCHVIEWGET USING
BY REFERENCE
RC,
BY VALUE
SOCKH,
BY REFERENCE
SEARCH,
BY REFERENCE
VIEWTYPE ,
BY REFERENCE
VIEWNAME,
BY VALUE
VIEWNAMESIZE,
BY REFERENCE
VIEWFIELDCOUNT,
BY REFERENCE
VIEWRECLEN
END CALL<