Table of Contents

Search

  1. Preface
  2. Introduction
  3. Defining a System
  4. Flattening IDTs
  5. Link Tables
  6. Loading a System
  7. Static Clustering
  8. Simple Search
  9. Search Performance
  10. Miscellaneous Issues
  11. Limitations
  12. Error Messages

Tracing a Search

Tracing a Search

The Search Server can create a detailed trace file showing:
  • the search record (in IDT format)
  • all candidate records selected using the defined Search-Logic
  • the results of matching the search record with each candidate record

API

This can be enabled from an API program by specifying
LOGTEST=
in the
options
parameter of the
ids_system_open call
:
LOGTEST="<full_path_of_log_file>"

relate

The batch search utility relate will create a trace file when the
--3
switch in used to nominate the name of the trace file. For example,
%SSABIN%\relate --3%SSAWORKDIR%\mysearch.trc

Java Search Client

The Java Search Client can create a trace file. This is enabled / disabled with the menu item
Options
Create Trace File
which toggles tracing on and off.
The default trace filename is
%SSAWORKDIR%\SystemName.trc
A different filename may be specified with
Options
Set Trace Filename
.
The trace file is written with buffered I/O. It is not completely flushed to disk until the user closes the current search. The Search Client will do this automatically when
  • tracing is turned off, or
  • you switch to a different Search, or
  • the application is closed.

Sample Output

An annotated trace output file is provided to demonstrate how to interpret the information found in the trace. The file is located in the Server’s bin directory and is named
%SSABIN%\srchtrc.txt

0 COMMENTS

We’d like to hear from you!