The Developer Connection…ice Driver Kit for OS/2 3/DEV3-D1.ISO/devtools/pmdebug/pmdebug.hlp

OS/2 Help File | 1993-08-01 | 50.6 KB | 1,653 lines

ΓòÉΓòÉΓòÉ <hidden> Abstract ΓòÉΓòÉΓòÉ

PM Debug is an OS/2 PM 32 bit application to be used in conjunction with the
debug version of the OS/2 kernel. The application is run on your development
system, giving you a PM interface from which you may issue debug commands to
your test machine.

Features include:

o Configurable PM environment
o Buffering/editing of debug commands
o Programable function keys
o Easy memory editing
o Up to 32 programmable command buttons
o Drag and drop features
o Automatic execution stepping
o Formatted memory displays
o Remote debugging
o Logging

Related Topics

o Acknowledgments


ΓòÉΓòÉΓòÉ <hidden> Acknowledgments ΓòÉΓòÉΓòÉ

PM Debug was written by Mike Walsh as a self imposed project to learn PM
programming and just grew out of control.

In addition to the dozens of beta testers, I would also like to single out the
following people for their contributions toward this application:

o Doug Barra
o Beth Chen
o Ken Keller
o Rafael Solorzano
o Charlie Schmitt


ΓòÉΓòÉΓòÉ 1. Main window ΓòÉΓòÉΓòÉ

The window is comprised of the display area, the command entry field and
optionally a set of command buttons.

The display area is where output from the debug system will be displayed.  It
contains approximately 60K worth of data and can be scrolled back for viewing.

The command entry field is located below the display area.  You will use this
control to enter the kernel debug commands.

You may optionally display up to four sets of eight command buttons beneath the
command line.  These buttons are fully programmable and allow you to perform
your most often command via mouse input.


ΓòÉΓòÉΓòÉ 1.1. Display Area ΓòÉΓòÉΓòÉ

The display area is the large field on the main window containing both a
vertical and horizontal scrollbar. It can contain about 60K worth of data,
after which about 10K is deleted from the top each time the limit is reached.

As data is received from the debug machine, it is displayed in this control.
Except for clearing the existing text you cannot modify the data shown here.
Commands to the debug machine are entered in the command entry field.

Related Topics

o Scrolling the display
o Copying display text
o Dragging display text
o Clearing the display
o Text searches


ΓòÉΓòÉΓòÉ 1.1.1. Display Area: Scrolling ΓòÉΓòÉΓòÉ

Scrolling the display area text is usually performed by applying the mouse to
either the vertical or horizontal scrollbars contained in the display area.

When the display area has focus, you can scroll the displayed text up and down
by entering the PgUp and PgDn keys.  This will scroll the display area one page
in the specified direction.  Applying the Ctrl-PgUp and Ctrl-PgDn keys will
scroll the display left and right one page.  Finally the Ctrl-Home and Ctrl-End
keys will scroll to the top and bottom of the text respectively.

The display area can be scrolled when the focus is on the command entry field
by using the keys combinations listed above. Additionally the Ctrl-Up and
Ctrl-Down Arrow keys will scroll the display text.

When new text is added (i.e. data come in from the debugged system), the
display will jump to the end of the text. Thus while you can try scrolling the
display while text is being entered, it will not work well.

You may notice a tendency for the last line to creep up the display as you make
entries and receive responses.  A Ctrl-Home followed by a Crtl-End should gets
things synchronized.

When the text buffer becomes full (around 64K worth of data), the program will
remove text (about 10K) from the top if the list.  When this occurs, the
display area will pause for a second or so then repaint.


ΓòÉΓòÉΓòÉ 1.1.2. Display Area: Copying text ΓòÉΓòÉΓòÉ

You may mark a section of the displayed text using mouse or keys and copy the
selected text to the clipboard using the standard Ctrl-Ins key combination.
This text may then be pasted to any application which can normally accept such
an operation. This can be very handy if you forgot to start a log file and need
to save some results.

Note: cutting the text is not allowed.


ΓòÉΓòÉΓòÉ 1.1.3. Display Area: Dragging text ΓòÉΓòÉΓòÉ

To alleviate the tedium and errors caused by typing address (especially 32 bit
ones) the application allows you to mark text in the display area and drag it
to various controls where it may be dropped.

Marking text is achieved by moving the pointer to the text to be marked. Press
and holding button 1 of the mouse down. Now move the mouse across the text
holding down the mouse button. When the marked text is complete, release the
mouse button.

To initiate the drag, press and hold mouse button 2. If the pointer changes
into a broken pencil the drag has been initiated. Only a single line may be
dragged. If the pencil does not appear check that the marked area is wholly
contained on a single line.

Once the drag has started, while holding the mouse button, move the broken
pencil to the command entry field or onto a command button. The broken pencil
will change to an unbroken one when the drop may be performed.

Related Topics

o Dropping text on command entry field
o Dropping text on command buttons


ΓòÉΓòÉΓòÉ 1.1.4. Display Area: Context menu ΓòÉΓòÉΓòÉ

To display the context menu for the display area: position the pointer over the
display area, press and immediately release button 2 of the mouse.

From the context menu, you may clear part or all of the display text or
initiate a text search.

To remove the menu without selecting an option, either click button 1 of the
mouse anywhere off the menu or hit the Esc key.

Related Topics

o Clearing the display
o Text searches
o Editing memory


ΓòÉΓòÉΓòÉ 1.1.5. Display Area: Clearing ΓòÉΓòÉΓòÉ

To clear the text from the display area, bring up the context menu and select
the Clear All option. This may take a second or so if there is a large amount
of text to be cleared.

You may also program a command button to perform this task by setting its
command to the string *CLEAR.

To clear a portion of the display: mark the text to be cleared, bring up the
context menu and select the Clear Selection option.

Related Topics

o Display context menu
o Programming command buttons


ΓòÉΓòÉΓòÉ 1.1.6. Display Area: Text searches ΓòÉΓòÉΓòÉ

The search facility allows you scan the display text for a particular string.
To set the search parameters, bring up the context menu for the display area
and select the Search option. This will display the search dialog.

Fill in the desired search parameters and select the OK button to perform the
search operation. Searching begins at the cursor location within the display
area. The text, if found, will be highlighted in the display area.

To repeat the search with the same parameters enter the Ctrl-F key combination.
Each time this operation is performed, the highlighted text area will be
relocated to the next found occurrence.

Related Topics

o Display context menu
o Entering search parameters


