8.3 Driver Initialization Errors

You might see the following driver initialization errors in the DSTrace utility. An explanation of the error is given along with recommended solutions.

8.3.1 JCO2

com/sap/mw/jco

This error occurs when the SAP Java Connector sapjco.jar file or the JCO native support libraries are not present or are improperly located.

Make sure the proper platform version of sapjco.jar is located in the same directory as SAPShim.jar.

Also check the JCO native support libraries to make sure they are present and properly configured. Use the JCO installation instructions for the appropriate platform.

no jRFC12 in java.library.path

This error occurs when the SAP Java Connector (JCO) native RFC12 support library is not present or is located improperly. Make sure the JCO native support libraries are present and configured properly. Use the JCO installation instructions for the appropriate platform.

/usr/jdk1.3.1/lib/sparc/libjRFC12.so:<classpath info>:fatal librfccm.so:open failed: No such file or directory

This error occurs when the SAP Java Connector (JCO) native RFC support library librfccm.so is not present or is improperly located. This sample error is from a Solaris system.

Make sure the JCO native support libraries are present and properly configured. Follow the JCO installation instructions for the appropriate platform.

8.3.2 JCO3

If you have installed the SAP HR Management (JCO3) driver, you might see the following driver initialization errors in the DSTrace utility:

com/sap/conn/jco/ext/DestinationDataProvider Exception

This error occurs when the SAP Java Connector sapjco3.jar file or the JCO native support libraries are not present or are improperly located.

Make sure the proper platform version of sapjco3.jar is located in the same directory as SAPHRShim.jar. Also check the JCO native support libraries to make sure they are present and properly configured. Use the JCO3 installation instructions for the appropriate platform.

Could not Initialize class com.sap.conn.jco.rt.JCoRuntimeFactory

This error occurs when the SAP Java Connector (JCO) native support library is not present or is located improperly. Make sure the JCO native support libraries are present and configured properly. Use the JCO3 installation instructions for the appropriate platform.

8.3.3 Common Errors

This section contains errors that are common to both SAP HR JCO2 and SAPHR JCO3 drivers.

Error connecting to SAP host

This error occurs when the SAP authentication or connection information is not configured properly. Ensure that the values for Authentication and Driver Parameters are correct for authentication to the SAP host system.

nsap-pub-directory parameter is not a directory

This error occurs when the Publisher IDoc Directory parameter in the Publisher Settings of the Driver Parameters does not specify a valid file system location. Ensure that this parameter specifies the directory on the SAP system configured in the SAP ALE subsystem for IDoc file output.

No connection to Remote Loader

This error occurs when the Remote Loader connection parameter information is incorrect. Configure the proper connection information for the remote connection to the system where the Remote Loader is running.

Authentication handshake failed, Remote Loader message: “Invalid loader password.”

This error occurs when the Remote Loader password configured on the remote system does not match the Remote Loader password on the Driver object.

Set matching passwords for both Remote Loaders. In iManager, ensure that both the application password and Remote Loader passwords are set at the same time.

Authentication handshake failed: Received invalid driver object password

This error occurs when the driver password configured on the remote system does not match the Driver object password on the Driver object. To correct this, you should set both Driver object passwords identically.

Attribute Mapping Error

If the Mapping policy Add Dialog contains no data for the APP (application properties of class mappings), the driver can not find the HRMD_A schema metafile.

You should ensure that the metafile directory and Master HR IDoc driver parameters are set to a valid file system location and contain the proper IDoc name. Validate that the metadata file for the configured IDoc type is in the file system location. For example, if Master HR IDoc is set to the default HRMD_A03, ensure that HRMD_A03.meta exists in the metafile directory.

Changes in SAP Do Not Generate an IDoc/Change Document

Ensure that the ALE and change pointer processes are configured properly, and that you have properly entered data.

The proper way of inserting or changing data is through using the Edit > Create or Edit > Change menus. If an error or a change is entered by overwriting an existing record and saving it, the change document is not created.

The Driver Does Not Recognize IDocs in the Directory

Verify that the driver parameters contain the correct client number and proper IDoc directory.

IDocs Are Not Written to the Directory

You should first test the ALE and IDoc interface. Refer to your SAP documentation for more information.

If the IDoc interface fails:

  • Using transaction WE21, ensure that the file port is configured properly. Validate the path to the directory and make sure the Transfer IDoc Immediately option button is selected.

  • Using transaction WE20, ensure that the appropriate file port is selected in the Partner Profile. Also, verify that it is on the outbound parameters of the receiving system.

If the IDoc interface succeeds:

  • Ensure the change pointers have been configured.

  • Ensure that the scheduled processes are not scheduled too closely together. For example, if one job is in process and another job begins, the second job might be cancelled because the first job is still running.

The Driver Does Not Authenticate to SAP

First ensure that you have configured all of the driver parameters and that the proper passwords have been entered.

If you are using the Publisher Channel Only configuration of the driver, make sure you have entered the correct parameters. If you have previously used a Publish and Subscribe driver, make sure that all files have been replaced by the Publish-only files.

If you are running the driver remotely, make sure that the Remote Loader has been started before you start the driver.

JCO Installation and Configuration Errors

For detailed instructions on using the JCO Test utility and analyzing error messages, refer to Section 5.3, Using the SAP Java Connector Test Utility.

Error When Mapping Drives to the IDoc Directory

You might see the following error in DS Trace if the IDoc directory parameter specifies an invalid local file system container or if it specifies a mapped drive on a remote system.

*** NDS Trace Utility - BEGIN Logging *** Fri Sep 13 15:45:59 2005

Identity Manager Log Event -------------------
    Driver = \FLIBBLE_TREE\n\Driver Set\SAP-HR
    Channel = publisher
    Status = fatal
    Message = <description>SAP Document Poller initialization failed: com.novell.nds.dirxml.driver.SAPShim.SAPDocumentPollerInitFailure: Specified Publisher IDoc Directory is invalid.</description>

*** NDS Trace Utility - END   Logging *** Fri Sep 13 15:46:31 2005

This error occurs because the Windows operating system service controls the rights of the local system, not the rights of a user. Thus, the local Windows system does not have rights to access any file resources outside of its own system, including the IDoc directory.

Driver Configured as “Publisher-only” Still Tries to Connect to the SAP System

The driver is designed to use a connection to SAP even when it is configured as a Publisher-only driver. The first purpose for using this connection is to verify the version of the SAP server so that the driver can configure itself for the proper version of IDocs it will consume. Otherwise the driver must be configured with a value for the Master HR IDoc parameter.

This connection also verifies the validity time stamps of desired infotypes during processing of future-dated event IDocs. This is an extremely critical function that should always be enabled if future-dated processing options are chosen in the driver configuration. Disabling this capability could result in the propagation of old or stale events that have been subsequently overridden.

If you don’t want a connection to the SAP server, you should remove at least one of the following connection parameters:

In this situation, the IDoc data being processed is used as a completely authoritative source of reliable data.

com.novell.nds.dirxml.engine.VRDException

This error occurs when the SAP Java Connector (JCO) components cannot be located. This error generally occurs if the driver or Remote Loader has not been restarted after the JCO has been configured. Restart Novell® eDirectory™ if you are using a local configuration or restart the Remote Loader for a remote configuration.