IBM Tivoli Directory Integrator
Appropriate error messages are issued to the standard log if an
error is thrown. The possible situations for which an error might
be produced are:
- Incorrect configuration of Touchpoint Server.
- Exceptions thrown as result of communication problems with the
Persistence Store (File System errors).
- Error in communication with the clients of the Touchpoint Server.
- Error in communication with of the Touchpoint Server with TDI.
When the error is due to an invalid information/request sent
by the user, and which violates the Touchpoint Server protocol, it
will produce an XML document with the following syntax:
<?xml version="1.0" encoding="UTF-8"?>
<ns2:error xmlns:ns2="http://www.ibm.com/xmlns/prod/scmp"> <creation-time>2010-02-23T14:49:06.384+02:00</creation-time>
<code>100005</code>
<details>
<detail>
<name>schema</name>
<value>http://www.ibm.com/xmlns/prod/scmp#touchpoint-role</value>
</detail>
</details>
<native-msgid>ABCD1234E</native-msgid>
<summary>Missing role category</summary>
</ns2:error>
Where:
- creation-time element denotes the time the
error has occurred in a format specified by http://www.w3.org/TR/1998/NOTE-datetime-19980827.
- code element is one of the following codes:
- 100000 - unknown error occurred (could not narrow it further)
- 100001 - Missing required atom:link. Details element will
provide: rel - relationship name of expected
link
- 100002 - Missing required scmp:data element -Details
element will provide: qname - missing element
qname
- 100003 - Invalid atom:entry in POST/PUT operation (for
example, parse error)
- 100004 - Invalid value for scmp:data element - Details
element will provide: qname - invalid element
qname; value - invalid supplied value
- 100005 - Missing required atom:category. Details element
will provide: scheme - expected scheme name
- 100006 - Invalid atom:category value. Details element will
provide: scheme - expected scheme name; term - invalid supplied term
- 100007 - Too many atom:link for given relationship. Details
element will provide: rel - relationship name
of extra link
- 100008 - Too many atom:category values for scheme. Details
element will provide: scheme - overpopulated
scheme name
- 330000 - Default connectivity-provider-specific error (unable
to narrow down further)
- details element is containing more details
for the specific error. See the particular error code to find out
what kind of detailed information is expected for each error.
- native-msgid element denotes the message
short id.
- summary element contains the human readable
error message.
When the error is not caused by protocol violation but is from
a different source, a human readable representation is returned in
a plain text format. The error also contains the exception stack trace
so we can report it to the Touchpoint Server administrator in order
for it to be resolved.