ΓòÉΓòÉΓòÉ 1.1.7. Display Area: Editing memory ΓòÉΓòÉΓòÉ

To quickly change a memory value, select the text display the memory location
to be changed, bring up the display area's context menu and select the Edit
Memory option.

This causes the Edit Memory window to surface and loads it with the selected
memory location as if the text had been dropped into it.

Related Topics

o Display context menu
o Edit Memory Window


ΓòÉΓòÉΓòÉ 1.1.8. Display Area: Colors and fonts ΓòÉΓòÉΓòÉ

To change the background color of the main window display area, open the OS/2
system color palette.  Then simply drag and drop the desired color onto the
display area.  The foreground color is changed by holding the Ctrl key down
while dropping the selected color.

The font can be changed by dragging and dropping a font from the OS/2 system
font palette onto the display area.

Related Topics

o Saving the setup
o Saving window size/positions


ΓòÉΓòÉΓòÉ 1.2. Command entry field ΓòÉΓòÉΓòÉ

The command entry field is located below the display area.  Type in your debug
command into this field and press the Enter  key or double click with button 1
of the mouse to send the command to the debug system. It has a maximum length
of 100 characters.

Since the command is not sent to the debug system until the enter or double
click, you may use all editing keys to modify the command prior to sending.

Focus will be shifted to this entry field from the display area by entering the
TAB  key or most any key not used to scroll the display area text.

Related Topics

o Repeating/Editing commands
o Dropping text


ΓòÉΓòÉΓòÉ 1.2.1. Cmd Line: Repeating/Editing commands ΓòÉΓòÉΓòÉ

A buffer of the last 50 commands entered is kept available for reuse. These may
be view via the command line support window.  Only commands of 3 or more
characters will be placed into this buffer.  A repeat of the last command in
the buffer or executing a command via function keys will not cause an entry
into the buffer.

To load the buffered command, press the Up  or Down Arrow  keys until the
desired command appears in the command entry field.  You may then execute it
immediately or perform edit operation before execution.

Frozen commands may be scrolled by holding the Shift key down and entering the
arrow keys.

All editing features of the entry fields are supported, including cut and
paste.

Related Topics

o Freezing a buffered command


ΓòÉΓòÉΓòÉ 1.2.2. Cmd Line: Scroll buttons ΓòÉΓòÉΓòÉ

You can scroll the buffered commands by applying the mouse to either of the two
button to the right of the command line.  The operation of the button
corresponds to the arrow key indicated on the button.  That is, the button with
the up arrow will perform the same operation as the up arrow  key.


ΓòÉΓòÉΓòÉ 1.2.3. Cmd Line: Dropping text ΓòÉΓòÉΓòÉ

The command entry field is usually a valid target for text drops from the
display area or memory displays.  When dragging text from the display area, if
the broken pencil become whole when entering the entry field, you may position
the point of the pencil at the location you want the text to be inserted.
Releasing button 2  of the mouse, inserts the text.

At present there is no reformatting of the dropped text.


ΓòÉΓòÉΓòÉ 1.2.4. Cmd Line: Colors and fonts ΓòÉΓòÉΓòÉ

To change the background color of the command entry field, open the OS/2 system
color palette.  Then simply drag and drop the desired color onto the command
line entry.  The foreground color is changed by holding the Ctrl key down while
dropping the selected color.

The font can be changed by dragging and dropping a font from the OS/2 system
font palette onto the command entry field.

Related Topics

o Saving the setup
o Saving window size/positions


ΓòÉΓòÉΓòÉ 1.3. Command buttons ΓòÉΓòÉΓòÉ

The PM debug application has four sets of eight command buttons. Each button
may be individually programmed to perform a debugger command. Any combination
of button sets may be displayed.

Buttons are normally activated by clicking on them with Button 1 of the mouse
but you may define a mnemonic character in the button's text string and
activate the via the keyboard.  The button containing the entered mnemonic must
be displayed for it to be active.  The first button containing the entered
mnemonic will be executed.  Note that menu mnemonics have preference over the
button mnemonics.

Another way to activate a button is to drop text from the display area onto the
button. For this to work you must have set the button to receive such a drop.

Related Topics

o Showing command buttons
o Programming command buttons
o Dropping text on command buttons


ΓòÉΓòÉΓòÉ 1.3.1. Cmd Btns: Showing ΓòÉΓòÉΓòÉ

To show a button set, select the option Options->Show Buttons from the main
window menu. This will open a sub menu containing a option for each button set.
If the option for a set is unchecked, that set is currently not being display.
Selecting an unchecked set will cause it to become displayed and vice versa.
Any combination of sets made be displayed.

If you wish a particular setup of button to always be shown when starting the
application, you must save the setup after making your changes.

Related Topics

o Saving the setup


ΓòÉΓòÉΓòÉ 1.3.2. Cmd Btns: Programming ΓòÉΓòÉΓòÉ

Programming the command buttons is initiated via the Options->Edit Buttons menu
option. Selection of the option will cause the Edit Button dialog to be
displayed.

Within the dialog you have the ability to set the face and command text of each
of the buttons. The face text is shown on the displayed buttons. The command
text is the command sent to the debug machine when that button is activated.

If you did not save the button values from the dialog, you must save them via
the menu if you want them saved for the next session.

Related Topics

o Saving the setup
o Edit Buttons Dialog


ΓòÉΓòÉΓòÉ 1.3.3. Cmd Btns: Dropping text ΓòÉΓòÉΓòÉ

Command buttons may be programmed to accept text dragged from the display area.
This is done by entering the character $ within the command string for the
button. This character will be replaced with the dragged text when the drop
occurs on the button. If the button is activated via a mouse click, the
character is replaced with a blank.

It is also possible to have particular types of dragged text to be reformatted
during the drop. The text being dragged must be either two 4 digit numbers or a
single 8 digit number. These strings can be formatted into 16 or 32 bit
addresses upon the drop.

To format dropped text into a 16 bit address, enter the string $:16 into any
part of the command string for the button.  When the proper style text is
dropped on the button it will be replaced as described below.

Dropped Text        Formatted as
1234 5678           5678:1234
12345678            1234:5678

To format dropped text into a 32 bit address, enter the string $:32 into any
part of the command string for the button. When the proper style text is
dropped on the button it will be replaced as described below.

Dropped Text        Formatted as
1234 5678           %56781234
12345678            %12345678

Button which format the dropped text cannot be executed by a mouse click or
mnemonic key. Also for all types of drops, only one drop point is allowed in
the command string. Other are NOT translated.

