Viewing Results of the rcvdk Utility

After you have attached to a collection and issued a search command successfully, you can view the results list and look at the retrieved documents. You can use the options in the following table:

Option

Description

r
Displays the results list, starting with the first document. A maximum of 24 documents will be displayed.

r n
Displays the results list, starting with the nth document. A maximum of 24 documents will be displayed.

v
Displays the first or next document in the results list. Highlights are indicated using reverse video, if possible. If not, double angle brackets are used, as in:
>>universal<< >>filter<<
To exit the document display, enter "q".

v n
Displays the nth document in the results list. To exit the document display, enter "q".

Option	Description
r	Displays the results list, starting with the first document. A maximum of 24 documents will be displayed.
r n	Displays the results list, starting with the nth document. A maximum of 24 documents will be displayed.
v	Displays the first or next document in the results list. Highlights are indicated using reverse video, if possible. If not, double angle brackets are used, as in: >>universal<< >>filter<< To exit the document display, enter "q".
v n	Displays the nth document in the results list. To exit the document display, enter "q".

The results list for the "universal filter" search is shown below. For each document, these fields are displayed by default: Number, Score, and VdkVgwKey.

RC> r

Retrieved: 18(18)/85

Number SCORE VdkVgwKey

1: 1.00 d:\search97\s97is\locale\english\doc\collbldg\08_cbg3.htm

2: 0.97 d:\search97\s97is\locale\english\doc\collbldg\11_cbg2.htm

3: 0.97 d:\search97\s97is\locale\english\doc\collbldg\08_cbg7.htm

4: 0.97 d:\search97\s97is\locale\english\doc\collbldg\08_cbg1.htm

5: 0.95 d:\search97\s97is\locale\english\doc\collbldg\cbgtoc.htm

6: 0.95 d:\search97\s97is\locale\english\doc\collbldg\08_cbg4.htm

7: 0.93 d:\search97\s97is\locale\english\doc\collbldg\cbgix.htm

8: 0.92 d:\search97\s97is\locale\english\doc\collbldg\08_cbg6.htm

9: 0.90 d:\search97\s97is\locale\english\doc\collbldg\08_cbg.htm

10: 0.90 d:\search97\s97is\locale\english\doc\collbldg\04_cbg1.htm

11: 0.90 d:\search97\s97is\locale\english\doc\collbldg\01_cbg1.htm

12: 0.87 d:\search97\s97is\locale\english\doc\collbldg\f_cbg.htm

13: 0.87 d:\search97\s97is\locale\english\doc\collbldg\08_cbg2.htm

14: 0.84 d:\search97\s97is\locale\english\doc\collbldg\06_cbg1.htm

15: 0.80 d:\search97\s97is\locale\english\doc\collbldg\part4.htm

16: 0.80 d:\search97\s97is\locale\english\doc\collbldg\f_cbg1.htm

17: 0.80 d:\search97\s97is\locale\english\doc\collbldg\11_cbg5.htm

18: 0.80 d:\search97\s97is\locale\english\doc\collbldg\08_cbg5.htm

RC>

The following table describes each of the default fields:

Field Name

Description

Number
The rank of the document in the results list. The document with the highest score is ranked number 1.

Score
The score assigned to each retrieved document, based on its relevance to the query. For a NULL query, no scores are assigned, so the Score column in the results list is blank.

VdkVgwKey
The document key used by the Verity engine to manage the document. If the document is accessed through the file system, the primary key is a path name. If the document is accessed through a web server, using HTTP, the primary key is a URL.

Field Name	Description
Number	The rank of the document in the results list. The document with the highest score is ranked number 1.
Score	The score assigned to each retrieved document, based on its relevance to the query. For a NULL query, no scores are assigned, so the Score column in the results list is blank.
VdkVgwKey	The document key used by the Verity engine to manage the document. If the document is accessed through the file system, the primary key is a path name. If the document is accessed through a web server, using HTTP, the primary key is a URL.

Displaying more fields

You can tell rcvdk to display certain fields in the results list using the fields command, which is available in the expert mode. To go to the expert mode, enter x or expert at the RC> prompt, then press return.

All fields in a column will be blank if the field is not defined for the collection's schema in the documents table (in style.ddd, style.sfl, or style.ufl). A field in a document's row will be blank if the field was not populated by a gateway, bulk submit action, or filter.

How to display a field

The fields command includes the field name and length to be displayed. When used, the fields command overrides the default fields for the results list, Score and VdkVgwKey.

Fields for the results list are returned by the search engine, so if you have done a search, then go to expert mode to use the fields command, you must run the search again in order to see the results list with the fields you requested.

RC> expert

Expert mode enabled

RC> fields title 20

RC> s universal filter

Search update: finished (100%). Retrieved: 18(18)/85.

RC> r

Retrieved: 18(18)/85

Number title

1: Using the Universal Filter

2: Using the Zone Filter

3: The Zone Filter

4: Overview

5: Table of Contents

6: Universal Filter Configuration Using the

7: Index

8: The PDF Filter

9: Document Filters and Formatting

10: Collection Style Summary

11: Collection Basics

12: Universal Filter Document Types

13: Using the style.dft File

14: Supported Field Types

15:

16: Recognized Document Types

17: Custom Zone Definitions

18: The KeyView Filter Kit

RC>

How to display multiple fields

Multiple fields can be specified with the fields command, as shown below. The field order corresponds to the order of the columns, with the first field specified appearing in the second column. The first column is reserved for the rank order.

Remember to re-run the search before you display the results list with the fields specified.

RC> fields score 5 title 40

RC> s universal filter

Search update: finished (100%). Retrieved: 18(18)/85.

RC>

Advanced ColdFusion Administration
Verity Troubleshooting Utilities