KAYC0060W Unsupported specification version mapping_extension_framework_version in class_name (jar_file_path)

Explanation

The OMEGAMON® Data Connect mapping extension identified by class_name and jar_file_path is not supported by the running version of OMEGAMON Data Connect.

OMEGAMON Data Connect involves one JAR file containing core classes and multiple JAR files containing mapping extension classes. The mapping extension classes must be compatible with the core classes. Compatibility is determined by the versions of the OMEGAMON Data Connect framework that were used to build the JAR files:

mapping_extension_framework_version
(Reported in this message.) The version of the OMEGAMON Data Connect framework that was used to build the mapping extension JAR file.

This is the value of the Specification-Version header in the manifest in the mapping extension JAR file.

core_framework_version
(Reported in message KAYC0067I.) The version of the OMEGAMON Data Connect framework that was used to build the OMEGAMON Data Connect core JAR file, odp-server-version.jar.

Given version numbers in the three-part format major.minor.patch, the mapping_extension_framework_version must meet both of the following requirements:

  • The mapping_extension_framework_version must have the same major version as core_framework_version.
  • The mapping_extension_framework_version must have the same or earlier minor.patch version as core_framework_version.

For example, given a core_framework_version value of 2.3.1:

  • Supported values of mapping_extension_framework_version include: 2.3.1, 2.3.0, 2.1.0
  • Unsupported values of mapping_extension_framework_version include: 3.1.0, 2.4.0, 2.3.2, 1.1.0

System action

OMEGAMON Data Connect ignores the mapping extension and continues processing.

Mapping extensions contain mapping classes that enable OMEGAMON Data Connect to process different types of incoming record. OMEGAMON Data Connect discards records for which there is no mapping class.

User response

Check that the OMEGAMON Data Connect runtime option -Dodp.ext refers to the correct set of mapping extensions for this version of OMEGAMON Data Connect. If you cannot resolve the issue, contact IBM® Software Support.