//+-------------------------------------------------------------------------
//
//  THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
//  ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
//  THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
//  PARTICULAR PURPOSE.
//
//  Copyright (c) 1998-1999 Microsoft Corporation.  All Rights Reserved.
//
//  Sample Name:    VJQuery - Sample Visual J++ Query Application
//
//--------------------------------------------------------------------------

Description
===========
  The VJQuery sample is an example command-line application written in
  Visual J++ that illustrates how to query Indexing Service using the SQL
  query language and the ADO API.

Path
====
  Source: mssdk\samples\winbase\indexing\VJQuery\
  
User's Guide
============
  * To build the sample
      1. In the Visual J++ development environment, open the
         VJQuery.vjp project from the source path of the sample.
      2. In the Build menu, select Build.

  * To execute a default query using the sample
      1. Make sure that Indexing Service is started.
      2. In the Debug menu, select Start.
      3. In the JView window, read the results of the default SQL query
      
         SELECT Filename, Size, Write, Path
           FROM SCOPE('DEEP TRAVERSAL OF "\"')
           WHERE CONTAINS('"Indexing Service"')

  * To specify a complete SQL statement for a query using the sample
      1. Make sure that Indexing Service is started.
      2. Set the PATH environment variable to include "D:\mssdk\Bin",
         where D: is the drive on which you installed the Platform SDK.
      3. Open a command window and change the directory to the path of the
         built sample.
      4. Formulate a query that you know will succeed.  You need to know the
         machine, catalog, scope, and query text.
      5. Submit a complete SQL statement by entering, at the command-line
         prompt,
         
         jview /p /cp:p "<JAVAPACKAGES>" VJQuery -s <Statement>
           
         where <Statement> is a complete SQL statement such as the
         preceding default SQL query.  You must escape any double-quote
         characters in the text of the <Statement> parameter.

  * To specify only a WHERE clause for a query using the sample
	  1. Make sure that Indexing Service is started.
	  2. Set the PATH environment variable to include "D:\mssdk\Bin",
	     where D: is the drive on which you installed the Platform SDK.
	  3. Open a command window and change the directory to the path of the
	     built sample.
	  4. Formulate a query that you know will succeed.  You need to know the
	     machine, catalog, scope, and query text.
      5. Submit text for a WHERE clause that is concatenated to the
         following incomplete, fixed SQL statement
         
         SELECT Filename, Size, Write, Path
           FROM SCOPE('DEEP TRAVERSAL OF "\"')
           WHERE
         
         by entering, at the command-line prompt,

         jview /p /cp:p "<JAVAPACKAGES>" VJQuery <Where_Text>

         where <Where_Text> is the desired text to follow the WHERE keyword.
         You must escape any double quotes in the text of the <Where_Text>
         parameter.  For example, to duplicate the default SQL query, enter

         jview /p /cp:p "<JAVAPACKAGES>" VJQuery CONTAINS('\"Indexing Service\"')

Programming Notes
=================
  The Query class has methods that set the text of the query, execute the
  query, and display the results of the query.
    * Either the SetRawSql method or the SetSqlWhere method sets the
      m_SqlText variable to the specified SQL statement.
    * The Execute method executes the query.  It creates an ADO Recordset
      object and executes the query by opening the object with the SQL text
      and the OLE DB Provider for Indexing Service.
    * The Display method enumerates the resulting values of the fields from
      the Recordset object and prints them.