HP 3000 Manuals HP 3000 Manuals
Entering Commands (cont..)
Entering Procedure Calls (cont.)
Miscellaneous Commands
The miscellaneous commands perform a variety of individual tasks. The
miscellaneous commands are:
* !
* :
* #
* RETURN
* ~
* am (activate more)
* debug
* f (format)
* g (goto)
* h (help)
* q (quit)
* sm (suspend more)
* tc (toggle case)
!
! [MPE command]
Escapes out of the debugger into the operating system. If a command is
specified, it is automatically executed. Otherwise, a session is invoked
and must be explicitly ended before the debugger can resume. When you
execute the ! command interactively, return to the debugger by hitting
the RETURN key. When you use this command in an assertion or breakpoint
command list, control returns to the debugger automatically.
A command can be enclosed in braces ({}) to delimit it from debugger
commands on the same line. For example:
b 14 {!{SHOWTIME}; continue}; trace; list assertions
If you use the escape without giving a list of commands, you are given a
colon prompt. You can now execute any MPE/iX operating system command.
You can return to the debugger by typing exit at the colon prompt.
NOTE It is recommended that you return to the debugger when finished
with your session.
This command is synonymous with the : command.
:
: [MPE command]
Escapes out of the debugger into the operating system. If a command is
specified, it is automatically executed. Otherwise, a session is invoked
and must be explicitly ended before the debugger can resume. When you
execute the : command interactively, return to the debugger by hitting
the RETURN key. When you use this command in an assertion or breakpoint
command list, control returns to the debugger automatically.
A command can be enclosed in braces ({}) to delimit it from debugger
commands on the same line. For example:
b 14 {:{SHOWTIME}; continue}; trace; list assertions
If you use the escape without giving a list of commands, you are given a
colon prompt. You can now execute any MPE/iX operating system command.
You can return to the debugger by typing exit at the colon prompt.
NOTE It is recommended that you return to the debugger when finished
with your session.
This command is synonomous with the ! command.
#
# [text]
Causes the text to be interpreted as a comment. This command can be used
to document the contents of record and playback files. The number symbol
(#) must be the first nonblank character on the line. The rest of the
line is treated as a comment and is written to the record file if the
recording is on. Otherwise, it is ignored.
RETURN
RETURN
Repeats the previous command. You can use this command with the
following commands:
* +
* -
* p (print)
* v (view)
* s (step)
* S (Step)
This command is synonomous with the ~ command.
~
~
Repeats the previous command. You must use the RETURN key after typing
the ~. You can use this command with the following commands:
* +
* -
* p (print)
* v (view)
* s (step)
* S (Step)
This command is synonomous with the RETURN command, but is more "visible"
in a record or playback file.
am (activate more)
{am }
{activate more}
Activates (enables) the more feature. (Active is the initial state).
When activated, all command window output following a debugger command is
presented to you a window-full at a time, and you are prompted before
displaying successive windows.
Use one of the following commands to continue.
SPACE BAR Displays one more window-full.
RETURN Displays one more line.
q Quits scrolling and ignores the rest of the output
until another debugger prompt is issued.
To view command window output in a continuous stream, use the sm (suspend
more) command to suspend the more feature. CNTLS may be used to
temporarily suspend scrolling when the more feature is suspended. Use
CNTLQ to continue scrolling.
NOTE Output from the child process (program being debugged) also appears
in the command window, but it is not controlled by the more
feature.
debug
debug
Transfers control to the MPE NMdebugger by causing the child process to
call the "DEBUG" entry point. When you exit, control returns to the HP
Symbolic Debugger.
f (format)
{f } ["printf-style-format"]
{format}
Sets the printing format used by the debugger to print an address. Only
the first 19 literal and formatting characters are used (see the section
on printf in the HP C/XL Library Reference Manual for a discussion of
valid formats). If the format is set incorrectly, an error message
appears.
Using the f (format) command without an argument will reset the format to
the default format: 8 hexadecimal digits, preceded by "0x".
NOTE This command is generally not needed for typical debugger use.
CAUTION If you set the address printing format to something printf does
not like, you might get an error (usually memory fault) each
time you try to print an address, until you fix the format with
another f (format) command.
g (goto)
{g } {line }
{goto} {#label}
Moves the current point of execution suspension to the specified line or
label. The specified line or label must be within the same procedure (or
HP COBOL II paragraph) where execution is currently suspended (at depth
zero on the stack). This is not necessarily in the procedure currently
being viewed. The program counter will change so that the given line
number or the line that #label appears on becomes the next executable
line. Execution does not automatically resume.
NOTE For purposes of this command, the main program is treated as a
procedure.
h (help)
{h }
{help}
Prints a command summary, called the Help file which describes the syntax
and use of each command. This facility references the short form of the
command only, not the long form.
The more facility can be used to view the file. When activated, all
command window output following a debugger command is presented to you a
window-full at a time, and you are prompted before displaying successive
windows.
Use one of the following commands to continue.
SPACE BAR Displays one more window-full.
RETURN Displays one more line.
q Quits scrolling and ignores the rest of the help
information.
To view help information in a continuous stream, use the sm (suspend
more) command to suspend the more feature. CNTLS may be used to
temporarily suspend scrolling when the more feature is suspended. Use
CNTLQ to continue scrolling.
q (quit)
{q }
{quit}
Quits the debugger and asks for confirmation: enter y (yes) or n (no).
This command returns control to the operating system and terminates the
debugging session. All files are closed and the terminal is restored to
a normal mode.
sm (suspend more)
{sm }
{suspend more}
Suspends the more feature and lets you view the output in a continuous
stream. CNTLS and CNTLQ can be used to temporarily suspend scrolling.
Use this command when you do not want the debugger to pause at the end of
each window of output waiting for a continuation command. This command
is particularly useful for viewing a large amount of output containing
many breakpoints. To view the command window output one window-full at a
time, use the am (activate more) command to activate the more feature.
tc (toggle case)
{tc }
{toggle case}
Toggles case sensitivity; determines whether or not searches or names are
case sensitive (Initially, they are case insensitive.) This command
affects file and procedure names, variables, and search strings used with
the / or ? commands.
NOTE Case insensitive searches equate some non-letters with other
non-letters. For example, [ and { are equal, as are @ and `.
do
do [cmdid] [,editstring]
Re-executes the command identified by cmdid after applying editstring.
The optional cmdid can be a positive or negative number or a string that
will be searched in the history stack. If no parameters are specified,
do executes the most recently executed command.
redo
redo [cmdid] [,editstring]
Allows you to edit and re-execute the command identified by cmdid. The
optional cmdid can be a positive or negative number or a string that will
be searched in the history stack. If no parameters are specified, redo
allows you to edit the most recently executed command.
listredo
listredo [start] [,end]
Lists commands from the redo stack between start and end inclusive. The
optional start and end can be positive or negative numbers.