PREVIOUS HOME NEXT

System Properties

At the beginning of program execution, Blitz reads a properties file, blitz.properties, located in the %BLITZ_HOME%\config directory, to determine default values that should be used during certain operations.  You can modify the contents of this file, either by using a standard text editor or by using the property editor provided in the GUI, to customize Blitz's behavior to suit your environment.

Properties are all specified using the standard Java syntax:

property.name=property value

where each "property.name" should be a unique identifier.

During runtime, whenever Blitz comes to a place in a test file where an optional tag has been omitted, a corresponding value in the properties file may provide a default setting. Any or all of these default values may be removed or commented from the file, in which case, a hard-coded system default value will be used instead.

TOP

Class Names

This set of properties specifies which classes should be used whenever they are not explicitly declared within a test file.

Property Name Description System Default Value
className.agency Specifies the name of the factory class to use for creating operative instances. At runtime, the specified class must be visible in the classpath. null
className.matcher Specifies the name of the class to use for doing comparisons of strings or other objects. At runtime, the specified class must be visible in the classpath. blitz.matcher.NullMatcher
className.filter Specifies the name of the class to use for doing pre-comparison filtering. At runtime, the specified class must be visible in the classpath. blitz.filter.NullFilter

TOP

Search Paths

This set of properties specifies where Blitz should look for certain kinds of files, or where certain files should be written.

Property Name Description System Default Value
path.root.testFile Specifies the root path in which to look for test files. The same path where the root test file is located.
path.root.propertyFile Specifies the root path in which to look for property files. The same path where the root test file is located.
path.result.expected Specifies the path where expected result files are located. The same path where the executing test file is located.
path.result.actual Specifies the path where actual result files are to be written. The same path where the executing test file is located.
path.output.trace Specifies the path where output from the trace command should be written. The same path where the root test file is located.
path.output.outcome Specifies the path where outcome output from the execution of a test is expected to be written. The same path where the root test file is located.

TOP

Inheritance Values

This set of properties specifies how property and matcher inheritance will work.

Property Name Description System Default Value
inheritance.property Specifies what kind of inheritance to use in determining properties for a particular test. Allowable values are
  • NONE
  • PARENT
  • ROOT
 NONE
inheritance.matcher Specifies what kind of inheritance to use in determining the matcher for a particular test. Allowable values are
  • NONE
  • PARENT
  • ROOT
 NONE

TOP

Execution Mode

Property Name Description System Default Value
executionMode Specifies which mode to use during execution of tests. Allowable values are
  • SEQUENTIAL
  • CONCURRENT
 SEQUENTIAL

TOP

Error/Failure Limits

This set of properties provides limits on how many errors or failures are permitted before Blitz will terminate a particular test run.

Property Name Description System Default Value
limit.errors Specifies the number of errors that may occur before test execution is forced to stop. Allowable value is any integer >= 0. 0
limit.failures The number of failures that may occur before test execution is forced to stop. Allowable value is any integer >= 0 (a value of 0 is interpreted to mean "unlimited failures") 0

TOP

Trace Detail Level

Property Name Description System Default Value
trace.detailLevel Specifies the level of detail to display during execution of the trace command. Allowable values are
  • TERSE
  • NORMAL
  • VERBOSE
 NORMAL

TOP

Backups

This set of properties determines whether or not backup files will be kept.

Property Name Description System Default Value
keepBackups.trace Specifies whether to keep old trace files when new ones are created. Allowable values are
  • YES
  • NO

"YES" means that an existing file with a ".trace" extension is converted into backup format before the new one is created. "NO" means that the old trace file is overwritten.

 YES
keepBackups.outcome Specifies whether to keep old outcome files when new ones are created. Allowable values are
  • YES
  • NO

"YES" means that an existing file with a ".outcome" extension is converted into backup format before the new one is created. "NO" means that the old outcome file is overwritten.

 YES

TOP

PREVIOUS HOME NEXT