Real Time Information Director User Documentation

RTID Message Format and Programmatic Interfaces

Hewlett-Packard Company 8 529618 - 002

</EXCEPTION>

Most Director exceptions fall into one of the following categories (each corresponding to

an exception class):

• InvalidInputException requires the sending application to correct the data.

• SystemException requires an operator to correct the system (typically because of

a database problem).

• MetadataInconsistency requires the application customizer to correct the

metadata.

• SoftwareDefect requires the RTID development team to correct the problem.

Exception messages provide details about the problem. Usually the best approach to

handling a Director exception is to display or log the message. For example, a portal

application might

• Display an InvalidInputException in the client window, allowing the submitter to

examine and correct the invalid input.

• Display a SystemException where an operator will encounter it.

• Log a MetadataInconsistency exception for analysis by the solution developer

• Log a SoftwareDefect exception for analysis by the RTID engineering team.

If the Dispatcher is unable to write to the output stream, it logs the message “Dispatcher

couldn’t write to output stream.”

For more detailed information, see the Javadocs for the RTID Exception package.

Director Statistics

Another possible element of a response document, whether a query response or the

response to an insert or update document, is a set of statistics pertaining to the servicing

of the request. You specify options that determine the set of statistics returned:

• For servlet or EJB access, use the Director Management MBean interface, either

programmatically or using the Director Management Client. For information

about this interface, see the document entitled RTID Management.

• For the low-level interface, use methods of the DocumentHelper class. For

information about DocumentHelper methods, see the Javadoc for that class.

The format of the statistics block depends on the options you’ve selected for statistics

accumulation. Here is an example of an XML segment that reports statistics by table: