User Defined Summary View (TPF Toolkit Debugger)

TPFUG_Req_Number: V09108S
ORIGIN DATE: 03/18/09
REQUIREMENT ABSTRACT

The ability for the user to set up a summary view profile such that the
User Defined Summary view (similar to the ECB Summary view but with a
variable number of panes) is automatically populated and XML mapping
applied to a given address.

REQUIREMENT DESCRIPTION

In TPF, it is very common for a specific piece of data to always be
found in the same location throughout the life of a software package.
For example, the core block address for data level 1 may always
contain a pointer to data mapped by a AAA while executing package NA*.
In addition to this, a message header may always be specified by the
address found at EBW060 while executing package NA*. As such, a TPF
view could be provided to detect the name of a program that is being
executed, open pane for each data area specified in the profile,
automatically apply an XML map and populated the data from the
specified location. For the example discussed above, a profile may
contain the following information:

PGM XML Map ECB field/offset Pointer Size Dereference
NA* AAA.xml CE1CR1 4 Yes
NA* header.xml EBW060 8 Yes
NA* ABCD.xml 14 8 No
JBCD JBCD.xml CE1CR2 4 Yes
JB* AAA.xml CE1CR9 4 Yes

When the execution point enters a program that matches the mask NA*,
3 panes would be displayed in the User Defined Summary View. The first
pane would get the 4 byte address found at CE1CR1, collect the data
found at that dereferenced address, and apply the AAA.xml file.
The Second pane would get the 8 byte address found at EBW060, collect
the data found at that dereferenced address, and apply the header.xml
file. The third pane would point to offset 14 into the ECB, collect
the data in the ECB at that location (not dereferenced), and apply the
ABCD.xml map. The amount of data to collect for a given pane is
specified in the xml map. The user would be able to toggle panes on and
off after they are populated.


As a user debugged from software package to software package, the data
mapped and the XML mapping used for that location would be dynamically
updated based on the specification in the profile. For example, if
package NAAA entered package JBCD, the User Defined Summary view would
be repopulated from 3 panes to 2 panes, one for the 4 byte address
found at CE1CR2 with JBCD.xml and one for the 4 byte address found at
CE1CR9 with AAA.xml.


SOLUTION CONSIDERATIONS

This feature should be easy to setup and use. Once this feature is
setup, the user should not be required to do anything further. That
is, the view should automatically populate and repopulate based on the
programs entered. The state of the XML map (the nodes that are
expanded and nodes displayed) should be remembered such that upon
returning to a package and reopening a given XML map, the view is
restored to how it was last seen (this allows the user to move between
packages with the XML displays expanded to key locations and quickly
see the state of the application).=