Related Topics

o Dragging display text
o Programming command buttons


ΓòÉΓòÉΓòÉ 1.3.4. Cmd Btns: Colors and fonts ΓòÉΓòÉΓòÉ

To change the background color of any command button, open the OS/2 system
color palette.  Then simply drag and drop the desired color onto the button.
The foreground color is changed by holding the Ctrl key down while dropping the
selected color.

The font can be changed by dragging and dropping a font from the OS/2 system
font palette onto the button.

Related Topics

o Saving the setup


ΓòÉΓòÉΓòÉ 2. Command list window ΓòÉΓòÉΓòÉ

The application maintains a buffer of the last 50 commands sent to the debug
machine. You can view the entire list from the command list window. To display
the list, select the menu option Support->Command List from the main window's
menu.

You may also freeze buffered command. This feature will transfer the selected
command from the command buffer list into the frozen buffer. Command that have
been frozen will not be scrolled out of the list.

To re-execute a command from a command list, select the desired command in a
list and either double click Button 1 on the mouse or press the Enter key. This
will copy the selected command to the main window's entry field and transfer
focus to the command entry field.

Related Topics

o Clearing a command buffer
o Execute on select
o Editing a buffered command
o Deleting a buffered command
o Freezing a buffered command
o Loading/Saving frozen commands
o Setting colors and fonts
o Saving window size/positions


ΓòÉΓòÉΓòÉ 2.1. Cmd List: Clearing the command buffer ΓòÉΓòÉΓòÉ

You may remove all buffered commands from either or both of the command lists.
Select the menu option Buffer->Clear  from the command list window menu.  Then
from the sub menu select the desired list to clear. The default is to clear the
command buffer list.

You will be ask to verify your intent via a dialog.  Select the: Yes  to
proceed with the abort, the No  button to abort the clear.

Related Topics

o Deleting a buffered command


ΓòÉΓòÉΓòÉ 2.2. Cmd List: Editing a buffered command ΓòÉΓòÉΓòÉ

To edit a command from either list, select the command list item by clicking on
it with button 1  of the mouse. Bring up the context menu for the list by
clicking the Right  mouse button once.  Select the Edit Selection  option from
the context menu. A dialog containing the selected command will appear from
which you may change the command.

Related Topics

o Edit Buttons Dialog


ΓòÉΓòÉΓòÉ 2.3. Cmd List: Deleting a buffered command ΓòÉΓòÉΓòÉ

To delete a command from either list, select the command list item by clicking
on it with button 1  of the mouse.  Bring up the context menu for the list by
clicking the Right  mouse button once.  Select the Delete Selection  option
from the context menu.

Related Topics

o Clearing the command buffer


ΓòÉΓòÉΓòÉ 2.4. Cmd List: Freezing a buffered command ΓòÉΓòÉΓòÉ

As new commands are entered into the buffered command list, the top list item
may be removed.  To keep a command from being rotated out of the command list,
bring up context menu for the list by clicking the Right  mouse button once.
Select the Freeze Selection  option from the context menu.  A shortcut to
freeze commands is to select the desired command and press the Ins key.

When a command is frozen, the frozen command list will appear on top of the
buffered command list. You can adjust the sizes of the two list by positioning
the mouse on the separating bar between the list. When the mouse changes to a
double arrow, press and hold the Left mouse button. Position the divider to the
new location and release the mouse button. This position can be saved.

To unfreeze a command, you must delete it. When the last frozen command is
deleted, the frozen command list window is also removed.

Related Topics

o Loading/Saving frozen commands
o Deleting a buffered command
o Saving window size/positions


ΓòÉΓòÉΓòÉ 2.5. Cmd List: Loading/Saving frozen commands ΓòÉΓòÉΓòÉ

You may load a file of debugger commands directly into the frozen  command
buffer by selecting the option Options->Load Commands from the command window's
menu. In the resulting dialog, supply the filename of a ASCII file containing
the commands to be loaded. Multiple files may be read as a load does not remove
existing commands from the frozen buffer.

You may save the command buffered in the list of frozen commands by selecting
the option Options->Save Commands. In the dialog that appears, specify the file
into which the commands are to be saved,

These files may be edited by any editor with the stipulation each line is ended
with a carriage return.

Related Topics

o Freezing a buffered command
o Clearing a command buffer
o Deleting a buffered command


ΓòÉΓòÉΓòÉ 2.6. Cmd List: Execute on select option ΓòÉΓòÉΓòÉ

Normally double clicking on a command list item will just copy its text into
the main window's command entry field. You may choose to have the command
execute immediately by selecting the menu option Buffer->Execute On Select


ΓòÉΓòÉΓòÉ 2.7. Cmd List: Colors and fonts ΓòÉΓòÉΓòÉ

To change the background color of the command list window, open the OS/2 system
color palette.  Then simply drag and drop the desired color onto the window The
foreground color is changed by holding the Ctrl key down while dropping the
selected color.

The font can be changed by dragging and dropping a font for the OS/2 system
font palette onto the window.

Related Topics

o Saving the setup
o Saving window size/positions


ΓòÉΓòÉΓòÉ 3. Programming Function Keys ΓòÉΓòÉΓòÉ

The function keys on the keyboard can easily be set to enter partial text
strings into the command entry field or to execute full command immediately.

To change the current function key definitions select the menu option
Support->Function Keys from the main window's menu. This causes the function
key dialog to be shown.

Related Topics

o Function keys dialog


ΓòÉΓòÉΓòÉ 4. Breakpoint list window ΓòÉΓòÉΓòÉ

You can keep a list of breakpoints visible on the screen by displaying the
breakpoint list window.

Besides viewing the current breakpoints, you can also perform the basic
breakpoint commands using the window's menu.

Related Topics

o Refreshing the breakpoint list
o Executing breakpoint commands


ΓòÉΓòÉΓòÉ 4.1. Brk List: Refreshing ΓòÉΓòÉΓòÉ

The breakpoint list is NOT automatically updated if you enter breakpoint
commands from the command entry field.  To resync this list select the menu
option Refresh from the breakpoint list window's menu.

When you issue breakpoint commands from the breakpoint list window's menu, the
list is automatically refreshed.

Note: that for this option to be available, you must first break execution on
the debug machine.

Related Topics

o Breakpoint commands


ΓòÉΓòÉΓòÉ 4.2. Brk List: Executing breakpoint commands ΓòÉΓòÉΓòÉ

