HP 3000 Manuals

Miscellaneous Commands [ Symbolic Debugger/iX User's Guide ] MPE/iX 5.0 Documentation


Symbolic Debugger/iX User's Guide

Miscellaneous Commands 

          Table I-19.  Miscellaneous Commands 

----------------------------------------------------------------------------------------------
|          |                                        |                                        |
|   Cmd    |                 Syntax                 |              Description               |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
| !        |                                        | Escapes out of the debugger into the   |
|          |                                        | operating system.  If a command is     |
|          | !  [ MPE command]                      | 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. |
|          |                                        | If you use the escape without giving a |
|          |                                        | list of commands, you can return to    |
|          |                                        | the debugger by typing exit at the     |
|          |                                        | colon prompt.                          |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
| :        |                                        | Escapes out of the debugger into the   |
|          |                                        | operating system.  If a command is     |
|          | :  [ MPE command]                      | 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. |
|          |                                        | If you use the escape without giving a |
|          |                                        | list of commands, you can return to    |
|          |                                        | the debugger by typing exit at the     |
|          |                                        | colon prompt.                          |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
| #        |                                        | Causes the text to be interpreted as a |
|          |                                        | comment.  The number symbol (#) must   |
|          | # [ text]                              | be the first nonblank character on the |
|          |                                        | line.                                  |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
| RETURN   |                                        | Repeats the previous command.  You can |
|          |                                        | use this command with the following    |
|          | RETURN                                 | commands:                              |
|          |                                        |                                        |
|          |                                        |                                        |
|          |                                        |    *   +                               |
|          |                                        |                                        |
|          |                                        |    *   -                               |
|          |                                        |                                        |
|          |                                        |    *   p (print)                       |
|          |                                        |                                        |
|          |                                        |    *   v (view)                        |
|          |                                        |                                        |
|          |                                        |    *   s (step)                        |
|          |                                        |                                        |
|          |                                        |    *   S (Step)                        |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------

          Table I-19.  Miscellaneous Commands (cont.) 

----------------------------------------------------------------------------------------------
|          |                                        |                                        |
|   Cmd    |                 Syntax                 |              Description               |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
| ~        |                                        | 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)                        |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
| am       |                                        | Activates (enables) the more feature.  |
|          | { am           }                       |                                        |
|          | { activate more}                       |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
| debug    |                                        | Transfers control to the MPE           |
|          |                                        | NMdebugger by causing the child        |
|          | debug                                  | process to call the "DEBUG" entry      |
|          |                                        | point.  When you exit, control returns |
|          |                                        | to the HP Symbolic Debugger.           |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
| f        |                                        | Sets the printing format used by the   |
|          | { f     } [ "printf-style-format"]     | debugger to print an address.  Only    |
|          | { format}                              | 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).  Using the f (format)  |
|          |                                        | command without an argument will reset |
|          |                                        | the format to the default format:  8   |
|          |                                        | hexadecimal digits, preceded by "0x".  |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
| g        |                                        | Moves the current point of execution   |
|          | { g   } { line  }                      | suspension to the specified line or    |
|          | { goto} { #label}                      | 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).  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.                                |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------

          Table I-19.  Miscellaneous Commands (cont.) 
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
|   Cmd    |                 Syntax                 |              Description               |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
| h        |                                        | Prints a command summary, called the   |
|          | { h   } [ command]                     | Help file which describes the syntax   |
|          | { help}                                | 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.                              |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
| q        |                                        | Quits the debugger and asks for        |
|          | { q   }                                | confirmation:  enter y (yes) or n      |
|          | { quit}                                | (no).                                  |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
| sm       |                                        | Suspends the more feature and lets you |
|          | { sm          }                        | view the output in a continuous        |
|          | { suspend more}                        | stream.                                |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
| tc       |                                        | Toggles case sensitivity; determines   |
|          | { tc         }                         | whether or not searches or names are   |
|          | { toggle case}                         | case sensitive.                        |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
| do       |                                        | Re-execute the command identified by   |
|          | { do} [ cmdid] [ ,editstring]          | 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.      |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
| redo     |                                        | Allows you to edit and re-execute the  |
|          | { redo} [ cmdid] [ ,editstring]        | 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.      |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
| listredo |                                        | Lists commands from the redo stack     |
|          | { listredo} [ start] [ ,end]           | between start and end inclusive.  The  |
|          |                                        | optional start and end can be positive |
|          |                                        | or negative numbers.                   |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------



MPE/iX 5.0 Documentation