How to Generate Device Packs › Add the Required Information to the Device Pack Configuration File › Specify Filtering Options

Specify Filtering Options

To specify filtering options in the configuration file for processing files, use any of the following filters:

<DevicePackFilter>

    <DeviceFilter>

	<DeviceList action="exclude"></DeviceList>

	<UnwantedCharactersFromDevice></UnwantedCharactersFromDevice>

    </DeviceFilter>

    <BranchFilter>

	<BranchList action="exclude"></BranchList>

	<UnwantedCharactersFromBranch></UnwantedCharactersFromBranch>

    </BranchFilter>

    	<UnwantedCharactersFromElementName></UnwantedCharactersFromElementName>

</DevicePackFilter>

Note: You can use more than one filter or all filters.

DeviceList

Specifies to filter using the device name.

DeviceList provides a comma-separated list of device names. The attribute action specifies whether the application excludes only those devices in the device name list or includes only those devices in the device name list. Not only does the application use DeviceList, but the device pack also uses DeviceList when it is running. You can edit these values before you run the generated device pack.

Note: Using include specifies to ignore those devices not in the list.

UnwantedCharactersFromDevice

Specifies to hide any unwanted characters from the device name.

UnwantedCharactersFromDevice provides a comma-separated list of characters to remove from the device name. Not only does the application use UnwantedCharactersFromDevice, but the device pack also uses UnwantedCharactersFromDevice when it is running. You can edit these values before you run the generated device pack.

Note: This filter does not remove the device name but removes a few characters from the device name.

BranchList

Specifies to filter using the branch name.

BranchList provides a comma-separated list of branch names. The attribute action specifies whether the application excludes a branch in the branch list or includes only those branches in the branch list.

Note: Using include specifies to ignore those branches not in the list.

UnwantedCharactersFromBranch

Specifies to hide any unwanted characters from the branch name.

UnwantedCharactersFromBranch provides a comma-separated list of characters to remove from the branch name. Not only does the application use UnwantedCharactersFromBranch, but the device pack also uses UnwantedCharactersFromBranch when it is running. You can edit these values before you run the generated device pack.

Note: UnwantedCharactersFromBranch does not replace or delete the branch name but only removes a few characters from the branch name.

UnwantedCharactersFromElementName

Specifies to remove unwanted characters from the element name.

Specifying UnwantedCharactersFromElementName is the same as removing characters from the name of a new metric. Not only does the application use UnwantedCharactersFromElementName, but the device pack also uses UnwantedCharactersFromElementName when it is running. You can edit these values before you run the generated device pack.

Pre-Installation Setup

After you install Java Development Kit (JDK) 1.7, log in to the server with the user ID you want the [assign the value for camm in your book] processes to use. This user ID is referred to throughout the document as CAMM_USER.

Follow these steps:

1. Set the JAVA_HOME environment variable for your operating system:
   • UNIX systems (Solaris 8 or 9, and Linux)

     # JAVA_HOME="/export/home/jdk7/bin"
     # export JAVA_HOME
     

   • Windows systems (Windows 2003 and Windows 2008)
2. Open the System Properties dialog.
3. Select the Advanced tab and click Environment Variables.

   The Environment Variables dialog appears.

4. To display the New System Variable page, click New in the Systems Variables list.
   1. Add a case-sensitive variable named JAVA_HOME. Make this variable name upper-case only, and type the correct path value for the installed JDK.
   2. Click OK to add the new JAVA_HOME environment variable to the system variables list.

   Note: If a JAVA_HOME environment variable exists, make sure it references the proper path. Change the path statement, if necessary.

5. Determine your Java version:
   • UNIX systems (Solaris or Linux)

     # $JAVA_HOME/java -version
     java version "1.7.0_09"
     Java(TM) SE Runtime Environment (build 1.7.0_09-b04)
     Java HotSpot(TM) Server VM (build 17.1-b03, mixed mode)
     

   • Windows systems (Windows 2003 and Windows 2008)

     Open a command prompt and run the following command:

     C:\>%JAVA_HOME\java -version
     java version "1.7.0_09"
     Java (TM) SE Runtime Environment (build 1.7.0_09-b06)
     Java HotSpot(TM) Server VM (build 17.0-b16, mixed mode)
     

     The Java home path is set.