You may Clear, Disable and Enable breakpoints from this window's menu. Simply
select the menu option Commands from this window menu. You will be presented
with the three breakpoint commands; with options for executing the command for
all existing breakpoints or just the selected one(s). Select the option you
want and the command is executed and the display list refreshed.

Note: that for these options to be available, you must first break execution on
the debug machine.


ΓòÉΓòÉΓòÉ 4.3. Brk List: Colors and fonts ΓòÉΓòÉΓòÉ

To change the background color of the breakpoint window, open the OS/2 system
color palette.  Then simply drag and drop the desired color onto the window The
foreground color is changed by holding the Ctrl key down while dropping the
selected color.

The font can be changed by dragging and dropping a font for the OS/2 system
font palette onto the window.

Related Topics

o Saving the setup
o Saving window size/positions


ΓòÉΓòÉΓòÉ 5. Edit Memory window ΓòÉΓòÉΓòÉ

This window allows you to edit memory without all that mucking about
calculating memory offsets.

To load the window, mark the memory address shown in the display window. Then
either drag and drop it onto the edit memory window or select the edit memory
option from the display area's context menu.

Once the memory values are display within the window you can change them simply
by typing in the new value in the proper field. As you type in the field, its
color will change indicating that the field needs to be applied.

You apply the change to memory by either pressing the Enter  key or selecting
the Apply  menu option.  The change is only applied for the memory containing
the cursor.

Related Topics

o Close on set
o Changing colors and fonts
o Refreshing the memory display
o Setting the address to edit
o Edit as ascii / bytes / word / doubles
o Applying changes


ΓòÉΓòÉΓòÉ 5.1. Edit Mem: Close on set option ΓòÉΓòÉΓòÉ

When this is option is in effect and the last memory change is applied, the
edit memory window is closed automatically.  This is useful if you typically
set only one memory location at a time.  If you make many changes within the
same edit window you will probably what this option off.

You toggle the state of the option by selecting the Options->Close on set menu
option on the edit memory window.

The state of this option is saved when a setup save is performed.

Related Topics

o Saving the setup


ΓòÉΓòÉΓòÉ 5.2. Edit Mem: Changing colors and fonts ΓòÉΓòÉΓòÉ

The Edit Memory window contains two type of entry fields, one containing
changed values and the other with the unchanged values. You can set the colors
and fonts of these fields to show the differences.

Selecting the menu option Options->Colors/Fonts will display a dialog from
which you can perform this task.

You can also drag and drop the desired color or font onto any of the entry
fields. Once dropped, that color or font will be set for all fields of that
type.

Related Topics

o Saving the setup


ΓòÉΓòÉΓòÉ 5.3. Edit Mem: Refreshing the display ΓòÉΓòÉΓòÉ

To restore the Edit Memory window values to what actually in memory, select the
Options->Refresh menu option. This will cause any changes that have not been
applied to be removed and replaced with the current memory value.


ΓòÉΓòÉΓòÉ 5.4. Edit Mem: Edit as ascii / bytes / word / doubles ΓòÉΓòÉΓòÉ

You have the option of editing memory as:  ASCII characters, bytes, words or
doubles.  Select the desired mode from the Edit as... menu option.  The display
will then change to reflect your choice.

If a memory edit is in progress when this option is selected, a refresh will
occur. Any changes not applied will be lost.

The state of this option is saved when a setup save is performed.

Related Topics

o Refreshing the memory display
o Saving the setup


ΓòÉΓòÉΓòÉ 5.5. Edit Mem: Applying changes ΓòÉΓòÉΓòÉ

Once you have entered your changes, you must apply the change to cause the
memory location to be set.

Position the cursor in the field to be applied by clicking on it with the mouse
or press the TAB key until the cursor is in the correct field. Then either
press the Enter key or select the Apply menu option.

The memory location will be changed and the changed field will be reset to the
unchanged state.

Related Topics

o Close on set
o Changing colors and fonts


ΓòÉΓòÉΓòÉ 5.6. Edit Mem: Setting the address to edit ΓòÉΓòÉΓòÉ

Normally you would drag and drop an address on the edit window to set the
address to edit, but it can be set manually from the edit window's menu. Click
on the menu option Address->Set Address. A dialog will appear from which you
may enter in a new address.

You can change the edit field in blocks of 16 bytes (a full edit window's
worth) by the menu option Address->Edit next block. This will add 16 to the
current address and automatically update the edit window. And of course you can
reverse the process by selecting the Address->Edit prev block menu option until
you reach the base address.


ΓòÉΓòÉΓòÉ 6. Memory Display windows ΓòÉΓòÉΓòÉ

A memory display window allows you to view memory formatted on the structure
definitions from your C code includes. A memory display format file (.MDF) is
created via the PM Debugger Structure Compiler (PMD_SC). This file is opened
against a memory display window and a memory address is set. The window when
refreshed will automatically show you the structure's types, elements and the
current memory values for each element of the structure.

You may have up to 8 memory display windows open at any time. To create a new
window select the Support->Memory Display menu option from the main window.

Related Topics

o Setting the format
o Setting the address
o Setting the address drop config
o Saving format changes
o Saving the setup
o Memory item context menu
o Changing an item's display type
o Editting a memory item's value
o Refreshing the memory values
o Auto refresh option
o Dragging memory values
o Showing/Closing memory windows
o Changing the colors/fonts/sizes
o Creating MDF files


ΓòÉΓòÉΓòÉ 6.1. Mem Disp: Setting the format ΓòÉΓòÉΓòÉ

To set a format of a memory display window, select the option Options->Set
Format on that window's menu. A file dialog will be displayed listing the MDF
files. Select the file containing the desired format and click on the OK
button. The memory window will be updated to reflect the new format.

When a new format is loaded the value window is cleared. It will not auto
refresh even if that option is in effect.

Related Topics

o Creating MDF files
o Auto refresh option


ΓòÉΓòÉΓòÉ 6.2. Mem Disp: Setting the address ΓòÉΓòÉΓòÉ

The memory address to be formatted by the window is set via the window's menu
option Options->Set Address->Address. This will display a dialog into which you
enter the desired memory address.

The address is usually a hard coded value (e.g 0053:00001234) but could be a
global variable name.  Bear in mind though that the address must be known in
the current context when the refresh is performed.

A quick way to set an address is to drag it from the main display window onto
the memory display window. Select the address on the main window, press and
hold the right mouse button. Drag the broken pencil pointer on top of the
memory display window. When the pointer changes to a whole pencil, release the
mouse button to set the window's address.

