A custom request is an application class and method that you designate as an edge or nested request. When the method runs, a start and end request trace record is written to the Level 1 or Level 2 tracing.
Custom requests are defined in the DC_home/itcamdc/etc/custom_requests.xml file. The product-supplied version of this file is only a sample and must be customized by the user. In addition, this feature is enabled by adjusting properties in the custom_directory/toolkit_custom.properties file.
Tag Name | Description |
---|---|
edgeRequest | Identifies one or more application methods that are to be Byte-Code-Instrumented for custom request processing. By modifying the requestName, Matches, type, and methodName tags within the edgeRequest tag, you can customize the selection. Each edgeRequest tag must contain exactly one methodName tag, and one or more Matches tags. Multiple edgeRequest tags can be specified. |
requestName | Defines a unique name for this request. The request name is displayed in the L1 or L2 trace entry that is produced when one of the methods identified by this custom request runs. |
Matches | Identifies a class or classes that contain the methods that are to be Byte-Code-Instrumented for custom request processing. Multiple Matches tags can be present within a single edgeRequest tag. |
type | Indicates whether a class must be a system or application class to match the edgeRequest tag. |
methodName | Identifies the names of the methods within one of the classes identified by the Matches tag that are to be Byte-Code-Instrumented for custom request processing. Exactly one methodName tag can be specified in each edgeRequest tag. |
<customEdgeRequests>
<edgeRequest>
<requestName>CreditCheck</requestName>
<Matches>com.mycompany.myapp.Customer</Matches>
<type>application</type>
<methodName>creditCheck</methodName>
</edgeRequest>
<edgeRequest>
<requestName>SupplyCheck</requestName>
<Matches>com.mycompany.myapp.Supplier</Matches>
<type>application</type>
<methodName>inventoryCheck</methodName>
</edgeRequest>
</customEdgeRequests>
#am.camtoolkit.gpe.customxml.custom=DC_home/itcamdc/etc/
custom_requests.xml
#am.camtoolkit.gpe.customxml.custom=DC_home/itcamdc/etc/
custom_requests.xml