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.
Before you begin
Programming knowledge of your system and the proper authorities to
perform the following steps.
About this task
The steps that follow outline a general process for creating a Diagnostic
Provider (DP) registration Extensible Markup Language (XML) file.
Procedure
- 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.
- 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.