When the address is set via a drag, the dropped address is formatted via the
window's drop configuration. Thus dragging the string "1234 5678" could be
formatted into either "5678:1234" or "%56781234" depending on your setup.

Using either method to change the address will cause a refresh if the
auto-refresh option is i effect.

Related Topics

o Setting the address drop config
o Saving format changes
o Auto refresh option


ΓòÉΓòÉΓòÉ 6.3. Mem Disp: Setting the drop config ΓòÉΓòÉΓòÉ

Like the display buttons, you can specify how an address dropped on the memory
window is to be formatted. Selecting the menu option Options->Set
Address->Address will display a dialog to do this.

This configuration can be saved in the MDF file. Once saved it will be used for
all windows with this format.

Related Topics

o Setting the address
o Saving format changes
o Drop configuration dialog


ΓòÉΓòÉΓòÉ 6.4. Mem Disp: Saving format changes ΓòÉΓòÉΓòÉ

The menu option Options->Save Setup->Save MDF Format  will save the setup for
the current memory window.  The setup is saved in the MDF file, so future
windows opened with this MDF file will used the setup. Also you may copy the
MDF files to other machines without destroying that machine's PMDEBUG.INI file.

The setup for a MDF file includes the colors and fonts for each of the
sub-windows. The size of the memory display window and the positions of its
dividing borders. The address drop configuration, item display settings and any
menu option settings.

Related Topics

o Setting the address drop config
o Changing an item's display type
o Auto refresh option
o Changing the colors/fonts/sizes


ΓòÉΓòÉΓòÉ 6.5. Mem Disp: Saving the setup ΓòÉΓòÉΓòÉ

The menu option Options->Save Setup->System  will save the position and format
loaded for each memory window active.  When the next session of PM Debug is
started, these windows will be automatically created, positioned and loaded
with the same format.  The colors and fonts used will be those stored in the
MDF files loaded.

The menu option Options->Save Setup->Window will save the size, position,
colors and fonts of the current memory window. These values will be used when a
memory window is created but has not yet had a format applied to it.

Related Topics

o Saving format changes
o Changing the colors/fonts/sizes
o Changing an item's display type


ΓòÉΓòÉΓòÉ 6.6. Mem Disp: Item context menu ΓòÉΓòÉΓòÉ

When a memory display has an item selected you can display a context menu for
that item to perform several tasks. Point to the selected item in either the
Type or Name sub-windows and click the left mouse button to popup the menu.

From the menu you made refresh the selected item's memory value, edit the item
or change the item's display type

Related Topics

o Changing an item's display type
o Editting a memory item's value
o Refreshing the memory values


ΓòÉΓòÉΓòÉ 6.7. Mem Disp: Changing the item display type ΓòÉΓòÉΓòÉ

The structure compiler will set cause each item to be display in the mode
suited for its size. You may override it by setting the display type to another
mode.

From the context menu for the item to be changed, select the Change Settings
option. This will display a dialog from which the option can be changed. Once
changed you may save the change in the MDF file.

Related Topics

o Saving format changes
o Memory item context menu


ΓòÉΓòÉΓòÉ 6.8. Mem Disp: Editting an item's value ΓòÉΓòÉΓòÉ

You can quickly edit a memory value by choosing the Edit Memory menu option
from the item's context menu. This will display the Edit Memory Window with the
proper address of the selected structure element.

Related Topics

o Memory item context menu
o Edit Memory Window


ΓòÉΓòÉΓòÉ 6.9. Mem Disp: Refreshing the memory values ΓòÉΓòÉΓòÉ

You may refresh the memory values for either the entire structure or a single
selected item. To perform refreshes the test system must be in debug mode and
the memory address for the display must be valid for the context the debugger
is operating.

To refresh the entire display, select Refresh->All menu option for the desired
window.

To refresh a single memory item, select the item by clicking on it. Then select
Refresh->Selected from the main menu or Refresh Memory for the item's context
menu.

Related Topics

o Memory item context menu
o Auto refresh option


ΓòÉΓòÉΓòÉ 6.10. Mem Disp: Auto refresh option ΓòÉΓòÉΓòÉ

When this option is in effect the entire display is refreshed when the address
is changed.

The state of this option is saved in the MDF file.

Related Topics

o Setting the address
o Saving format changes
o Refreshing the memory values


ΓòÉΓòÉΓòÉ 6.11. Mem Disp: Dragging memory values ΓòÉΓòÉΓòÉ

To drag a memory value from a memory window, select the value to be dragged by
clicking on it. Position the pointer on the selected item within the Value
window and press and hold the right mouse button. The pointer should change
into a broken pencil. While holding the mouse button down, drag the pointer to
the desired drop window. When the pencil becomes whole you may release the
button to drop the data.

If the memory window contains multiple word/address/etc, they are all dragged
to the drop window.

The memory values may be dragged onto the main window buttons, the command line
or onto other display windows.

It may also be dropped onto the title bar of its own memory window. This allows
the walking of a structure chain with a single memory window.

Related Topics

o Setting the address
o Setting the address drop config
o Dropping text on the command line
o Dropping text on command buttons


ΓòÉΓòÉΓòÉ 6.12. Mem Disp: Windows Operations ΓòÉΓòÉΓòÉ

From the Support->Memory Display->Window Operations  menu on the main display
window's menu, you are presented a sub menu of options. This menu is a set of
operation that will be applied to all existing memory display window. They
allow you to Hide, Show and Close all the memory windows at once.

Before closing all the windows, the user is asked to verify the operation.


ΓòÉΓòÉΓòÉ 6.13. Mem Disp: Changing the colors/fonts/sizes ΓòÉΓòÉΓòÉ

To change the background color of any of the display's sub-windows, open the
OS/2 system color palette.  Then simply drag and drop the desired color onto
the sub-window The foreground color is changed by holding the Ctrl  key down
while dropping the selected color.

The font can be changed by dragging and dropping a font for the OS/2 system
font palette onto the window.

The size of each sub-window may be changed by placing the pointer on the
dividing line between two of the windows.  When the pointer changes from the
single arrow to a left-right arrow, press and hold the left mouse button.
While holding the button adjust the window divider to the desired position and
release the button.

Related Topics

o Saving format changes
o Saving the setup


ΓòÉΓòÉΓòÉ 6.14. Mem Disp: Creating MDF files ΓòÉΓòÉΓòÉ

