Modifying probes

Use the Probekit editor to modify probe definitions. Remove the instrumentation for the original version of the probe before you apply the modified probe.

To modify a probe:
  1. In the Navigator or Package Explorer view, open the Probekit project that contains the Probekit source file (probe file) that you want to modify.
  2. Right-click the Probekit source file and click Open With > Probe Editor. The editor opens, and displays the current probe definition.
  3. Make changes in the General and the Probe pages of the editor. For detailed information about the parts of a probe, see Probe definitions. Make changes in the Probe page as follows:
    • To modify the values for an item, select the item in the editor's tree pane, then edit the values in the edit pane.
    • To delete an item, right-click the item in the tree pane and click Delete.
    • To add a new item, in the tree pane, right-click the parent for the new item and click New, followed by the name of the item that you want to add. The menu lists only the items that are valid. If an item is valid but can no longer be added in this location, the item is disabled in the menu.
    • To move or copy an item to a different parent, right-click the item in the editor tree and click Cut or Copy. Then right-click the new parent and click Paste. The Paste menu command is disabled if the item that you want to paste is not valid for the new location. Cutting or copying an item with multiple children acts on all of the children.
    • To change the order of targets, select a target definition in the edit pane and click the Up or Down button to the right of the definitions.
    Note: When you type a value in the Import directive property field, type only the name of the package or class that you want to import. Do not type the import keyword or the final semicolon (;).
  4. When you have finished modifying the probe, click File > Save.
  5. If you made one of the following changes in the probe, remove the instrumentation for the original version of the probe before you apply the modified probe:
    • Added or removed a fragment.
    • Changed the fragment type.
    • Changed, added, or removed any data items in a fragment.
    • Changed a target specification. (In this case, you need to reinstrument only the class and jar files affected by the change.)
    For instructions, read Removing probe instrumentation.

    Changes in the source code for a fragment (including a fragment at class scope) or in an import directive do not require you to remove the previous instrumentation.

Copyright IBM Corporation and others 2000, 2006. All rights reserved.