Object Reference Graph - Object Detail Window (Memory Profiling)

Illustration       Related Topics

The Object Reference Graph shows the relationship of an object created by a .NET managed program, with all other objects in the reference tree to which the selected object belongs. By default, Purify highlights the path of objects with the largest size from the selected object back to .Root.

You can highlight other objects based on various criteria, including object size, creation time, number of garbage collections survived, referential relationships, and objects whose allocation events were traceable to lines in source code. Using the shortcut menu, you can hide or show objects, format method names, scale lines, and change color schemes.

In the Object Reference Graph, Purify indicates whether all or only some objects referenced from the selected object are visible:

images\cgexp.gif

No referenced objects are visible

images\cgslash.gif

Only some of the referenced objects are visible

images\cgcoll.gif

All referenced objects are visible

In the status bar of the Object Detail window, Purify displays:

§          The number of objects referenced by the selected object (References)

§          The number of objects referencing the selected object (Referees)

§          The name of the selected object

You can do the following operations in the Object Reference Graph:

To

Do this

Display object
or line details

Pause the cursor over an object or line to display information about it.

Show or hide objects

Right-click in the Object Reference Graph and select Expand/Collapse and the appropriate command from the shortcut menu. You can also click images\cgexp.gif to display an object's immediate descendants. Click images\cgcoll.gif or images\cgslash.gif to remove from view all of the object's descendants.

Move objects

Drag an object to any location in the Object Reference Graph. If necessary, Purify uses curved lines to indicate that the object is located in advance of its actual position in the reference tree. You can reset the Object Reference Graph to Purify's default layout by clicking the Redo Layout tool images\relayic.gif.

Highlight specific
objects

Select a category from the Highlight drop-down list. For example, you can highlight objects with the largest amount of allocated memory. For more information about the categories, click images\shortcut.gif.

Change colors

Right-click in the Object Reference Graph and select Colors and the appropriate command from the shortcut menu. You can change the color of lines, text background, and highlighting.

Scale the object
reference graph

Drag the Zoom slider to the left or to the right.

Scroll the object
reference graph

Use the scroll bars, or click the background of the Object Reference Graph to display the hand cursor and then drag the cursor left, right, up, or down.

Restore the layout

Click the Redo layout tool images\relayic.gif to restore the Object Reference Graph to Purify's default layout.

Display the Overview

Click the Toggle Overview tool images\cgovwic.gif in the Object Reference Graph. The Object Reference Graph Overview window is a docking window. Click the Toggle Overview tool again to close the overview window.

Move the toolbars

Drag them to any location on your desktop.

Notes:

§      By default, Purify does not collect detailed object data. To collect and view detailed object data, in the PowerCheck tab in the Settings for <exename> dialog box, select Generate Object Reference Graph data, then rerun your program.

§      The Object Detail window is available only if Generate Object Reference Graph data was selected for the run.

§      The Object Detail window does not display for objects whose Root Type is Unreachable.

§      Purify does not automatically calculate object + references (O+R) size for the data views after a memory profiling run. To have Purify calculate O+R size for all objects, in the Object Reference Graph, right-click a node and select Line Scale Factors > Linear or Logarithmic from the shortcut menu.

§      When using the Object Reference Graph Overview window, large reference trees may appear highly compressed. To expand the tree structure in the overview window, undock the window, then resize it.

§      By default, Purify automatically synchronizes the method selected in the Call Graph with the object you select in the Object Reference Graph. You can disable this feature in the Workspace tab of the Preferences dialog box.

§      By default, Purify displays commas in numeric values, as in 1,244,329.68. You can turn off this setting in the Preferences dialog.

§      If your system supports 256 or fewer colors, the colors displayed might not match exactly the colors you select.

§      Right-click in the Object Reference Graph to display a shortcut menu for working with the Object Reference Graph.

(C) Copyright IBM Corporation 1992, 2010.