MDF files are created via the PMD_SC program.  It is basically a font end
compiler which uses the same includes file to compile the structures and create
the MDF for those you specify on the command line.

Refer to its README.DOC file for the particulars.


ΓòÉΓòÉΓòÉ 7. Logging ΓòÉΓòÉΓòÉ

The PM Debug allows you to log all output from the debug machine. To start a
log simply select the menu option Options->Logging from the main window's menu
and provide a name for the log file.

When logging is in progress, the name of the log file appears in the title bar
of the main window.


ΓòÉΓòÉΓòÉ 7.1. Logging: Stopping/Restarting ΓòÉΓòÉΓòÉ

To stop logging, select the same menu option used for starting (i.e.
Options->Logging). This time the dialog will not appear but rather the menu
option becomes unchecked and the log file name is removed from the main
window's title bar.

To resume logging to the same file, again select the logging menu option but
this time select the Resume option from the resulting dialog.


ΓòÉΓòÉΓòÉ 7.2. Logging: Adding a memo ΓòÉΓòÉΓòÉ

If logging is in progress, you may enter remarks or reminders into the log file
by selecting the menu option Logging->Log Memo from the main window's menu.

This bring up a dialog into which you may enter free form text which is then
inserted into the log file. Each line of the not is preceded by the string **
to make it easy to locate your memos.

Log memos are not entered into the display area.


ΓòÉΓòÉΓòÉ 8. Auto-Step Execution ΓòÉΓòÉΓòÉ

No debugging task is more boring than single stepping through a section of
code.  This feature allows you to automatically single step until you stop the
execution.

To start the auto step operation, you enter the command *AUTOSTEP from the
command line. This string may also be programmed into a command button or
function key. A break must be in effect on the debug kernel for the command to
be successful. A beep will sound if the command failed. If auto stepping is
started, a menu option titled AutoStep will appear on the main window's menu
bar.

To stop the auto-step feature either enter a Ctrl-C or re-enter the *AUTOSTEP
command. A button or function key programmed with this command thus acts as a
toggle and will both start and stop the operation. You may also stop it by
selecting the AutoStep menu item which appeared when the feature was started.

Please note that breakpoints and auto-stepping may not mix particularly well
together.

Related Topics

o Auto-Step Settings
o Programming command buttons
o Programming function keys


ΓòÉΓòÉΓòÉ 8.1. Auto-Stepping: Settings ΓòÉΓòÉΓòÉ

You can set a delay of 0 to 8 seconds between step commands while
auto-stepping.  A separate delay time is set before a call assembly instruction
is executed. Thus you can give yourself more time to stop the auto-step
operation before such an instruction.

Other setting include the ability to execute Trace commands instead of Steps.
You can also inhibit the displaying of the register information and specify a
command string to be executed after each step.

To change the settings, select the Options->Auto Step option from the main
window's menu. These settings can be saved in the application's INI file.

Related Topics

o Saving the setup


ΓòÉΓòÉΓòÉ 9. Debug machine connections ΓòÉΓòÉΓòÉ

You can use PM Debug to debug machines locally or remotely. The local
connection is made by connecting the machines serial ports with a NULL modem
cable. A remote connection requires a Hayes compatible modem.

Related Topics

o Local connection
o Remote connection
o Disconnecting


ΓòÉΓòÉΓòÉ 9.1. Local debugging ΓòÉΓòÉΓòÉ

To establish a local connection select the menu option Comm->Local from the
main window's menu. If this option is disabled you are already connected to a
debug machine (either locally or remotely) and you will need to disconnect to
make the menu option available again.

Once you have selected the menu option, a dialog appears from which you can
select the serial port and connection parameters to be used.

The default for the application is to establish a local connection using the
connect parameters last saved. If you want to perform a remote debug or change
the settings of a local debug, there are application parameters to override
this default.

Related Topics

o Disconnecting
o Saving the setup
o Startup parameters


ΓòÉΓòÉΓòÉ 9.2. Remote debugging ΓòÉΓòÉΓòÉ

To establish a remote connection select the menu option Comm->Remote from the
main window's menu. If this option is disabled you are already connected to a
debug machine (either locally or remotely) and you will need to disconnect to
make the menu option available again.

Once you have selected the menu option, a dialog appears from which you can
select the site to call and the connection parameters to be used.

Related Topics

o Disconnecting


ΓòÉΓòÉΓòÉ 9.3. Disconnecting ΓòÉΓòÉΓòÉ

To break a connection (either local or remote) select the menu option
Comm->Disconnect from the main window's menu. The Comm options Local and Remote
should become available for selection.

Related Topics

o Local connection
o Remote connection


ΓòÉΓòÉΓòÉ 10. Saving the setup ΓòÉΓòÉΓòÉ

To save the new colors, fonts, window sizes, positions and other settings,
select the menu option Options->Save Setup  from any window's menu bar.  Unless
this step is performed your setup will be lost when you close the application.


ΓòÉΓòÉΓòÉ 10.1. Colors and fonts ΓòÉΓòÉΓòÉ

Most of the window and controls used by the PM Debug application allow you to
save the dropped colors and fonts from the OS/2 system Color and Font Palettes.

For those controls that do not and those which you have not drop one, the
system default is used.


ΓòÉΓòÉΓòÉ 10.2. Saving window size/positions ΓòÉΓòÉΓòÉ

The size and position of the: Main window, Command list and Breakpoint display
are saved when the Save Setup  menu option is selected from any menu.

Also saved is the visibility state of the windows. That is, if a window is
visible when the option is selected, it will be made visible when the next
session is started.


ΓòÉΓòÉΓòÉ 11. Startup parameters ΓòÉΓòÉΓòÉ

When you start the application either from a command line or workplace object
you may provide a startup parameter. These are:

Argument       Description
-nc            No connect, Says it all (used to debug the application)


-r             Remote, The remote selection dialog is immediately displayed


ΓòÉΓòÉΓòÉ 12. Breaking execution ΓòÉΓòÉΓòÉ

To break execution of the debug machine you first set focus on either the
command entry field or the display area of the main window and enter the Ctrl-C
key combination. This will cause the debug prompt to appear in the display area
and focus to be set to the command entry field.

You may also program a command button to perform this task by setting its
command string to the text string *BREAK. Once set, activating this button will
send the break command to the debug machine.

Related Topics

o Programming command buttons


ΓòÉΓòÉΓòÉ <hidden> Setting log file name ΓòÉΓòÉΓòÉ

