This section describes problems that you may encounter when starting up or running the Hierarchical Dynamic Retrieve Module. It covers the following areas:
The connector logs an error message whenever it encounters a condition that causes the retrieval to fail. When such an error occurs, the connector also prints a textual representation of the failed business object as it was received from the integration broker. It writes the text to the connector log file or the standard output stream, depending on its configuration. You can use the text as an aid in determining the source of the error.
Table 56 describes the types of tracing messages that the
Hierarchical Dynamic Retrieve Module outputs at each trace level. These
messages are in addition to any tracing messages output by the WebSphere
business integration system's architecture, such as the Java connector
execution wrapper and the WebSphere MQSeries message interface.
Table 56. Connector tracing messages
Tracing level | Tracing messages |
---|---|
Level 0 | Message that identifies the connector version.
No other tracing is done at this level. |
Level 1 | Function module entry and exit messages. These messages are written whenever the connector execution thread enters or exits from a function. The messages help to trace the process flow of the connector. |
Level 2 | Business object handler messages that contain information such as the arrays and child business objects that the connector encounters or retrieves during the processing of a business object |
Level 3 |
|
Level 4 |
|
Level 5 |
|
All the error messages that the connector generates are stored in a message file named Connector.txt. Each error has an error number followed by the error message. For example:
1210 SAP Hierarchical Dynamic Retrieve module unable to initialize. 1211 SAP Hierarchical Dynamic Retrieve module failed to locate...
The SAP RFC_READ_TABLE function doesn't handle non-character -based datatypes. The module may fail while retrieving data if the fields use the following databtypes:
If a SELECT statement fails, check whether any simple attribute that is marked as key or is used as a foreign key contains a single quotation mark ('). If so, revise the business object's map to convert the single quotation mark (') to two single quotation marks ('').