<html>
<head>
<link href="mmres://user_interface_reference.css" rel="stylesheet" type="text/css">
<title>CFSEARCH</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
   <div id="Description">
   <table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
      <tr> 
         <td valign="top" class="name">CFSEARCH</td>
         <td valign="top" nowrap class="compatibility">&nbsp;</td>
      </tr>
      <tr>
         <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
      </tr>


    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Description</span>
<p>
Searches one or more Verity collections.
</p>

<p>
A collection must be created and indexed before this tag can return search results.
</p>

<p>
A collection can be created in these ways:
</p>
<ul>

<li>With the cfcollection tag</li>

<li>In the ColdFusion&#160;MX Administrator </li>

<li>Using a native Verity indexing tool, such as Vspider or MKVDK. For more information on Vspider and MKVDK, see Chapter&#160;8, "Introducing Verity and Verity Tools" in Configuring and Administering ColdFusion&#160;MX.</li>
</ul>

<p>
If you use a native Verity tool to create a collection, it must be registered. A collection can be registered with ColdFusion in the following ways:
</p>
<ul>

<li>With the cfcollection tag</li>

<li>In the ColdFusion&#160;MX Administrator</li>
</ul>

<p>
A collection can be indexed in the following ways:
</p>
<ul>

<li>In ColdFusion, with the cfindex tag</li>

<li>In the ColdFusion MX Administrator, which calls the cfindex tag </li>

<li>Using a native Verity indexing tool, such as Vspider or MKVDK </li>
</ul>

<p>
For more information, see Chapter&#160;24, "Building a Search Interface" in ColdFusion MX Developer's Guide.
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Category</span>
<p>
Extensibility tags
</p>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="syntax"><span class="title">Syntax</span><pre>&lt;cfsearch 
   name = &quot;search_name&quot;
   collection = &quot;collection_name&quot;
category = &quot;category[,category2,...]&quot;
categoryTree = &quot;tree_location&quot;
   status = &quot;&quot;
   type = &quot;criteria&quot;
   criteria = &quot;search_expression&quot;
   maxRows = &quot;number&quot;
   startRow = &quot;row_number&quot;
   suggestions = &quot;suggestion_option&quot;
   contextPassages = &quot;number_of_passages&quot;
   contextBytes = &quot;number_of_bytes&quot;
   contextHighlightBegin = &quot;html_string&quot;
   contextHighlightEnd = &quot;html_string&quot;
   previousCriteria = &quot;criteria&quot;
   language = &quot;language&quot;&gt;
</pre>    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">See also</span>
<p>
cfcollection, cfexecute, cfindex, cfobject, cfreport, cfwddx
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">History</span>
<p>
ColdFusion&#160;MX&#160;7: 
</p>
<ul>

<li>Added category, categoryTree, status, suggestions, contextPassages, contextBytes, contextHighlightBegin, contextHighlightEnd, and previousCriteria attributes. </li>

<li>Added author, category, categoryTree, context, rank, size, recordsSearched, and type result columns.</li>

<li>Added information on the status structure and its associated keys.</li>

<li>Removed references to a separate K2 server and k2server.ini file.</li>

<li>Removed references to unregistered collections.</li>

<li>Removed references to external collections. ColdFusion&#160;MX now manages all collections through the Verity Search service.</li>

<li>Changed cflock recommendation. It is no longer a best practice to surround the cfsearch tag with a cflock tag.</li>
</ul>

<p>
ColdFusion&#160;MX: 
</p>
<ul>

<li>Deprecated the external attribute. It might not work, and might cause an error, in later releases. (ColdFusion stores this information about each collection; it automatically detects whether a collection is internal or external.) This tag supports absolute (also known as fully qualified) collection pathnames and mapped collection names. </li>

<li>Changed query result behavior: the cfindex tag can index the query results from a cfsearch operation. </li>

<li>Changed Verity operations behavior: ColdFusion supports Verity operations on Acrobat PDF files.</li>