From this dialog you can set the name of the file to which the logging
information is to be sent.  When the dialog first appears, the entry will
contain the default filename.  If you wish, you may log to a different
directory or drive by entering the full path name of the filename.  If only a
name is given, it will be written to the current working directory.

To start a new log file or overwrite an existing one, press the Start button.

To continue logging to an existing log file, press the Resume button.

Selecting the Cancel button will cancel the log file selection,


ΓòÉΓòÉΓòÉ <hidden> Entering a log file memo ΓòÉΓòÉΓòÉ

This dialog allows to you enter text to be included in the current log file.
Type the memo you wish to appear in the log and select the OK button.  The memo
will then be written to the log file at that point but will not appear in the
display area.

Each memo line is preceded by the string ** to make them stand out.

Selecting the Cancel button will abort the memo.


ΓòÉΓòÉΓòÉ <hidden> Edit Buttons Dialog ΓòÉΓòÉΓòÉ

This dialog allows you to set the face and command text for each of the command
buttons.  The face text is the string that show on the button.  The command
text is the string sent to the debug machine when the button is activated.

Each page of the notebook contain one set of the four button sets. Use the
notebook tabs to switch to a different button set. You do NOT have to save each
page individually.

To set a mnemonic for a command button, place a ~ character before the desired
mnemonic character for that button's face text.

To make a button accept dropped text, place the $ character in the button's
command string.

Once your changes are complete, select the OK button to make them active. If
you want them saved to the application's INI file, select the Save button
first.

To abort the changes, select the Cancel button.

Related Topics

o Command buttons
o Dropping text on command buttons


ΓòÉΓòÉΓòÉ <hidden> Edit command line ΓòÉΓòÉΓòÉ

From this dialog you may make changes to the command list item. Use the mouse
and keyboard to effect the desired changes to the command.

To save the changes, activate the OK  button and the changed line should appear
in the command list window.  To exit without saving the changes, activate the
Cancel  button.


ΓòÉΓòÉΓòÉ <hidden> Edit function keys ΓòÉΓòÉΓòÉ

From this dialog you may make changes to the function keys. Use the mouse and
keyboard to effect the desired changes to the function key's command strings.

To set or reset the "execute on select" feature for a function key, check or
uncheck the checkbox for the function key. Checked means that this option is in
effect for the function key. Without this option pressing the function key will
only copy its text into the display window's command line.

Use the scroll bar on the right to view functions key not visible. Changes are
not lost if they are scroll off the display.

To apply the changes, activate the OK  button.  To exit without applying the
changes, activate the Cancel  button.

You may immediately save the changes into the PMDEBUG.INI file by selecting the
Save button.


ΓòÉΓòÉΓòÉ <hidden> Local connect parameters ΓòÉΓòÉΓòÉ

From this dialog you set the parameters to be used in establishing a local
connection to a debug machine. There are three parameters to be set: 1) the
comm port, 2) the baud rate and 3) the bit settings.

To select the comm port point the mouse to the desired port icon and press the
Button 1 on the mouse. The port's icon should become highlighted.

To set the baud rate and bit settings, use the mouse to make the desired values
become highlighted.

When all settings are complete, activate the Connect  button to make the
connection.  Once the connect is made the dialog disappears.  If there is a
problem a message box will inform you as to a possible cause.

To abort the setting of the parameters, select the Cancel button.


ΓòÉΓòÉΓòÉ <hidden> Establishing remote connection ΓòÉΓòÉΓòÉ

Establishing a remote connection consists of two parts. First you set the
parameters to be used, them make the connection. The connection is made via a
Hayes compatible modem over a telephone line.

Connection settings consists of a telephone number, comm port, baud rate and
bit settings. The application has the ability to save these setting based on a
given site name. All these settings are stored in a file named PMDEBUG.RMT.

To redial an established site, simply select that site name from the list and
activate the Dial button. Otherwise you must enter the settings and add a new
site name to the list. the following topics tell you how to do this.

Related Topics

o Selecting a site
o Setting parameters
o Dialing out
o Adding a site
o Deleting a site
o Changing a sitename
o Saving changes
o Site memos
o Site information


ΓòÉΓòÉΓòÉ <hidden> Selecting a site ΓòÉΓòÉΓòÉ

The listbox on the left contains the various sites know to this PM Debug
session. They are loaded in from the file PMDEBUG.RMT when this dialog is
loaded.

To select a site, simply click on its name in the list. When the site name
becomes highlighted its number, baud rate, comm port and bit settings are
automatically display in the other controls.

Related Topics

o Setting parameters
o Adding a site


ΓòÉΓòÉΓòÉ <hidden> Setting parameters ΓòÉΓòÉΓòÉ

To set the number to call, place the focus on the number field and enter the
desired number.

The Data\Stop\Parity bits are set by dropping the combobox's list and choosing
the desired value.

A baud rate is chosen from that combobox.

The comm port is set from the spin button.

When all the setting controls are showing the desired values, you are ready to
perform the next step, dialing out.

Related Topics

o Dialing out
o Changing a sitename
o Saving changes


ΓòÉΓòÉΓòÉ <hidden> Dialing out ΓòÉΓòÉΓòÉ

To dial out using the current settings, activate the Dial button. This will
cause the setting dialog to be replaced with a status dialog.

If the connecting is made, the status dialog disappears, leaving you on the
main window. If the connection was not made, selecting Exit from the status
dialog will cause the remote setting dialog to reappear.


ΓòÉΓòÉΓòÉ <hidden> Adding a site ΓòÉΓòÉΓòÉ

To add a new site to the list, click with mouse Button 2 over the site listbox.
This will bring up a context menu. From that menu select the Add option.

From the resulting dialog type in the new site's name and select the OK button.
This will add the new site into the list. The setting for that site will be the
one in the setting controls when the add was started.

Related Topics

o Changing a sitename
o Saving changes


ΓòÉΓòÉΓòÉ <hidden> Deleting a site ΓòÉΓòÉΓòÉ

To delete a site from the list, click with mouse Button 2 over the site
listbox.  From the resulting context menu, select the Delete option.

You will be asked to verify that you did in fact want to delete the site.


ΓòÉΓòÉΓòÉ <hidden> Changing a sitename ΓòÉΓòÉΓòÉ

To change a site in the list, click with mouse Button 2 over the site listbox.
From the resulting context menu, select the Change option.

From the resulting dialog type in the site's new name and select the OK
button.  This will add the site new name into the list.  The setting for the
site will also be changed to be the ones in the setting controls when the
change was started.

