JVC properties file

The JVC properties file contains a number of configurable parameters for controlling the behavior of the JVC. These parameters tell the JVC where to find other files that it uses, as well as specifying certain validation options.

When running a map that calls the JVC, the properties file must be located in the same folder as the validate_messages map. If the JVC properties file is not found on startup, the JVC terminates with an error message.

The parameters set by the properties file include:
swift.pack.version=v.r.m
This is the version of the WebSphere® Transformation Extender Pack for SWIFT and is not to be changed. It is used to validate that the correct version of the Java™ validation component JAR file is being used. If this value does not match the version number contained in the JVC JAR file, the JVC terminates with an error message. For example, this parameter is set to 9.0.2 in the jval902.prop file and 9.0.3 in the jval903.prop file and srg2019 in the jval2019.prop file.
message.definition.directory
Identifies the location of the metadata files used by the JVC to perform syntactic validation and to enable and disable message-specific field level and network rule validation. The default location is <FTM_WTX_SWIFT_Maps_dir>/FTM_Pack_SWIFT_MTyyyy/metadata/ where yyyy is the SWIFT release year. If the metadata files are not found in the specified location, the JVC terminates with an error message.
rules.networkvalidation.enabled = [true or false]
  • true - This is the default value and the recommended setting. It performs all syntax and semantic validation, including validation defined by the special functions in the SWIFT manuals (for example Party Field Option J, Payments Reject/Return, and so forth).
  • false - Performs only basic syntax validation.
bic.file.enabled=[true or false]
  • true - Indicates that the BIC/BEI validation is required.
  • false - Indicates that BIC/BEI validation is not required This is the default.
bic.definition.file
Identifies the location of the bic.xml lookup file used by the JVC for BIC/BEI validation. The default location on WebSphere Transformation Extender is <FTM_WTX_SWIFT_Maps_dir>/FTM_Pack_SWIFT_MTyyyy/data/bic.xml where yyyy is the SWIFT release year.

If the bic.file.enabled parameter is true and the bic.xml file is not found, the JVC terminates with an error message.

countrycurrencycodes.definition.file
Identifies the location of the currencycodedecimals.xml lookup file used by the JVC for currency code and country code validation. The default location on WebSphere Transformation Extender is <FTM_WTX_SWIFT_Maps_dir>/FTM_Pack_SWIFT_MTyyyy/data/currencycodedecimals.xml where yyyy is the SWIFT release year.
ReportingMode=[verbose or terse]
  • verbose - Validation results and error messages are returned in a multiple line, XML-like syntax. This is the default.
  • terse - Validation results and error messages are usually returned as a single line of plain text. Some messages may contain multiple lines, if they include data from a multiple line field that was in error.
validateCopyofFields=[true or false]
  • true - Causes validation to be performed on the CopyOfFields elements in message types MTn92, MTn95, and MTn96.
  • false - Causes CopyOfFields validation not to be performed. This is the default.
checkE76.CCY=[ccyymmdd]
CCY is a former European currency used in E76 error validation. ccyymmdd is the date value after which this currency must not be used. These parameters should not be changed in normal operation.
rules.marketpractice.enabled=[true or false]
  • true - Market practice validation is performed based upon the SWIFT document V1.1 published August 26, 2002.
    Note: SWIFT has discontinued this document. Therefore, this feature is no longer maintained.
  • false - Market practice validation is not performed. This is the default.
rules.marketpractice.baseclass
Indicates the base class name to use for market practice validation. The default value is com.ibm.websphere.dtx.ip.swift.vnnn.validation, where nnn is the version of the WebSphere Transformation Extender Pack for SWIFT, and should not be changed.
rules.marketpractice.MTnnn
Indicates the rules that are to be validated for a particular message. The rule name, S101 for example, is appended to the BaseClass to obtain the class to use: 
com.ibm.websphere.dtx.ip.swift.vnnn.validation.S101
These features are used to enable and configure the basic Java logging capabilities:
log.enable=[true or false]
Default is false
log.filename=
The default log file name for WebSphere Transformation Extender is <FTM_WTX_SWIFT_Maps_dir>/FTM_Pack_SWIFT_MTyyyy/swiftlog.txt, where yyyy is the SWIFT release year.
log.append=[true or false]
Default is false
log.filesize=1000000
The maximum log file size, in bytes, before the file is recycled.
log.level=ALL
Allowable values are OFF, ALL (default), SEVERE, WARNING, INFO, FINE.