Acquire

The acquire node describes statistics (data) collected from the repository to test the exceptions. You can also define constants. For example, an acquire node in the XML may look like this:

 <acquire> 
    <statistic name="RC">
        <propertyName>RecordCount</propertyName>
        <componentName>BF_BatchFileMon</componentName>
        <taskName>BF_BatchFileMon_Task1</taskName>
     </statistic>
     <constant name="RCMax"> 
        <type>java.lang.Double</type> 
        <value>30000</value> 
     </constant> 
     <constant name="RCMin"> 
        <type>java.lang.Double</type> 
        <value>10000</value> 
     </constant> 
</acquire> 

In this example, the statistic element defines the data the exception definition collects. The statistic element includes a name attribute. The propertyName is an element that defines the property whose value will be collected. A property is distinguished from other same name properties by the componentName and taskName elements. So, a property with a componentName element and taskName element is identified uniquely. For a list of configuration properties, component name and task name, see Appendix A, “Operations Console Properties.”

A constant element is a child of the acquire element. constant elements are defined for a specific purpose. In this example we have two constants, RCMax (Record Count Max) and RCMin (Record Count Min), defined as double. The type element is a child of the constant element. type elements define a Java data type, such as Integer or Double.