16.10.2015 Views

Getting Startedwith pureQuery

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

E<br />

Appendix E - Options Files<br />

This appendix discusses options files. You can use options files to specify the options<br />

that you want the Generator utility, the Configure utility, and the StaticBinder utility to use.<br />

E.1 Options files: The big picture<br />

<strong>pureQuery</strong> provides multiple utilities. All of these utilities allow you to specify options on<br />

the command line. For the Generator utility, the Configure utility, and the StaticBinder<br />

utility, you can also specify the <strong>pureQuery</strong>Xml files or interfaces that you want the utility to<br />

process, along with the options that you want the utility to use, in a type of file that is known<br />

as an options file.<br />

<strong>pureQuery</strong> allows two types of options files: genProps, which is used for the Configure<br />

utility (described in Section 9.6) and the Generator utility (described in Section 6.3), and<br />

bindProps, which is used for the StaticBinder utility (described in Chapter 10). The<br />

contents of the two types of options files are mostly the same, but they have a few<br />

differences. The convention is to use .genProps as the file extension for genProps files,<br />

and .bindProps as the file extension for bindProps files.<br />

Options files make it easy to run a utility one time, while specifying many interfaces or<br />

<strong>pureQuery</strong>Xml files, each processed using distinct options. Additionally, if you want IBM<br />

Optim Development Studio to run the utility for you, the only way you can specify options is<br />

by using options files.<br />

The IBM Optim <strong>pureQuery</strong> Runtime documentation for the utilities provides details about<br />

using options files from the command line. The IBM Optim Development Studio<br />

documentation provides details about using genProps and bindProps files in the tool.<br />

E.2 Content of options 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. The extensions of<br />

<strong>pureQuery</strong>Xml files must be either .pdqxml or .xml.

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!