Related Topics

o Adding a site
o Saving changes


ΓòÉΓòÉΓòÉ <hidden> Saving changes ΓòÉΓòÉΓòÉ

When adding, deleting or changing a site, the final results are automatically
updated into the remote site file. If you just want to change a setting value,
you should select the site and change the desired settings control.

To save the change , click with mouse Button 2 over the site listbox.  From the
resulting context menu, select the Save option.  This will cause the remote
site file to be updated with your change.


ΓòÉΓòÉΓòÉ <hidden> Site memos ΓòÉΓòÉΓòÉ

Each site in the list has a memo field to which you may enter text for whatever
you want.  To display and edit this field you, click with mouse Button 2  over
the site listbox.  From the resulting context menu, select the Memo option.


ΓòÉΓòÉΓòÉ <hidden> Site information ΓòÉΓòÉΓòÉ

Each site in the list save the number call and the date/time the last call was
made to that site.

To view this information, click with mouse Button 2  over the site listbox.
From the resulting context menu, select the Info option.

This information is automatically update when a connection is made to the site.


ΓòÉΓòÉΓòÉ <hidden> Entering site name ΓòÉΓòÉΓòÉ

From this dialog you may enter a new or change the existing site name.

Selecting the OK button causes the name to be used.


ΓòÉΓòÉΓòÉ <hidden> Remote site dialing status ΓòÉΓòÉΓòÉ

This dialog shows the status of the remote connect attempt. When the phone icon
shows the receiver off hook, the connection is in progress. The commands to the
modem and its replies are display in the box next to the phone icon.

If the connection cannot be made, the receiver is hung up. You should then
select the Cancel button to go back to the remote settings dialog. To abort the
attempt before the time-out or connection occurs, select the Hangup button.

If the connection is made, you will go from this dialog directly to the main
window.


ΓòÉΓòÉΓòÉ <hidden> Remote site memo entry ΓòÉΓòÉΓòÉ

This dialog allows to you enter text to be associated to the current site.
Type/change the text you wish to appear in the memo and select the OK button.
The memo will then be written to the site file.

Selecting the Cancel button will abort the operation.


ΓòÉΓòÉΓòÉ <hidden> Entering search parameters ΓòÉΓòÉΓòÉ

Use this dialog to specify the search parameters:

Enter the test string to search for in the entry field. Leading and trailing
blanks are NOT removed.

If the Case sensitive box is checked, the display text must exactly match the
search string.

If the Wrap box is checked, when the end of the text is reached, the search
will continue at the start of the text. No warning is given when the wrap
occurs.

Activate the Find button to start the search. The Cancel button will abort it.


ΓòÉΓòÉΓòÉ <hidden> Changing memory edit colors/fonts ΓòÉΓòÉΓòÉ

To change the color or font of the unchanged memory fields, drag the desired
color/font to the entry field with title Unchanged. Drop it and the Edit Memory
fields will be changed.

For the changed field, do the same but drop on the entry field with the Changed
title..


ΓòÉΓòÉΓòÉ <hidden> Changing a memory address ΓòÉΓòÉΓòÉ

Enter the desired address into the entry field and click on the OK button. An
update of the memory fields will be performed.

To abort the address change, click on the  Cancel button.

Remember, the address must be valid for the context in which it is being used.


ΓòÉΓòÉΓòÉ <hidden> No comm port response ΓòÉΓòÉΓòÉ

The expected data has not been received from the debug kernel. Please check the
null modem cable.

Click on the Continue button to wait for the data.

Click on the Abort button to exit this operation


ΓòÉΓòÉΓòÉ <hidden> Auto-Step Settings ΓòÉΓòÉΓòÉ

This dialog allows you to control the execution of the auto-step feature by
configuring the auto-step settings. These settings may be altered while
auto-step is active.

The two timers set the delay before the next step. They have the range of 0 to
8 seconds. The Call timer indicates the time to delay before executing a "call"
instruction. The Step timer is the delay before all other instructions.

The Options buttons are to set which type of debug command will be executed.
The Verbose sub-option causes the register information to be displayed. If
Quiet is selected this information is inhibited.

Finally if you wish, a debug command may be entered in the Command entryfield.
this command will be executed after each auto-step operation.

These settings are saved whenever a system setup save is executed.

Related Topics

o Saving the setup
o Auto-Step Execution


ΓòÉΓòÉΓòÉ <hidden> Memory display item settings ΓòÉΓòÉΓòÉ

This dialog shows the selected element's information.  Besides the Type and
name fields, it also displays the offset from the start of the structure and
the size in bytes for this element.

You may change the display settings for this element. Open the combo box
display the various type and select the one desired. Click on the OK button to
put your change into effect. The following table describes each of the display
types.

o Don't Display

  Do not display anything for this element. Use if the element is large and you
  are not interested in its values.

o Element's Address

  Instead of displaying the element's values, display its address instead. This
  is useful for elements which are structures. You can drag and drop the
  address into a memory window displaying that structure's format.

o Bytes

  Display the element's values as a series of bytes.

o Words

  Display the element's values as a series of words.

o Doubles

  Display the element's values as a series of doubles.

o Segmented Pointer

  Display the element's values as a 16 bit segmented pointer.

o Flat Pointer

  Display the element's values as a 32 bit flat pointer.

Changes made to the structure's elements can be saved in the MDF file.

Related Topics

o Saving format changes
o Dragging memory values


ΓòÉΓòÉΓòÉ <hidden> Memory display drop configuration ΓòÉΓòÉΓòÉ

This dialog sets how a dropped address will be translated. Select a Drop Type
and set the Format field if desired. Click on the OK button to put the changes
into effect.

When data is dropped into the memory window the dropped data is translated
according to the selected Drop Type and placed into the Format field in the
position indicated by the first $ character. For example dropping the data 1234
into the format $:0000 results in the string 1234:0000.

o No translation

  No translation of the dropped data occurs. If a format field is set the data
  replaces the first $ character.

o 16 bit address

  A string already in a valid 16 bit address format is left alone. A pair of
  words 1234 5678 is translate into 5678:1234 and a double 12345678 translates
  into 1234:5678

o 32 bit address

  A string already in a valid 32 bit address format is left alone. A pair of
  words 1234 5678 is translate into %56781234 and a double 12345678 translates
  into %1234:5678

If the translation is invalid, a warning beep occurs when the drop is made.

Changes made to the structure's elements can be saved in the MDF file.

Related Topics

o Saving format changes
o Dragging memory values