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, expand 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 Probes pages of the editor. For detailed information about the parts of a probe, see Probe definitions. Make changes in the Probes page as follows:
    • To modify the values for an item, select the item in the tree pane on the left side of the Probes page, then edit the values in the edit pane on the right side of the page.
    • 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 tree pane 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 have applied the previous version of the probe to your application, and if you made one of the following changes in the probe, you must remove the instrumentation for the previous 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 for statically applied probes.

    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.

Related concepts
Probekit reference
Related tasks
Creating probes
Related reference
The Probekit editor
Probekit examples
Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.