In the memory map preferences, you can set the memory map
location. In addition, you can indicate if you want the debugger to
prompt you when you choose to remove all groups when you are working
in the Manage Groups dialog. You can also set the map to be built
before finding fields.
About this task
The product that you installed the debugger with may include
a <product installation directory>\plugins\com.ibm.debug.memorymap.<platform>.samples\samples sample
memory map directory, where <product installation directory> is
the directory where you installed this product. If the product includes
this directory, the debugger looks for memory maps in it by default.
Otherwise, the default memory map directory can be found in the memory
map preferences. The memory map directory must contain a layout.dtd file,
which is required by the Memory view. You can change the memory map
location, however, if you do, you must copy a layout.dtd file
to the new memory map location (if you export a map to this location,
the export procedure will automatically generate a layout.dtd for
you). This file must always reside in the memory map location.
Note: A
layout.dtd file may also be
available at the download site for the product that you installed
this debugger with. If a
layout.dtd is not available
with the product that you installed this debugger with, you can create
a
layout.dtd file as described in
Defining a mapping layout.
To have the debugger find memory
maps that you have created, you can add your memory maps to the default
directory or you can change the location of memory maps to point to
another directory as follows (be sure that this other directory contains
a copy of the layout.dtd file):
Procedure
- In the Memory view, click the down-arrow icon and choose Memory
Map Preferences from the menu.
- In the Memory Map Preferences dialog
box, enter or browse for the memory map location that you want to
set in the Memory Maps Location field.
Note:
- If the product that you are running this debugger with ships the
Remote System Explorer, the memory maps location settings are made
in this dialog box in the Memory Maps Location section.
In this section, you can enter or browse for a location on a remote
server. To do this, choose the Profile and Connection that
is associated with the memory map location (if you do not specify
a profile and/or none exists in the workspace, then the filename entered
in the Directory field will be treated as a
local file and will not be associated with any profile). Then specify
the memory map location folder in the Directory field.
When you map memory, you will be presented with a list of the maps
that reside in the specified location. If this location is remote,
an attempt will be made to connect to the remote server to retrieve
the list of available maps. If the Map option
is selected, this will allow you to browse for a map on both remote
and local systems. If the selected map file is on a remote system,
any remote files that are required will be cached on the local system.
- If you change the default memory map location, you can easily
set it back to the product default value by clicking the Memory
Map Preferences dialog box Restore Defaults push
button.
- If you want to control the size of the memory block that
is retrieved, complete the Minimum memory block retrieval
size in bytes and Maximum memory block retrieval
size in bytes fields. When a block of memory is retrieved,
it is divided into segments that are as large as the minimum memory
block retrieval size. Retrieval requests are then consolidated up
to the maximum memory block retrieval size.
Note:
- If the specified maximum memory block retrieval size exceeds the
maximum size that is supported by the debugger engine, the maximum
size that is supported by the debugger engine will be used.
- If you notice performance problems while mapping memory, increasing
the minimum block size may help. For large, contiguous maps, a larger
value for the minimum block size will improve performance.
- Select the Prompt when removing all groups check
box if you want to receive a prompt when removing all groups.
- Choose whether or not you want to receive a prompt to preserve
or discard grouping and description information before rebuilding
a map. If this check box is not selected, the last save/discard action
will be remembered (for example, the information will be saved if
it was for the last map rebuild).
- Indicate if you want the XML map file to be saved when
groups and descriptions are changed in the rendering. If this check
box is selected, the rendering is rebuilt when you make changes -
and any renderings in the Memory view that use the related XML file
are rebuilt.
- To build the map before opening the Find Field dialog box,
select the Automatically build the map before opening the
Find Field dialog check box. If this check box is not
selected, only those elements that have already been built (or expanded)
in the map will display in the Find Field dialog box. By default,
this check box is selected.
- Enter the setting of your choice for receiving a warning
message when the export of a map will affect other memory renderings.
Results
When you map memory, the list of available maps that is presented
to you are maps that reside in the memory map location. Similarly,
when you map memory using the Map action, you
are prompted to locate the map in this location - however, with this
action, you can also browse elsewhere on your local system for memory
maps. If you do browse elsewhere on your local system, and choose
a map from this location, the location will become the default memory
map location.Note: If the product that you are running this debugger
with ships the Remote System Explorer, you can browse for a map on
a remote or local system. If you choose a map from a different location
on a remote or local system, the location will become the default
memory map location.