Progress
Results Administration
and Development Guide


Editing a QD7 File

A QD7 file (query directory file) contains query definitions. Results creates and maintains three distinct types of query directory files. The public query directory (public.qd7) contains query definitions accessible by all or a select group of users. Results also automatically generates a query directory for each user (userid.qd7) and uses the user ID as part of the query directory filename. For users who have the blank user ID, Results creates the results.qd7 query directory file to store the query definitions of that user.

A single QD7 file can contain up to 256 query definitions. There is a query definition per line in a QD7 file and each definition has the following syntax:

SYNTAX
query[integerID]= "obsolete" "queryname" "dblist" 

A query definition has a unique integer identifier, a name, and a comma-separated list containing the names of databases connected during the creation of the query. Leave the obsolete parameter empty.

Results uses the integer identifier to relate a query definition in a QD7 file with the query source file (que#####.p). For example, a query definition number 5 has a corresponding query source file named que00005.p. The query source files associated with the query definitions in a QD7 file must be located in the same operating system directory as the QD7 file.

The integer identifier for a query definition is unique across all query definitions in all QD7 files in a single operating system directory. An operating system directory can contain up to 99,999 query source files. Based on this limit and the fact that a QD7 file can contain up to 256 query definitions, do not place more than 390 QD7 files in a single operating system directory.

By default, Results creates QD7 files in the user’s working directory. After Results creates a QD7 file, you can move the file to a directory in the PROPATH. If you move a QD7 file to a new directory, you must move all query source files associated with the QD7 file to the same directory. If another QD7 file already exists in the new directory, you might have to change the integer identifiers for query definitions and the name of associated query source files to ensure that queries are unique in the operating system directory.

See "Administering Results," for more information about QD7 files.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095