Queries

Con-nect Text Retrieval allows the definition of queries. You can store these TRS queries to perform them in forthcoming sessions. Furthermore, you can store the results of these queries for the current session.

This document covers the following topics:


Adding a Query

Issue the following command sequence from any point in Con-nect:

ADD Query

As a result, the "Add User Query" screen appears.

   4:03 PM                * * *  C O N - N E C T  3  * * *              4.Feb.94
  Cabinet LS                  Add User Query                              Friday
                                                                                
           Folder Work___________ File _______________                          
                                                                                
       Query Name ________________________________                              
                                                                                
      Query Lines Birds_______________________________________________________  
                  ____________________________________________________________  
                  ____________________________________________________________  
                  ____________________________________________________________  
                  ____________________________________________________________  
                  ____________________________________________________________  
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
      Private use _  or Security Read 7  Modify 7  Copy 7  Print 7              
 Complete the information above and press ENTER to add                          
    Command /                                                              /    
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help  Menu  Quit  In    Send  Foldr Docs  Note  Cal   Flip  Last  Home   

In addition to the information which you enter in every "Add" screen (see The "Add" Screens), you must specify the following information in the "Add User Query" screen:

Query Name

A unique name.

Query Lines

You must enter the search criteria as described in section Specifying the Search Criteria for the "Document Text" lines of the "Find TRS Documents" screen.

Press ENTER to add the query.

The blank "Add User Query" screen re-appears and you can add another query or quit the function.

Managing Your Queries

Issue the following command sequence from any point in Con-nect to display a list of all available queries:

DISPLAY Query

As a result, the "Display Queries by Name" screen appears.

   4:04 PM              * * *  C O N - N E C T  3  * * *                4.Feb.94
  Cabinet LS                  Display Queries by Name                     Friday
                                                                                
  Cmd Query Name                       Folder          File          Date Filed 
  --- -------------------------------- --------------- ------------- -----------
  __  Fibers                           Work                             4.Feb.94
  __  Sharks                           Work                             4.Feb.94
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
 Cmds are 1 or 2 characters from the list below (FLIP for PF-keys)              
    Command /                                                              /    
  Display  Erase    File     Modify   Perform  Print    Top                     
                                                                                

The "Display Queries by Name" screen displays all queries alphabetically. The columns display the following information:

Query Name

The name you assigned to the query.

Folder

The name of the folder in which the query is stored.

File

If you specified a file, its name is displayed in this column.

Dated Filed

The date when the query was created (and thus filed).

The command prompting line of the "Display Queries by Name" screen shows all the commands which apply to queries. The commands are described in section Commands. See the following section for a description of how to perform a query.

Performing a Query

You can perform a query to search for specific words. Then you can use the result of that query as a subset to limit future searches to only those documents which are contained in this subset.

Issue the PERFORM command with a query to find the documents which contain the criteria which have been defined for that query.

PERFORM Query name

If documents fulfilling the specified criteria are found, the following screen appears (the number which is shown to the right of the screen name indicates the internal TRS query name for the shown results):

   4:06 PM              * * *  C O N - N E C T  3  * * *                4.Feb.94
  Cabinet LS              Results for Query Number 0101                   Friday
                                                                                
   Find Documents                                                       Found:  
   that contain:    Birds                                                      4
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
   with Subset:     100                                                         
                                                                                
                                                                                
 Mark _ To use result as subset ( X Overwrite OR C - Cancel current subset)     
 Mark _ To save query                                                           
 Mark _ To save results                                                         
                                                                                
 DISPLAY to see found documents or press ENTER to modify criteria               
    Command /                                                              /    
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help  Menu  Quit  In    Send  Foldr Docs  Note  Cal   Flip  Last  Home   

Note:
If no documents fulfilling all specified criteria are found, a similar screen appears in which you have the option to save the contents of the last query for future uses. This is equivalent to adding or modifying a query. If a subset is defined, you can cancel it here.

The number of found documents is indicated in the "Found" column.

If you requested in a former performance of a query to use the results as a subset for further queries, the query number of that query is shown in the "with Subset" line.

If you have defined a subset, only the documents of the subset are searched. You can only use one subset at a time.

Caution:
Subsets are saved for the current session only and are erased when you use another cabinet or leave Con-nect.

You can mark one of the following fields in the "Results for Query Number n" screen:

Mark _ to use result as subset

Optional - you can use the results of this query as a subset for further queries (i.e. only the documents of the subset are searched in further queries. You need not search all documents).

To cancel the current subset, you must mark this field with C and press ENTER.

To overwrite the current subset, you must mark this field with any character except C and press ENTER. As a result a window appears. You enter a description to be stored with the results and press ENTER.

Mark _ to save query

Optional - you can mark this field with any character to save the contents of the query as a query and press ENTER.

This is equivalent to adding or modifying a query.

As a result a window appears. You enter the name of the folder in which you want to store the query (you can also enter the name of a file) and the name of the new query. If the name you enter is already used and if you want to overwrite the existing query, you must mark the "Overwrite Existing?" field with any character and press ENTER.

Mark _ to save results

Optional - you can mark this field with any character to save the results of the query and press ENTER.

As a result a window appears. You enter a description to be stored with the results and press ENTER.

The results are only stored for this session.

To modify the search criteria, you must press ENTER to display the following screen - you must not mark an option:

   4:07 PM               * * *  C O N - N E C T  3  * * *               4.Feb.94
  Cabinet LS                    Find TRS Documents                        Friday
                                                                                
   Find Documents                                                               
   that contain:    Birds_______________________________________________________
                    ____________________________________________________________
                    ____________________________________________________________
                    ____________________________________________________________
                    ____________________________________________________________
                    ____________________________________________________________
                                                                                
                                                                                
                                                                                
   with Subset:     100                                                         
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
 Enter a command, press a PF-key, or enter * to display commands                
    Command /                                                              /    
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help  Menu  Quit  In    Send  Foldr Docs  Note  Cal   Flip  Last  Home   

You can modify the search criteria and press ENTER to return to the "Results for Query Number n" screen which now contains the results of the new query.

Issue the DISPLAY command from the "Results for Query Number n" screen to display the "Display TRS Documents" screen listing all found documents. (If only one document has been found, it is displayed immediately).

The command prompting line of the "Display TRS Documents" screen shows all the commands which apply to documents. The commands are described in section Commands.

When you issue the DISPLAY command with a found document, all occurrences of a specified word are highlighted.

You can also enter DISPLAY in the command line of the "Display TRS Documents" screen to display all found documents listed in the screen (a maximum of 12 documents). You issue the QUIT command to proceed from one document to the next.

When you issue the QUIT command from the "Display TRS Documents" screen, the "Find TRS Documents" screen appears (see above).

Managing Your Results

You can store the results of your queries by marking the appropriate field in the "Results for Query Number n" screen (see Performing a Query).

Caution:
Results are saved for the current session only and are erased when you use another cabinet or leave Con-nect.

Issue the following command sequence from any point in Con-nect to display a list of all currently saved results:

DISPLAY Results

The "Display Results" screen appears.

   4:07 PM               * * *  C O N - N E C T  3  * * *               4.Feb.94
  Cabinet LS                    Display Results                           Friday
                                                                                
  Cmd Description                      Quantity        Query Number  Time Filed 
  --- -------------------------------- --------------- ------------- -----------
  __  (L) * * * Last Query * * *       4               101           16:06      
  __  (S) Bird results                 4               100           16:04      
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
 Cmds are 1 or 2 characters from the list below (FLIP for PF-keys)              
    Command /                                                              /    
  Display  Info     Modify   Top      Use                                       
                                                                                

The "Display Results" screen displays all results chronologically according to their performance time.

The columns display the following information:

Description

The description of the result.

If you did not save the results of the last query, its description is "(L) * * * Last Query * * *".

The currently active subset is marked with (S).

Quantity

The number of found documents.

Query Number

The TRS number of the query name.

Time Filed

The time the results were saved.

Commands for Results

The command prompting line of the "Display Results" screen shows all the commands which apply to the results. The commands are described in section Commands. The following exceptions apply when working with results:

DISPLAY

When you issue the DISPLAY command with a result, the "Display TRS Documents" screen listing all found documents appears. (If only one document has been found, it is displayed immediately).

When you DISPLAY a document, all occurrences of a specified word are highlighted.

INFO

When you issue the INFO command with a result, the contents of the query (which produced this result) is displayed.

MODIFY

When you issue the MODIFY command with a result, you can only modify the description.

USE

You can use results as subsets.

To use a specific result as the new subset, you issue the USE command with that result. The new subset will be marked with (S) and all subsequent queries will be performed on the new subset.

If you choose to use the results of the last query, which is marked with (L), a window appears, prompting you to enter a description for the result.