Dump Window
![[IMAGE]](./images/02109940.gif)
-
DESCRIPTION
-
The Dump window displays a dump of memory
in both character and hexadecimal format. Output is directed from the
dump command to the Dump window in much the same way as output
from the print command is directed to the Print
window. The redirect (> and >>) command prefixes are used with the dump command to direct the output from a
memory dump to either
a new or existing Dump window. See Directing Commands to a Window for information about the > and
>> command prefixes.
The Dump window provides the following information:
Unprotected fields Any time a Dump
window is displayed, you can use the following unprotected fields to alter
the contents of the dump field:
-
Expr:
-
can be any expression within your current
run scope that points to a memory location. This location identifies the first
byte in the dump.
-
Address:
-
can be any valid hexadecimal address that
is specified in
0p format.
This address corresponds to the first byte of the dump.
-
Str:
-
can be either
Y
(yes) to indicate a string type dump or N (no)
to dump characters that are not in a string. If Y
is selected, the number of bytes that are typed at the N:
prompt is ignored. After a request to dump a string has been processed, the
value of N: is updated to reflect the number of
bytes that are in the string.
-
N:
-
can be any number of bytes to be dumped
starting with the byte that is specified by the Address:
field. Str: should be set to
N
(no) when you are dumping a known number of bytes.
-
Rel:
-
can be either a
Y
(yes) to select relative addressing or N (no)
to select absolute addressing. The address area on the left side of the Dump
window changes to reflect the type of addressing that is selected. If the
area that follows the prompt is erased or blank, the type of dump is determined
by the dumpabs setting of the auto
command.
Issue a window scroll
command or press the ENTER key without modifying any of these fields to refresh
the display in the Dump window.
Typing invalid input in one or more of these fields
causes the dump to fail; the Message window pops up with the reason for the
failure, the dump area is blank, and the invalid input remains in the input
fields.
The Expr: and Address: fields work together. If input is typed at both prompts,
the expression that is typed at the Expr: prompt
takes precedence and the address that is typed at the Address: prompt is ignored. However, if Expr:
is not modified, and a new address is provided that follows the Address: prompt, the address is also displayed following the Expr: prompt when you
press the ENTER key.
Window size The
first time a Dump window is requested, the window height is based on the number
of bytes being dumped. The window is opened with as many rows as needed to
display the number of bytes specified, provided the height does not exceed
the maximum for this window. The maximum is the height specified for the Dump
window in a configuration file, or half the terminal height by default.
The width that is used is not dependent on the number
of bytes that are dumped; it is always the Dump window width that is specified
in your configuration file, or the terminal width by default. However, window
width does determine the number of bytes that are dumped on each line. This
number is always a power of two.
When a Dump window is reused, it is not automatically
resized; however, it can be resized after the dump.
If you dump a large number of bytes, the dimensions
may permit only a portion of the memory that is being dumped to be visible,
but you can view the rest by scrolling the window.
-
ADDITIONAL DISCUSSION
-
-
SEE
ALSO
-
The
dump
and print commands for
Print Window.
Copyright © 2001
by SAS Institute Inc., Cary, NC, USA. All rights reserved.
