+

Search Tips   |   Advanced Search

 

Create a Diagnostic Provider registration XML file

 

The Diagnostic Provider registration XML is used to provide information about the exposed configuration, state, and self diagnostic attributes and tests to the Diagnostic Provider utility. It is also used to populate objects needed later in the process, to assist in filtering, and to assist in localization. Programming knowledge of your system and the proper authorities to perform the following steps.

 

Overview

The steps that follow outline a general process for creating a Diagnostic Provider (DP) registration XML file.

 

Procedure

  1. Start with the DP document type definition (DTD). If you are using the helper methods (see the step called Create your DP implementation in Creating a Diagnostic Provider), you can use this DOCTYPE line to pick up the common DTD:

    <!DOCTYPE diagnosticProvider PUBLIC "RasDiag" "/DiagnosticProvider.dtd">
    
    If you are extending an existing MBean with an existing XML configuration, you might need either to add the DP XML to an existing DTD, or omit the DP XML entirely. If you omit the DP XML, you will not be able to validate that your XML file is well formed.

  2. Follow the conventions described in Best Practices for Diagnostic Provider Extensible Markup Language to help keep your XML consistent with other components. You can find an example of a small DP registration XML file in Diagnostic Provider method implementation.