2.Create a node for your custom reports. This node appears in the tree in Reporting.

a.Create the directory %JBOSS4_DIST%\server\appiq\reports\customTreeNodes if it doesn't already exist

b.Create an XML file in that directory for your tree node, for example, custom.xml. The management server uses this file to determine where to put the node for custom reports in the tree.

c.Use a text editor, such as Notepad, to open the XML file you created in the previous step. Enter the following into the XML file:

<NODE NAME="CUSTOM" LABEL="Custom" PARENT="SYSTEM"/>

where

NAME is how reports and other tree nodes refer to this node.

LABEL is the label that appears in the user interface for the node.

PARENT is the name of the parent node in the tree (optional). In this case, the Custom report appears under the SYSTEM node in the tree in Reporting.

3.To populate the tree in Reporting with your custom reports:

a.Create the directory

%JBOSS4_DIST%\server\appiq\reports\definitions\custom if it doesn't already exist

b.Create an XML file in that directory for your report, for example: CustomHostReport.xml

c.Open the file you created in the previous step in a text editor, such as Notepad. Add the following information to the file, modifying it for your settings. Refer to files in

%JBOSS4_DIST%\server\appiq\reports\definitions if you need additional samples.

d.Make sure you use an ID that is not used by any of the existing reports. You have to specify a title to appear in the tree and the file names for the CLS and CAT files, as shown in the following example.

<REPORT ID = "9098"

TITLE = "Custom Host Connectivity"

FILE_NAME = "//definitions/custom/Host_Connectivity.cls"

CATALOG_FILE = "//definitions/custom/host.cat"

SUPPORTS_ORGANIZATION_FILTERS = "true">

<TREE_NODE NAME = "CUSTOM" />

<ELEMENT_FUNCTION_CALLBACK NAME = "isHost" /> </REPORT>

where

REPORT ID is the unique ID for the report.

TITLE is the name you want to appear for the report in the tree in Reporting.

FILE_NAME is the file name of the CLS file for the report and its path. In the example, the CLS file is in the

%JBOSS4_DIST%\server\appiq\reports\definitions\custom directory.

CATALOG_FILE is the file name of the CAT file for the report and its path. In the example, the CAT file is in the

%JBOSS4_DIST%\server\appiq\reports\definitions\custom directory.

Storage Essentials 5.00.01 User Guide 455