In this file, you can specify options that apply to all of the interfaces that are in your project. You can also specify options specific to individual interfaces.
You can add comments to this file. Begin each comment with a # symbol.
As you create or edit entries, you can type CTRL+SPACE (or your own keystroke, if you changed this default one) for assistance.
For help understanding syntax diagrams, see How to read syntax diagrams.
The following diagram shows the syntax that is allowed for setting default options for all of the interfaces that the file lists.
>>-defaultOptions--=--------------------------------------------> >--+---------------------------------------------+--------------> '- -baseDataOverride--Java-package.class-name-' >--+-----------------------------------+------------------------> | .-NULLID----------. | '- -collection--+-collection-name-+-' >--+--------------------------------+---------------------------> '- -pkgVersion-- -+-AUTO-------+-' '-version-ID-' >--+---------------------------------------+--------------------> | .-FALSE-. | '- -forceSingleBindIsolation--+-TRUE--+-' >--+---------------------+--+-----------------------+---------->< '- -xmlFile--XML-file-' | (1) | '-| Trace options |-----'
The next syntax diagram shows the syntax that is allowed for setting options for individual interfaces that the file lists.
>>-Java-package.interface--=------------------------------------> >--+---------------------------------------------+--------------> '- -baseDataOverride--Java-package.class-name-' >--+-----------------------------------+------------------------> | .-NULLID----------. | '- -collection--+-collection-name-+-' >--+--------------------------------+---------------------------> '- -pkgVersion-- -+-AUTO-------+-' '-version-ID-' >--+----------------------------------+-------------------------> '- -rootPkgName--package-name-stem-' >--+---------------------------------------+--------------------> | .-FALSE-. | '- -forceSingleBindIsolation--+-TRUE--+-' >--+---------------------+------------------------------------->< '- -xmlFile--XML-file-'
DB2 allows multiple versions of a package to exist at the same time, so that you can bind new packages without replacing older versions of packages with the same names. If you encounter problems with a newer package, you can use an older version of that package.
If you do not specify this option, database packages that result from subsequent binds are created without a version.
Verification of the version at run time is based on the consistency token, not the version name.
package-name-stem must be within the constraints that are set by the DB2 database that you are using.
If you plan to use the pureQuery StaticBinder utility to generate DBRM files rather than create DB2 packages, package-name-stem must be in uppercase and should be no more than 6 characters long. The Configure utility adds characters to the name stem when either the pureQueryXml file contains DDL statements, or the number of statements per package (specified with sqlLimit) is reached. If you use the StaticBinder utility to generate a DBRM file and the combination of package-name-stem, the extra characters due to the activity of the Configure utility, and the isolation level is longer than 8 characters, the StaticBinder utility throws an exception.
If you want to use the -isolationLevel option to bind a single statement set into two or three different packages, with each package at a different isolation level, do not use the -forceSingleBindIsolation option when you run the Configure utility on the pureQueryXML file in which the statement set appears.
For example, in an options file for the StaticBinder utility, suppose that you included these two entries:
C:/dir/captureFile.pdqxml:MYPKGA = -isolationLevel UR C:/dir/captureFile.pdqxml:MYPKGA = -isolationLevel CS
If you used the -forceSingleBindIsolation option when you ran the Configure utility on the captureFile.pdqxml file, the StaticBinder utility performs these actions:
The result is a single MYPKGA package that is bound at the CS isolation level.
If you want the result to be two MYPKGA packages, one at the UR and the other at the CS isolation level, do not use the -forceSingleBindIsolation option when you run the Configure utility on captureFile.pdqxml.
>>-+------------------------+--+---------------------------+--->< '- -traceFile--file-name-' | .-OFF-----. | '- -traceLevel--+-ALL-----+-' +-SEVERE--+ +-WARNING-+ +-INFO----+ +-CONFIG--+ +-FINE----+ +-FINER---+ '-FINEST--'