To use the XML methods, add the path names of the following files to your CLASSPATH setting:
  • ifxtools.jar
  • xerces.jar

All of these files are located in the lib directory where you installed your driver.

The Xerces XML library xerces.jar has been removed from distribution with the HCL OneDB™ JDBC Driver, Version 3.00.

The XML methods are not part of the ifxjdbc.jar file. Instead, they are released in a separate .jar file named ifxtools.jar. To use the methods, you must add this file to your CLASSPATH setting along with ifxjdbc.jar.

In addition, building ifxtools.jar requires that you use code from a .jar file that supports the SAX, DOM, and JAXP methods. To use ifxtools.jar, you must add these .jar files to your CLASSPATH setting.

The Java development kit uses the default XML parser even if the xml4j parser is in the CLASSPATH. To use the xml4j implementation of the SAX parser, set the following system properties in the application code or use the -D command-line option:
  • The property javax.xml.parsers.SAXParserFactory must be set to org.apache.xerces.jaxp.SAXParserFactoryImpl.
  • For the Document Object Model, the property javax.xml.parsers.DocumentBuilderFactory must be set to org.apache.xerces.jaxp.DocumentBuilderFactoryImpl.

For more info about how to set the properties, see Specify a parser factory.