HPlogo System Debug Reference Manual > Chapter 2 User Interface

Command Line Overview

MPE documents

Complete PDF
Table of Contents
Index

E0201 Edition 4 ♥
E0300 Edition 3
E0692 Edition 3

System Debug displays a prompt when it is ready to accept a command interactively. The standard prompt looks like this:

  $10 ($42) nmdebug >

The first number is the current command number. This is the number that is assigned to the command entered at the prompt. Blank lines do not cause the command number to increase. The number in parentheses is the process identification number (PIN) of the current process. If Debug is entered from the CI, then this is the CI's PIN.

The dollar signs in front of the numbers indicate that the current output radix is hexadecimal. Except for a few obvious exceptions, most numbers are displayed in the current output base. The abbreviations for numeric radices are

  % - octal,     # - decimal,     $ - hexadecimal.

The nmdebug > part of the prompt is composed of two parts. The first, nm, indicates that the current mode of System Debug is native mode. The other possibility is cm for compatibility mode. The second part, debug, identifies the name of the tool being run. Another possibility for this is dat.

The prompt can be changed with the ENV command as follows:

  $10 ($42) nmdebug > env prompt "mode ' > '"
  nm >

Command names can be entered in either upper- or lowercase and may be followed by their parameters, separated from one another by either blanks or commas. The specifications of individual commands may also describe special parameters that are also accepted.

Comments can be entered on any command line, and are introduced by the sequence /*. Everything on a command line after the /* is ignored:

  CMD1  parm1     /* this is a comment...

Long commands may be spread across several lines by using the command continuation character "&". Command lines ending with this character are continued on the following line. The special prompt cont > is used to indicate that command continuation is in progress:

  $nmdebug > wl 'This is a long &
   cont > line broken into&
   cont >  three parts.'
   This is a long line broken into three parts.
  $nmdebug >

The semicolon separates multiple commands entered on the same line:

  CMD1; CMD2; CMD3; ...

A command list can be formed by enclosing multiple commands within curly braces. Command lists are syntactically single commands, and are frequently used as command parameters:

  b myproc, 1,, {CMD1; CMD2; CMD3}

Unterminated command lists, which are introduced with a left curly brace, can be continued on successive input lines without the use of the command continuation character. The command prompt changes to indicate that a multiline command list is being read, and it displays the current nesting level of the braces. When the final closing right brace is encountered, the prompt changes back to the normal command line prompt:

  $nmdebug > if p1 > 0 then {
   {$1} multi > wl "parm is:" p1;
   {$1} multi > var curbias = p1+bias}
  $nmdebug >




Chapter 2 User Interface


Data Types