<li>Changed multiple collection behavior: this tag can search multiple collections. In a multiple collection search, you cannot combine collections that are registered with K2Server and registered in another way.</li>

<li>Changed acceptable collection naming: this tag accepts collection names that include spaces. </li>

<li>Changed the following support: this tag supports Verity 2.6.1 and the LinguistX and ICU locales. </li>

<li>Changed thrown exceptions: this tag can throw the SEARCHENGINE exception.</li>
</ul>

<p>

</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Usage</span>
<p>
The cfsearch tag returns a query object whose columns you can reference in a cfoutput tag. For example, the following code specifies a search for the exact terms &quot;filming&quot; or &quot;filmed&quot;:
</p>
<pre>&lt;cfsearch
name = &quot;mySearch&quot;
collection = &quot;myCollection&quot;
criteria = &#39;&lt;WILDCARD&gt;`film{ing,ed}`&#39;
type=&quot;explicit&quot;
startrow=1
   maxrows = &quot;100&quot;&gt;
&lt;cfdump var = &quot;#mySearch#&gt;
</pre>
<p>
In this example, the single-quotation mark (&#39;) and backtick (`) characters are used as delimiters; for more information, see Chapter&#160;25, "Using Verity Search Expressions" in ColdFusion MX Developer's Guide.
</p>

<p>
To optimize search performance, always specify the maxrows attribute, setting it to a value that matches your application's needs. A value less than 300 helps to ensure optimal performance.
</p>

<p>
Macromedia does not recommend using the cflock tag with this tag; Verity provides the locking function. Using the cflock tag slows search performance.
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">The cfsearch tag result columns</span>
<p>
</p><div align="left">
<table border="1">
  <caption></caption>
  <tr align="center">    <th>&#160;</th>
    <th>&#160;</th>
</tr>
  <tr align="left">    <td><pre>context
</pre></td>
    <td>
<p>A context summary containing the search terms, highlighted in bold (by default). This is enabled if you set the contextpassages attribute to a number greater than zero.</p></td>
</tr>
  <tr align="left">    <td><pre>url
</pre></td>
    <td>
<p>Value of URLpath attribute in the cfindex tag used to populate a collection.</p></td>
</tr>
  <tr align="left">    <td><pre>key
</pre></td>
    <td>
<p>Value of the key attribute in the cfindex tag used to populate a collection.</p></td>
</tr>
  <tr align="left">    <td><pre>title
</pre></td>
    <td>
<p>Value of title attribute in cfindex tag used to populate the collection, including PDF and Office document titles. If a title is not extracted from the document, the tag uses the cfindex title attribute value for each row. </p></td>
</tr>
  <tr align="left">    <td><pre>score
</pre></td>
    <td>
<p>Relevancy score of document based on search criteria</p></td>
</tr>
  <tr align="left">    <td><pre>custom1, custom2,
custom3, custom4
</pre></td>
    <td>
<p>Value of custom fields in cfindex tag used to populate a collection.</p></td>
</tr>
  <tr align="left">    <td><pre>size
</pre></td>
    <td>
<p>The number of bytes in the index document.</p></td>
</tr>
  <tr align="left">    <td><pre>rank
</pre></td>
    <td>
<p>The rank of this document in the search results. </p></td>
</tr>
  <tr align="left">    <td><pre>author
</pre></td>
    <td>
<p>Extracted from the HTML, Office, and PDF documents when available.</p></td>
</tr>
  <tr align="left">    <td><pre>type
</pre></td>
    <td>
<p>The MIME type of the document. </p></td>
</tr>
  <tr align="left">    <td><pre>category
</pre></td>
    <td>
<p>A list of the categories that were specified for this document when it was indexed.</p></td>
</tr>
  <tr align="left">    <td><pre>categoryTree
</pre></td>
    <td>
<p>A hierarchical category tree, or serial list of categories, that was specified for this document when it was indexed. Only a single tree is returned.</p></td>
</tr>
  <tr align="left">    <td><pre>summary
</pre></td>
    <td>
<p>Contents of automatic summary generated by cfindex. </p></td>
</tr>
  <tr align="left">    <td><pre>recordCount
</pre></td>
    <td>
<p>Number of records returned in record set</p></td>
</tr>
  <tr align="left">    <td><pre>currentRow
</pre></td>
    <td>
<p>Current row that cfoutput is processing.</p></td>
</tr>
  <tr align="left">    <td><pre>columnList
</pre></td>
    <td>
<p>List of column names within record set.</p></td>
</tr>
  <tr align="left">    <td><pre>recordsSearched
</pre></td>
    <td>
<p>Number of records searched. This is the same value for each row in the record set. Corresponds to the searched key in the status structure.</p></td>
</tr>
</table>
</div>
<p>
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Status structure keys</span>
<p>
</p><div align="left">
<table border="1">
  <caption></caption>
  <tr align="center">    <th>&#160;</th>
    <th>&#160;</th>
</tr>
  <tr align="left">    <td><pre>found
</pre></td>
    <td>
<p>The number of documents that contain the search criteria. </p></td>
</tr>
  <tr align="left">    <td><pre>searched
</pre></td>
    <td>
<p>The number of documents searched. Corresponds to the recordsSearched column in the search results. </p></td>
</tr>
  <tr align="left">    <td><pre>time
</pre></td>
    <td>
<p>The number of milliseconds the search took, as reported by the Verity K2 search service. </p></td>
</tr>
  <tr align="left">    <td><pre>suggestedQuery
</pre></td>
    <td>
<p>An alternative query, as suggested by Verity, that might produce better results. This often contains corrected spellings of search terms. Present only when the suggestions tag attribute criteria is met.</p></td>
</tr>
  <tr align="left">    <td><pre>keywords
</pre></td>
    <td>
<p>A structure containing each search term as a key to an array of up to five possible alternative terms, in order of preference. Present only when the suggestions attribute criteria is met.</p></td>
</tr>
  <tr align="left">    <td><pre>keywordScore
</pre></td>
    <td>
<p>A structure in the same format as for keywords, except it also includes Verity-reported weighted values from 0 to .99, in which higher scores indicate better-quality results.</p></td>
</tr>
</table>
</div>
<p>
</p>

<p>
To permit application users to search Verity collections for nonstandard strings, words, or characters (for example, &quot;AB23.45.67&quot; or &quot;---&gt;&quot;) that would otherwise cause an error, you can create a text file that lists these elements and defines their formats for Verity. Name the file style.lex and put copies of the file in these directories:
</p>
<ul>

<li>Windows: </li>
<ul>

<li>cf_root\verity\k2\common\style (typically, cf_root = C:\CFusionMX7)</li>

<li>cf_root\verity\Data\stylesets\ColdFusionK2</li>
</ul>

<li>UNIX: </li>
<ul>

<li>cf_root//verity/k2/common/style (typically, cf_root = /opt/coldfusionmx7)</li>

<li>cf_root/verity/Data/stylesets/ColdFusionK2 </li>
</ul>
</ul>

<p>
In the multiserver and J2EE configurations, you install Verity in a separate directory.
</p>
<table>
  <tr valign="top">
    <td width="30"><strong>Note: </strong></td>
    <td>To search for a character such as an angle bracket (&lt; or &gt;), you must use a criteria attribute value such as &quot;&amp;lt:&quot; or &quot;&amp;lt:&quot;. The bracket characters are reserved in Verity, and using a backslash to escape the character (criteria=&quot;\&lt;&quot;) does not work in this context. For more information, see Chapter&#160;25, "Using Verity Search Expressions" in ColdFusion MX Developer's Guide.</td>
  </tr>
</table>    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Example</span><pre>&lt;!--- #1 (TYPE=SIMPLE) -----------------------------&gt;
&lt;cfsearch 
   name=&quot;name&quot; 
   collection=&quot;snippets,syntax,snippets&quot; 
   criteria=&quot;example&quot; 
   maxrows = &quot;100&quot;&gt;
&lt;p&gt;
&lt;cfoutput&gt;Search Result total =  #name.RecordCount# &lt;/cfoutput&gt;&lt;br&gt;
&lt;cfoutput&gt;
   url=#name.url#&lt;br&gt;
   key=#name.key#&lt;br&gt;
   title=#name.title#&lt;br&gt;
   score=#name.score#&lt;br&gt;
   custom1=#name.custom1#&lt;br&gt;
   custom2=#name.custom2#&lt;br&gt;
   summary=#name.summary#&lt;br&gt;
   recordcount=#name.recordcount#&lt;br&gt;
   currentrow=#name.currentrow#&lt;br&gt;
   columnlist=#name.columnlist#&lt;br&gt;
   recordssearched=#name.recordssearched#&lt;br&gt;
&lt;/cfoutput&gt;
&lt;cfdump var = #name#&gt;
&lt;br&gt;

&lt;!--- #2 (TYPE=EXPLICIT) -----------------------------&gt;
&lt;cfsearch 
   name = &quot;snippets&quot;
   collection = &quot;snippets&quot;
   criteria = &#39;&lt;wildcard&gt;`film{ing,ed}`&#39;
   type=&quot;explicit&quot;
   startrow=1
   maxrows = &quot;100&quot;&gt;
&lt;cfoutput 
   query=&quot;snippets&quot;&gt;
   url=#url#&lt;br&gt;
   key=#key#&lt;br&gt;
   title=#title#&lt;br&gt;
   score=#score#&lt;br&gt;
   custom1=#custom1#&lt;br&gt;
   custom2=#custom2#&lt;br&gt;
   summary=#summary#&lt;br&gt;
   recordcount=#recordcount#&lt;br&gt;
   currentrow=#currentrow#&lt;br&gt;
   columnlist=#columnlist#&lt;br&gt;
   recordssearched=#recordssearched#&lt;br&gt;
&lt;/cfoutput&gt;
&lt;cfdump var = #snippets#&gt; 
&lt;br&gt;

&lt;!--- #3 (search by CF key) -----------------------------&gt;
&lt;cfsearch 
   name = &quot;book&quot;
   collection = &quot;custom_book&quot;
   criteria = &quot;cf_key=bookid2&quot;
   maxrows = &quot;100&quot;&gt;
&lt;cfoutput&gt;
   url=#book.url#&lt;br&gt;
   key=#book.key#&lt;br&gt;
   title=#book.titleE#&lt;br&gt;
   score=#book.score#&lt;br&gt;
   custom1=#book.custom1#&lt;br&gt;
   custom2=#book.custom2#&lt;br&gt;
   summary=#book.summary#&lt;br&gt;
   recordcount=#book.recordcount#&lt;br&gt;
   currentrow=#book.currentrow#&lt;br&gt;
   columnlist=#book.columnlist#&lt;br&gt;
   recordssearched=#book.recordssearched#&lt;br&gt;
&lt;/cfoutput&gt;
&lt;cfdump var = #book#&gt; 
</pre>
         </td>
      </tr>
   </table>
   </div>
<div id="NAME">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">NAME</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Required</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>Name of the search query. </p>

  </td>
  </tr>
  </table>
</div>
<div id="COLLECTION ">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">COLLECTION </td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Required</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>One or more collection names. You can specify more than one collection unless you are performing a category search (that is, specifying category or categoryTree).</p>

  </td>
  </tr>
  </table>
</div>
<div id="CATEGORY">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">CATEGORY</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>A list of categories, separated by commas, to which the search is limited. If specified, and the collection does not have categories enabled, ColdFusion throws an exception.</p>

  </td>
  </tr>
  </table>
</div>
<div id="CATEGORYTREE">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">CATEGORYTREE</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>The location in a hierarchical category tree at which to start the search. ColdFusion searches at and below this level. If specified, and the collection does not have categories enabled, ColdFusion throws an exception. Can be used in addition to the category attribute.</p>

  </td>
  </tr>
  </table>
</div>
<div id="STATUS">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">STATUS</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>Specifies the name of the structure variable into which ColdFusion places search information, including alternative criteria suggestions (spelling corrections). For a list of keys in this structure, see "Status structure keys" on&#160;page&#160;636.</p>

  </td>
  </tr>
  </table>
</div>
<div id="TYPE ">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">TYPE </td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "simple "


<p>Used to specify the parser that Verity uses to process the criteria.</p><ul>

<li>simple: STEM and MANY operators are implicitly used. </li>

<li>explicit: operators must be invoked explicitly. Also known as Bool_Plus.</li>

<li>internet: for documents that are mostly WYSIWIG (what-you-see-is-what-you-get) documents. Also known as Internet_advanced.</li>

<li>internet_basic: minimizes search time.</li>

<li>natural: specifies the Query By Example (QBE) parser. Also known as FreeText.</li>
</ul>

<p>For more information, see Chapter&#160;25, "Using Verity Search Expressions" in ColdFusion MX Developer's Guide. Also see your Verity documentation.</p>

  </td>
  </tr>
  </table>
</div>
<div id="CRITERIA">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">CRITERIA</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>Search criteria. Follows the syntax rules of the type attribute. If you pass a mixed-case entry in this attribute, the search is case-sensitive. If you pass all uppercase or all lowercase, the search is case-insensitive. Follow Verity syntax and delimiter character rules; see Chapter&#160;25, "Using Verity Search Expressions" in ColdFusion MX Developer's Guide.</p>

  </td>
  </tr>
  </table>
</div>
<div id="MAXROWS">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">MAXROWS</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "All"


<p>Maximum number of rows to return in query results.</p>

  </td>
  </tr>
  </table>
</div>
<div id="STARTROW">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">STARTROW</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "1"


<p>First row number to get.</p>

  </td>
  </tr>
  </table>
</div>
<div id="SUGGESTIONS">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">SUGGESTIONS</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "never"


<p>Specifies whether Verity returns spelling suggestions for possibly misspelled words. Use one of the following options:</p><ul>

<li>Always: Verity always returns spelling suggestions.</li>

<li>Never: Verity never returns spelling suggestions.</li>

<li>positive integer: Verity returns spelling suggestions if the number of documents retrieved by the search is less than or equal to the number specified. </li>
</ul>

<p>There is a small performance penalty for retrieving suggestion data.</p>

  </td>
  </tr>
  </table>
</div>
<div id="CONTEXTPASSAGES">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">CONTEXTPASSAGES</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "0"


<p>The number of passages/sentences Verity returns in the context summary (that is, the context column of the results). The default i s 0, which disables context summary.</p>

  </td>
  </tr>
  </table>
</div>
<div id="CONTEXTBYTES">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">CONTEXTBYTES</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "300"


<p>The maximum number of bytes Verity returns in the context summary. </p>

  </td>
  </tr>
  </table>
</div>
<div id="CONTEXTHIGHLIGHTBEGIN">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">CONTEXTHIGHLIGHTBEGIN</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "&lt;b&gt;"


<p>The HTML to prepend to search terms in the context summary. Use this attribute in conjunction with contextHighlightEnd to highlight search terms in the context summary.</p>

  </td>
  </tr>
  </table>
</div>
<div id="CONTEXTHIGHLIGHTEND">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">CONTEXTHIGHLIGHTEND</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "&lt;/b&gt;"


<p>The HTML to append to search terms in the context summary. Use this attribute in conjunction with contextHighlightBegin to highlight search terms in the context summary.</p>

  </td>
  </tr>
  </table>
</div>
<div id="PREVIOUSCRITERIA">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">PREVIOUSCRITERIA</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>The name of a result set from an existing set of search results. Verity searches the result set for criteria without regard to the previous search score or rank. Use this attribute to implement searching within result sets.</p>

  </td>
  </tr>
  </table>
</div>
<div id="LANGUAGE">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">LANGUAGE</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "english"


<p>Deprecated. This attribute is now ignored and the language of the collection is used to perform the search. </p>

  </td>
  </tr>
  </table>
</div>

  </body>
</html>
