not prohibited by the Do-not-use Type List. If the first routine is prohibited, the analyzer examines the next routine down, and so on. This default behavior can cause the following Memory Map problems: - The same few type names appear repeatedly in the Memory Map display. This occurs when the first routines on the callstack are low-level memory management or utility routines. Since most of the allocation events in your application use these routines, you see unrelated allocations grouped together with the same type name. To prevent this problem, add any application-specific memory management or utility routine names to the Do-not-use Type List before you run your application. - The type names assigned provide a higher level of abstraction than you require. This can occur when the first routine on the callstack is less application-bound than your level of examination. If you need to see type names that reflect application functions, it is not helpful to see type names derived from intermediary memory management routines instead. This can also occur when the first routine on the callstack focuses on a part of your application you are not interested in examining. If you need to see type names that reflect subsystem functions (for example, initialize_death_star), it is not helpful to see only one type name for all subsystem functions (for example, initialize_star). To correct this problem, add the current type name to the Do-not-use Type List until the Memory Map display reflects the level of abstraction you desire. To add a segment type name to the Do-not-use Type List, you can select the Add to Do-not-use Type List pull-down menu item in the Options menu, or you can choose the Do Not Use Type pop-up menu item in the Memory Map, Type Histogram, or Views-and-Types Display. To delete a segment type from this list, choose the Use Type pop-up menu item in the Do-not-use Type List. To save the contents of a Do-not-use Type List, you can choose the Save Do-not-use Type List menu item in the Options menu. This saves the list for future heap analyzer sessions. The Restore Do-not-use Type List menu item removes recent additions to the list since the last time the list was saved.

212  –  ha_window_opt_disp

  As you examine the Memory Map, you may find that you need to adjust the
  type display to focus more clearly on your area of interest.  The
  Views-and-Types Display allows you to specify changes to multiple or
  individual segments of the same type.

  The Views-and-Types Display is actually two windows separated by a
  window sash.  You can expand the left window to show all the known
  types in your application.  The right window contains the display
  options (color, show status, expand status, and save status).

213  –  ha_window_opt_scope

  The heap analyzer receives information about segments from four OpenVMS
  memory managers that perform allocations and deallocations in memory
  space.  Each memory manager has a slightly different view, or overall
  picture, of dynamic memory.

  Each memory manager recognizes a different set of segment types.  This
  means that, within the heap analyzer, where views from the memory
  managers are layered on each other, a single memory location can be
  associated with one or more segment types.

  The left window of the Views-and-Types Display contains a hierarchy
  that reflects this integration:

   -  Views (integrates all four views)

   -  Blocks (block view from LIB$VM memory manager)

   -  Images (image view from SYS$IMAGE memory manager)

   -  Regions (system services view from SYS$SERVICES memory manager)

   -  Zones (zone view from LIB$VM_ZONE memory manager)

  To see the individual segment types recognized by each memory manager,
  expand the default display by double clicking MB1 on Blocks, Images,
  Regions, or Zones keywords.  To collapse an individual listing, click
  MB3 on the keyword you previously selected.

  This hierarchy offers you the following choices in scope:

   -  To affect all segment types in all views:

      Click MB1 on the Views keyword

   -  To affect all segment types in one view:

      Click MB1 on the Blocks, Images, or Zones keywords.

   -  To affect individual segment types:

      Double click MB1 on the view of your choice, and click MB1 on one
      or more single segment types.

214  –  ha_window_opt_dispopt

  The right window of the Views-and-Types Display shows the display
  options available, as follows:

   -  Color

      To change the color of all segment types, all segment types in a
      particular view, or individual segment types, click MB3 on the
      color button in the display.  When the vertical color strip
      appears, click MB1 on the color of your choice.  Then, click the
      Apply button to apply your change.

   -  Show (or hide) status

      To suppress (or restore) the display of all segment types, all
      segment types in particular view, or individual segment types,
      toggle the Show button to the Hide (or Show) setting and click MB1.
      (Alternatively, you can choose the appropriate menu item from the
      Show pop-up menu.) Then, click the Apply button to apply your
      change.

      Use this option to clear the Memory Map of segments you are not
      examining.  You can also use this option to find all segments of a
      particular type (by hiding every other segment).

   -  Expand (or collapse) status

      To collapse (or expand) the display of segment types contained
      within all segment types, all segment types in a particular view,
      or individual segment types, toggle the Expand button to the
      Collapse (or Expand) setting and click MB1.  (Alternatively, you
      can choose the appropriate menu item from the Expand pop-up menu.)
      Then, click the Apply button to apply your change.

      Use this option to clear the Memory Map of nested segments you are
      not examining.  Depending on your application, heap analyzer
      performance may also improve.

   -  Save (or remove) status

      To destroy (or save) information on all segment types, all segment
      types in a particular view, or individual segment types, toggle the
      Save button to the Remove (or Save) setting and click MB1.
      (Alternatively, you can choose the appropriate menu item from the
      Save pop-up menu.) Then, click the Apply button to apply your
      change.

      Use this option to clear the Memory Map completely, and then resume
      Memory Map display.

  To cancel a choice, click the Reset button, or choose the Reset menu
  item from the Show, Expand, or Save pop-up menus.

215  –  ha_window_exit

  To exit the heap analyzer, choose the Exit item from the File menu on
  the heap analyzer screen.

216  –  ha_on_version_hlp

  The heap analyzer is a feature of the OpenVMS Debugger

  Software Version:    OpenVMS Debugger Version 8.2

  Copyright 2015, VMS Software, Inc.

  All rights reserved.

  For more information about the heap analyzer, double click on 'Using
  the Heap Analyzer' from the list of Additional Topics below.

217  –  ha_on_help_hlp

  Two kinds of online help about the debugger and debugging are available
  during a debugging session:
      Context-sensitive help, which is information about an area or
      object in a window or dialog box

   -  Task-oriented help, which consists of an introductory help topic
      named 'Using the Heap Analyzer' and several subtopics on specific
      debugging tasks

  Related context-sensitive and task-oriented topics are connected
  through the list of Additional Topics in the Help windows.

218  –  ha_context_sensitive_help

  Context-sensitive help is information about an area or object in a
  window or a dialog box.

  To display context-sensitive help:

  1.  Choose On Context from the Help menu in the heap analyzer screen.
      The pointer shape changes to a question mark (?).

  2.  Place the question mark on an object or area in a heap analyzer
      window or dialog box.

  3.  Click on MB1.  Help for that area or object is displayed in a Help
      window.  Additional Topics provide task-oriented discussions, where
      applicable.

  To display context-sensitive help for a dialog box, you can also click
  on the Help button in the dialog box.