Getting Startedwith pureQuery

356
Getting Started with pureQuery
All of the options for an entry must be on a single line; that is, a line break signals the
beginning of the next entry. For each line, all of the characters to the left of the equal sign
are considered part of the interface or pureQueryXml file name, so do not include any
quotation marks or other characters that you do not want to be part of the name. The
options and values to the right of the equal sign are space-separated, just as they are on
the command line. Therefore, to the right of the equal sign, if the value of an option
contains a space, you must surround the value in double quotes.
In genProps files, you can only provide one entry for each interface or pureQueryXml file.
You can provide multiple entries for the interfaces and pureQueryXml files that are in a
bindProps file, however. It does not make sense to allow duplicate entries in genProps
files, since the Generator utility and the Configure utility would repeatedly create or modify
the same file. On the other hand, it makes sense for the StaticBinder utility to process a
single interface or pureQueryXml file more than once; for example, you might want to bind
the SQL in one interface or file in multiple database servers.
Listing E.18.2 shows how you could specify two interfaces, two pureQueryXml files, and
one statement set of a third pureQueryXml file in an options file. You can specify specific
statement sets only for the StaticBinder utility, so the last line of the listing is only valid in a
bindProps file.
myPackage1.MyInterface1 =
myPackage1.MyInterface2 =
C:\path1\captureFile1.pdqxml =
C:\path2\captureFile2.pdqxml =
C:\path3\captureFile3.pdqxml:MYPKGA =
Listing E.18.2 - Example of listing interfaces and pureQueryXml files in an options
file
Additionally, in each options file, you can provide default options on a line that starts with
defaultOptions. pureQuery uses each option that you specify on the
defaultOptions line for all the items, except for those items where the option is
specified with a different value. You can only specify one line that starts with
defaultOptions. Listing E.18.3 shows how you could specify these options.
defaultOptions =
Listing E.18.3 - Example of listing defaultOptions in an options file
In addition to lines of options, you can have comments in an options file. Use the #
character to designate lines as comments, as in Listing E.18.4:
# This line is a comment
Listing E.18.4 - Example of a comment in an options file
If you run a utility from the command line and specify an options file, you can specify some
of the options on the command line as well. When you specify an option both on the