Getting Startedwith pureQuery
Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
Chapter 6 – The Client Optimizer: <strong>pureQuery</strong> for Existing Applications 117<br />
6.6.1 Specifying options for the Configure utility<br />
<strong>pureQuery</strong> provides multiple utilities. All of these utilities allow you to specify options on<br />
the command line. For the Configure utility and for some of the other utilities, you can also<br />
specify the <strong>pureQuery</strong>Xml files that the utility should process, along with the options it<br />
should use for each file, in a type of file that is known as an options file. Refer to<br />
Appendix D for a description of options files. <strong>pureQuery</strong> allows two types of options files:<br />
genProps and bindProps. The Configure utility uses genProps files.<br />
An options file is a text file that lists interfaces and <strong>pureQuery</strong>Xml files to be processed,<br />
and the options to apply to each interface or file. Each interface and <strong>pureQuery</strong>Xml file<br />
must be listed on a separate line in the options file, followed by an equal sign (=), and then<br />
any options that <strong>pureQuery</strong> should use when it processes that item. Additionally, in each<br />
options file, you can provide default options on a line that starts with defaultOptions.<br />
<strong>pureQuery</strong> uses each option that you specify on the defaultOptions line for all the<br />
items, except for those items where the option is specified with a different value. Listing<br />
6.3 shows an example of how you would provide default options and <strong>pureQuery</strong>Xml files in<br />
an options file.<br />
defaultOptions = <br />
C:\path1\captureFile1.pdqxml = <br />
C:\path2\captureFile2.pdqxml = <br />
Listing 6.3 - Example of listing default options and <strong>pureQuery</strong>Xml files in an options<br />
file<br />
Refer to the documentation for IBM Optim <strong>pureQuery</strong> Runtime to see the options that are<br />
available for the Configure utility.<br />
6.6.1.1 Specifying option files on the command line<br />
When you specify an options file to the Configure utility on the command line, the utility<br />
configures all of the <strong>pureQuery</strong>Xml files that are in the options file.<br />
6.6.1.2 Specifying option files in Optim Development Studio<br />
<strong>pureQuery</strong>-enabled projects in IBM Optim Development Studio contain a folder named<br />
<strong>pureQuery</strong>Folder. Optim Development Studio automatically runs the Configure utility<br />
for the <strong>pureQuery</strong>Xml files that are in <strong>pureQuery</strong>Folder. Therefore, it is important that<br />
you place the <strong>pureQuery</strong>Xml files that your application uses in <strong>pureQuery</strong>Folder. The<br />
folder also contains two options files: one named Default.genProps, and one named<br />
Default.bindProps. Notice the file Default.genProps in Figure 6.9. IBM Optim<br />
Development Studio uses this options file to provide the options that it uses when it runs<br />
the Configure utility.
Change language