Home » CEEFAX disks » telesoftware15.adl » 06-05-89/PROBE_HLP
06-05-89/PROBE_HLP
This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.
Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.
| Tape/disk: | Home » CEEFAX disks » telesoftware15.adl |
| Filename: | 06-05-89/PROBE_HLP |
| Read OK: | ✔ |
| File size: | 2F00 bytes |
| Load address: | 0000 |
| Exec address: | FFFFFFFF |
File contents
P
*
*
ASSIGN
BREAK
CALLS
DISPLAY
ECHO
GO
HELP
KEY
LIST
PROFILE
QUIT
ROUTE
STEP
TRACE
VDU
WATCH
XECUTE
.
PROBE checks for breakpoints, tracing, watching, or striking of any key at
the start of each line of the source program on which a statement starts.
When execution of the program is interrupted, the following commands are
available:
A(ssign) new value to variable P(rofile) on/off
B(reak) into program at event QUIT to operating system
C(alls) to reach current point R(oute) taken to current point
D(isplay) value of variable(s) S(tep) execution through source
E(cho) screen output to file T(race) execution in object code
G(o) on with execution V(DU) set VDU control codes
H(elp) explain command use W(atch) variable or source lines
K(ey) interruption on/off X (eXecute) DOS command
L(ist) source lines
Further help is available on each of these.
A syntax-description of each command is given. Alternatives are separated by
a vertical bar "|", optional parts are shown in brackets "[]" or where the
contents can be repeated, by braces "{}". Grouping is shown by parentheses
"<>"
Important parts of the syntax are:
character-string characters between apostrophes ('String')
integer-constant a constant with an integer value (123, -1, 'c')
qualifier naming a source file ('LOGFILE':), subroutine
or function (XSUB:, IFUNC:)
variable a variable of the program under test (i, ia(1, j))
value number, boolean, enumerated, char, set or string
constant, or variable value (12, 17.3E2, true, v)
break-watch-specifier source line or range, variable, variable with
condition, or nothing at all.
These are defined on the next screen.
Definitions of syntactic terms used in the commands:
break-watch-specifier =
[ qualifier ] < [lines] | variable [op value]>
qualifier = file-name : | routine-name :
value = variable | constant
lines = integer-constant [ .. integer-constant]
line-count = integer-constant
constant = integer-constant | real-constant | double-precision-constant |
complex-constant | character-string
variable = identifier | identifier ( value { , value } )
op = = | <> | < | >= | > | <=
routine-name = identifier
file-name = character-string
character-string = ' { character } '
The form of identifiers, and the various number constants is as in Fortran.
ASSIGN [qualifier] variable = value
The value of the given variable is changed as specified. The variable
identified is that which would be referred to by the name when used at the
current (or given) point in the source program. Array variables may only be
altered element by element.
examples
A count=3
A size[I, 3]=25.3
BREAK [break-watch-specifier] | - | ?
break-watch-specifier =
[qualifier] <[lines]|variable [op value]>
The executing program will be interrupted each time the specified event
occurs. The qualifier identifies a source file or subroutine/function.
Execution is interrupted at given source line(s), on changes in a given
variable, or on a variable being greater, equal or less than a given value.
The break is added to existing breaks, any one of which will cause
interruption of execution. "B -" removes, and "B ?" lists all current
breaks. With "B" alone, a break occurs on all source lines. Specifying
just a start line number gives a single line. Where a subroutine is
specified, execution of any source line in the subroutine causes a break.
examples
B ReadItem:
B size<=0
CALLS
The nest of active procedure or function calls leading to the current
execution point is displayed, starting with the currently active source line
and working outwards to the main program. The names of the active routines
are displayed. Their variables can be inspected by using these names as
qualifiers to the display command.
example
C
DISPLAY [ qualifier ] [ variable ]
If a variable is named, the current value of the variable is displayed.
Whole arrays may be displayed in this way. Where only a qualifier is given,
parameters and local variables of the routine are named and displayed. Where
only a source file is given, variables of the main program in that file are
displayed. Where no parameter is given, parameters and variables of the
currently active subroutine, function or program are named and displayed.
examples
DISPLAY ReadItem:
D SORT:a(176)
ECHO
The subsequent console dialogue with PROBE will also be copied to the disk
file PROBE.LOG. If logging is already on, it will be switched off.
example:
ECHO
E
GO [break-watch-specifier]
break-watch-specifier =
[qualifier] <[lines]|variable [op value]>
Execution of the subject program is resumed, with current Watch and Break
conditions active. A break-watch condition may be specified, in which case
that condition will become active in addition to those specified with the
Break and Watch commands, but will not remain active when the program under
test is next interrupted.
examples
GO
G 1477
G testproc:
HELP [ Assign | Break | Calls | Display |
Echo | Go | Help | Key |
List | Profile | Quit | Route |
Step | Trace | VDU | Watch | X ]
Information regarding the specified command is given, or if no command is
specified, a general description of Probe facilities is displayed. Commands
about which information is requested may be abbreviated when used as
parameters to HELP, in the same way as when using the commands themselves.
examples
HELP
H W
HELP BREAK
KEY
Probe's facility to interrupt a running program by striking a key is
switched on or off (reversing its current setting). A message is displayed
confirming its new setting. The command is only useful when the program
under test itself tests the keyboard. Unless Probe's use of keyboard
interrupts is disabled, it is not possible to exercise the keyboard checking
in the program under test.
example
K
LIST [ qualifier ] [ lines ]
The specified source lines are displayed. If no source file is specified
then the source file for the current execution point is assumed. If no
source line is specified, then lines in the vicinity of the current program
execution point are displayed. Subsequent list commands without parameters
will display lines following on from the preceding list command. If the
qualifier gives a subroutine name, it must be currently in execution. The
source file containing the subroutine will be listed.
example
L
L moveto:15..30
PROFILE
The profiling option is switched on/off. A message displays the new setting
(ON or OFF). A 'profile' of a program shows how frequently each line is
executed. When profiling is selected, execution counts of all source lines
are maintained. When a LIST command is subsequently executed, the execution
counts are displayed on screen in addition to the line numbers. The ECHO
command can be used to retain a copy of the counts for analysis or printing.
example
PROFILE
QUIT
Object program and Probe execution are terminated. This command must be
entered in full in order to take effect; abbreviations will be rejected.
Only the ECHO file (if any) will be closed. Any files of the program under
test will not be closed. Information still buffered in the runtime library
will not have been written to disc.
example
QUIT
ROUTE
The most recently executed few source lines are displayed. There are no
parameters. The lines are displayed in the order in which their execution
started. Lines containing a subroutine or function call may still be in
course of execution if the function has not yet returned. These lines will
also appear in a CALLS command display.
example
ROUTE
STEP [ line-count ]
The object program's execution is resumed for the specified number of lines.
If no line-count is specified, a single line is executed. Note that only
lines on which an executable statement starts are counted. These are marked
in the source listing by an asterisk following the line number.
S 5
TRACE
The object program's execution is resumed for the next source line. If the
DOS DEBUG program is active, it is first entered at the start of the object
code for the current source line. DEBUG "T" commands can then be used to
step through the object program instructions. In order to use this
facility, start Probe with a DOS command such as "PROBE DEBUG PROGRAM.EXE",
then start the program using the DEBUG "g" command, to enter Probe at the
start of the program under test.
example
T
VDU integer-constant { , integer-constant }
Probe can send control sequences to the screen in order to distinguish text
output by the program under test, text output by Probe, and commands input
to Probe. These control sequences are identified by the numbers 0, 1 and 2
respectively. They may be set up or altered with the VDU command. The
first parameter is the string number, and following parameters are the
character codes for the characters forming the control sequence. Refer to
computer manufacturer's documentation for suitable control sequences.
example
VDU 0,27,'[','3','2','m'
VDU 1,27,'[','3','6','m'
VDU 2,27,'[','3','3','m'
This would set green program output, cyan Probe output and yellow Probe
input under MS-DOS with ANSI.SYS installed.
WATCH [break-watch-specifier] | - | ?
break-watch-specifier =
[qualifier] <[lines]|variable [op value])>
When the given condition holds during program execution, source line, (and
variable value) are displayed. When the source text is not available, only
the source file name, subroutine name and line number are displayed.
Subroutine and file name are suppressed if they have not changed since the
previous displayed values. Several watch and break requests can be active
at the same time. In this case, the overall display will reflect the
combination of all the current requests.
examples
W
W dosort:120..150
W a(I)<=34.2E9
X
The remainder of the line after the X is passed to DOS as a command for
execution. In this way it possible to use commands like DIR, or EDLIN
without disturbing the Probe session. If another Pascal program is executed,
it is not possible to use the same copy of Probe to test it unless there is
no program currently under test.
examples
X DIR *.DAT
X PROBE ANOTHER
00000000 50 0d 0a 2a 0d 0a 2a 0d 0a 41 53 53 49 47 4e 0d |P..*..*..ASSIGN.|
00000010 0a 42 52 45 41 4b 0d 0a 43 41 4c 4c 53 0d 0a 44 |.BREAK..CALLS..D|
00000020 49 53 50 4c 41 59 0d 0a 45 43 48 4f 0d 0a 47 4f |ISPLAY..ECHO..GO|
00000030 0d 0a 48 45 4c 50 0d 0a 4b 45 59 0d 0a 4c 49 53 |..HELP..KEY..LIS|
00000040 54 0d 0a 50 52 4f 46 49 4c 45 0d 0a 51 55 49 54 |T..PROFILE..QUIT|
00000050 0d 0a 52 4f 55 54 45 0d 0a 53 54 45 50 0d 0a 54 |..ROUTE..STEP..T|
00000060 52 41 43 45 0d 0a 56 44 55 0d 0a 57 41 54 43 48 |RACE..VDU..WATCH|
00000070 0d 0a 58 45 43 55 54 45 0d 0a 2e 0d 0a 50 52 4f |..XECUTE.....PRO|
00000080 42 45 20 63 68 65 63 6b 73 20 66 6f 72 20 62 72 |BE checks for br|
00000090 65 61 6b 70 6f 69 6e 74 73 2c 20 20 74 72 61 63 |eakpoints, trac|
000000a0 69 6e 67 2c 20 20 77 61 74 63 68 69 6e 67 2c 20 |ing, watching, |
000000b0 6f 72 20 73 74 72 69 6b 69 6e 67 20 6f 66 20 61 |or striking of a|
000000c0 6e 79 20 6b 65 79 20 61 74 0d 0a 74 68 65 20 20 |ny key at..the |
000000d0 73 74 61 72 74 20 6f 66 20 65 61 63 68 20 6c 69 |start of each li|
000000e0 6e 65 20 6f 66 20 74 68 65 20 73 6f 75 72 63 65 |ne of the source|
000000f0 20 70 72 6f 67 72 61 6d 20 6f 6e 20 77 68 69 63 | program on whic|
00000100 68 20 61 20 20 73 74 61 74 65 6d 65 6e 74 20 20 |h a statement |
00000110 73 74 61 72 74 73 2e 20 0d 0a 57 68 65 6e 20 20 |starts. ..When |
00000120 65 78 65 63 75 74 69 6f 6e 20 6f 66 20 74 68 65 |execution of the|
00000130 20 70 72 6f 67 72 61 6d 20 69 73 20 69 6e 74 65 | program is inte|
00000140 72 72 75 70 74 65 64 2c 20 20 74 68 65 20 66 6f |rrupted, the fo|
00000150 6c 6c 6f 77 69 6e 67 20 20 63 6f 6d 6d 61 6e 64 |llowing command|
00000160 73 20 20 61 72 65 0d 0a 61 76 61 69 6c 61 62 6c |s are..availabl|
00000170 65 3a 0d 0a 0d 0a 41 28 73 73 69 67 6e 29 20 6e |e:....A(ssign) n|
00000180 65 77 20 76 61 6c 75 65 20 74 6f 20 76 61 72 69 |ew value to vari|
00000190 61 62 6c 65 20 20 20 20 20 50 28 72 6f 66 69 6c |able P(rofil|
000001a0 65 29 20 6f 6e 2f 6f 66 66 0d 0a 42 28 72 65 61 |e) on/off..B(rea|
000001b0 6b 29 20 69 6e 74 6f 20 70 72 6f 67 72 61 6d 20 |k) into program |
000001c0 61 74 20 65 76 65 6e 74 20 20 20 20 20 20 51 55 |at event QU|
000001d0 49 54 20 74 6f 20 6f 70 65 72 61 74 69 6e 67 20 |IT to operating |
000001e0 73 79 73 74 65 6d 0d 0a 43 28 61 6c 6c 73 29 20 |system..C(alls) |
000001f0 74 6f 20 72 65 61 63 68 20 63 75 72 72 65 6e 74 |to reach current|
00000200 20 70 6f 69 6e 74 20 20 20 20 20 52 28 6f 75 74 | point R(out|
00000210 65 29 20 74 61 6b 65 6e 20 74 6f 20 63 75 72 72 |e) taken to curr|
00000220 65 6e 74 20 70 6f 69 6e 74 0d 0a 44 28 69 73 70 |ent point..D(isp|
00000230 6c 61 79 29 20 76 61 6c 75 65 20 6f 66 20 76 61 |lay) value of va|
00000240 72 69 61 62 6c 65 28 73 29 20 20 20 20 20 53 28 |riable(s) S(|
00000250 74 65 70 29 20 65 78 65 63 75 74 69 6f 6e 20 74 |tep) execution t|
00000260 68 72 6f 75 67 68 20 73 6f 75 72 63 65 0d 0a 45 |hrough source..E|
00000270 28 63 68 6f 29 20 73 63 72 65 65 6e 20 6f 75 74 |(cho) screen out|
00000280 70 75 74 20 74 6f 20 66 69 6c 65 20 20 20 20 20 |put to file |
00000290 20 20 54 28 72 61 63 65 29 20 65 78 65 63 75 74 | T(race) execut|
000002a0 69 6f 6e 20 69 6e 20 6f 62 6a 65 63 74 20 63 6f |ion in object co|
000002b0 64 65 0d 0a 47 28 6f 29 20 6f 6e 20 77 69 74 68 |de..G(o) on with|
000002c0 20 65 78 65 63 75 74 69 6f 6e 20 20 20 20 20 20 | execution |
000002d0 20 20 20 20 20 20 20 56 28 44 55 29 20 73 65 74 | V(DU) set|
000002e0 20 56 44 55 20 63 6f 6e 74 72 6f 6c 20 63 6f 64 | VDU control cod|
000002f0 65 73 0d 0a 48 28 65 6c 70 29 20 65 78 70 6c 61 |es..H(elp) expla|
00000300 69 6e 20 63 6f 6d 6d 61 6e 64 20 75 73 65 20 20 |in command use |
00000310 20 20 20 20 20 20 20 57 28 61 74 63 68 29 20 76 | W(atch) v|
00000320 61 72 69 61 62 6c 65 20 6f 72 20 73 6f 75 72 63 |ariable or sourc|
00000330 65 20 6c 69 6e 65 73 0d 0a 4b 28 65 79 29 20 69 |e lines..K(ey) i|
00000340 6e 74 65 72 72 75 70 74 69 6f 6e 20 6f 6e 2f 6f |nterruption on/o|
00000350 66 66 20 20 20 20 20 20 20 20 20 20 58 20 28 65 |ff X (e|
00000360 58 65 63 75 74 65 29 20 44 4f 53 20 63 6f 6d 6d |Xecute) DOS comm|
00000370 61 6e 64 0d 0a 4c 28 69 73 74 29 20 73 6f 75 72 |and..L(ist) sour|
00000380 63 65 20 6c 69 6e 65 73 0d 0a 20 20 20 20 20 46 |ce lines.. F|
00000390 75 72 74 68 65 72 20 68 65 6c 70 20 69 73 20 61 |urther help is a|
000003a0 76 61 69 6c 61 62 6c 65 20 6f 6e 20 65 61 63 68 |vailable on each|
000003b0 20 6f 66 20 74 68 65 73 65 2e 0d 0a 0d 0a 41 20 | of these.....A |
000003c0 73 79 6e 74 61 78 2d 64 65 73 63 72 69 70 74 69 |syntax-descripti|
000003d0 6f 6e 20 6f 66 20 65 61 63 68 20 63 6f 6d 6d 61 |on of each comma|
000003e0 6e 64 20 69 73 20 67 69 76 65 6e 2e 20 41 6c 74 |nd is given. Alt|
000003f0 65 72 6e 61 74 69 76 65 73 20 61 72 65 20 73 65 |ernatives are se|
00000400 70 61 72 61 74 65 64 20 62 79 0d 0a 61 20 76 65 |parated by..a ve|
00000410 72 74 69 63 61 6c 20 62 61 72 20 22 7c 22 2c 20 |rtical bar "|", |
00000420 20 6f 70 74 69 6f 6e 61 6c 20 70 61 72 74 73 20 | optional parts |
00000430 61 72 65 20 73 68 6f 77 6e 20 69 6e 20 62 72 61 |are shown in bra|
00000440 63 6b 65 74 73 20 22 5b 5d 22 20 20 6f 72 20 77 |ckets "[]" or w|
00000450 68 65 72 65 20 74 68 65 0d 0a 63 6f 6e 74 65 6e |here the..conten|
00000460 74 73 20 63 61 6e 20 62 65 20 72 65 70 65 61 74 |ts can be repeat|
00000470 65 64 2c 20 20 62 79 20 62 72 61 63 65 73 20 22 |ed, by braces "|
00000480 7b 7d 22 2e 20 20 47 72 6f 75 70 69 6e 67 20 69 |{}". Grouping i|
00000490 73 20 73 68 6f 77 6e 20 62 79 20 70 61 72 65 6e |s shown by paren|
000004a0 74 68 65 73 65 73 0d 0a 22 3c 3e 22 0d 0a 49 6d |theses.."<>"..Im|
000004b0 70 6f 72 74 61 6e 74 20 70 61 72 74 73 20 6f 66 |portant parts of|
000004c0 20 74 68 65 20 73 79 6e 74 61 78 20 61 72 65 3a | the syntax are:|
000004d0 0d 0a 20 20 20 20 63 68 61 72 61 63 74 65 72 2d |.. character-|
000004e0 73 74 72 69 6e 67 20 20 20 20 63 68 61 72 61 63 |string charac|
000004f0 74 65 72 73 20 62 65 74 77 65 65 6e 20 61 70 6f |ters between apo|
00000500 73 74 72 6f 70 68 65 73 20 28 27 53 74 72 69 6e |strophes ('Strin|
00000510 67 27 29 0d 0a 20 20 20 20 69 6e 74 65 67 65 72 |g').. integer|
00000520 2d 63 6f 6e 73 74 61 6e 74 20 20 20 20 61 20 63 |-constant a c|
00000530 6f 6e 73 74 61 6e 74 20 77 69 74 68 20 61 6e 20 |onstant with an |
00000540 69 6e 74 65 67 65 72 20 76 61 6c 75 65 20 28 31 |integer value (1|
00000550 32 33 2c 20 2d 31 2c 20 27 63 27 29 0d 0a 20 20 |23, -1, 'c').. |
00000560 20 20 71 75 61 6c 69 66 69 65 72 20 20 20 20 20 | qualifier |
00000570 20 20 20 20 20 20 6e 61 6d 69 6e 67 20 61 20 73 | naming a s|
00000580 6f 75 72 63 65 20 66 69 6c 65 20 28 27 4c 4f 47 |ource file ('LOG|
00000590 46 49 4c 45 27 3a 29 2c 20 73 75 62 72 6f 75 74 |FILE':), subrout|
000005a0 69 6e 65 0d 0a 20 20 20 20 20 20 20 20 20 20 20 |ine.. |
000005b0 20 20 20 20 20 20 20 20 20 20 20 20 20 6f 72 20 | or |
000005c0 66 75 6e 63 74 69 6f 6e 20 28 58 53 55 42 3a 2c |function (XSUB:,|
000005d0 20 49 46 55 4e 43 3a 29 0d 0a 20 20 20 20 76 61 | IFUNC:).. va|
000005e0 72 69 61 62 6c 65 20 20 20 20 20 20 20 20 20 20 |riable |
000005f0 20 20 61 20 76 61 72 69 61 62 6c 65 20 6f 66 20 | a variable of |
00000600 74 68 65 20 70 72 6f 67 72 61 6d 20 75 6e 64 65 |the program unde|
00000610 72 20 74 65 73 74 20 28 69 2c 20 69 61 28 31 2c |r test (i, ia(1,|
00000620 20 6a 29 29 0d 0a 20 20 20 20 76 61 6c 75 65 20 | j)).. value |
00000630 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 75 | nu|
00000640 6d 62 65 72 2c 20 62 6f 6f 6c 65 61 6e 2c 20 65 |mber, boolean, e|
00000650 6e 75 6d 65 72 61 74 65 64 2c 20 63 68 61 72 2c |numerated, char,|
00000660 20 73 65 74 20 6f 72 20 73 74 72 69 6e 67 0d 0a | set or string..|
00000670 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | |
00000680 20 20 20 20 20 20 20 20 63 6f 6e 73 74 61 6e 74 | constant|
00000690 2c 20 6f 72 20 76 61 72 69 61 62 6c 65 20 76 61 |, or variable va|
000006a0 6c 75 65 20 28 31 32 2c 20 31 37 2e 33 45 32 2c |lue (12, 17.3E2,|
000006b0 20 74 72 75 65 2c 20 76 29 0d 0a 20 20 20 20 62 | true, v).. b|
000006c0 72 65 61 6b 2d 77 61 74 63 68 2d 73 70 65 63 69 |reak-watch-speci|
000006d0 66 69 65 72 20 20 73 6f 75 72 63 65 20 6c 69 6e |fier source lin|
000006e0 65 20 6f 72 20 72 61 6e 67 65 2c 20 76 61 72 69 |e or range, vari|
000006f0 61 62 6c 65 2c 20 76 61 72 69 61 62 6c 65 20 77 |able, variable w|
00000700 69 74 68 0d 0a 20 20 20 20 20 20 20 20 20 20 20 |ith.. |
00000710 20 20 20 20 20 20 20 20 20 20 20 20 20 63 6f 6e | con|
00000720 64 69 74 69 6f 6e 2c 20 6f 72 20 6e 6f 74 68 69 |dition, or nothi|
00000730 6e 67 20 61 74 20 61 6c 6c 2e 0d 0a 0d 0a 54 68 |ng at all.....Th|
00000740 65 73 65 20 61 72 65 20 64 65 66 69 6e 65 64 20 |ese are defined |
00000750 6f 6e 20 74 68 65 20 6e 65 78 74 20 73 63 72 65 |on the next scre|
00000760 65 6e 2e 0d 0a 44 65 66 69 6e 69 74 69 6f 6e 73 |en...Definitions|
00000770 20 6f 66 20 73 79 6e 74 61 63 74 69 63 20 74 65 | of syntactic te|
00000780 72 6d 73 20 75 73 65 64 20 69 6e 20 74 68 65 20 |rms used in the |
00000790 63 6f 6d 6d 61 6e 64 73 3a 0d 0a 20 20 20 20 62 |commands:.. b|
000007a0 72 65 61 6b 2d 77 61 74 63 68 2d 73 70 65 63 69 |reak-watch-speci|
000007b0 66 69 65 72 20 3d 0d 0a 20 20 20 20 20 20 20 20 |fier =.. |
000007c0 5b 20 71 75 61 6c 69 66 69 65 72 20 5d 20 3c 20 |[ qualifier ] < |
000007d0 5b 6c 69 6e 65 73 5d 20 7c 20 76 61 72 69 61 62 |[lines] | variab|
000007e0 6c 65 20 5b 6f 70 20 76 61 6c 75 65 5d 3e 0d 0a |le [op value]>..|
000007f0 20 20 20 20 71 75 61 6c 69 66 69 65 72 20 3d 20 | qualifier = |
00000800 20 66 69 6c 65 2d 6e 61 6d 65 20 3a 20 7c 20 72 | file-name : | r|
00000810 6f 75 74 69 6e 65 2d 6e 61 6d 65 20 3a 0d 0a 20 |outine-name :.. |
00000820 20 20 20 76 61 6c 75 65 20 3d 20 76 61 72 69 61 | value = varia|
00000830 62 6c 65 20 7c 20 63 6f 6e 73 74 61 6e 74 0d 0a |ble | constant..|
00000840 20 20 20 20 6c 69 6e 65 73 20 3d 20 69 6e 74 65 | lines = inte|
00000850 67 65 72 2d 63 6f 6e 73 74 61 6e 74 20 5b 20 2e |ger-constant [ .|
00000860 2e 20 69 6e 74 65 67 65 72 2d 63 6f 6e 73 74 61 |. integer-consta|
00000870 6e 74 5d 0d 0a 20 20 20 20 6c 69 6e 65 2d 63 6f |nt].. line-co|
00000880 75 6e 74 20 3d 20 69 6e 74 65 67 65 72 2d 63 6f |unt = integer-co|
00000890 6e 73 74 61 6e 74 0d 0a 20 20 20 20 63 6f 6e 73 |nstant.. cons|
000008a0 74 61 6e 74 20 3d 20 69 6e 74 65 67 65 72 2d 63 |tant = integer-c|
000008b0 6f 6e 73 74 61 6e 74 20 7c 20 72 65 61 6c 2d 63 |onstant | real-c|
000008c0 6f 6e 73 74 61 6e 74 20 7c 20 64 6f 75 62 6c 65 |onstant | double|
000008d0 2d 70 72 65 63 69 73 69 6f 6e 2d 63 6f 6e 73 74 |-precision-const|
000008e0 61 6e 74 20 7c 0d 0a 20 20 20 20 20 20 20 20 20 |ant |.. |
000008f0 20 20 20 20 20 20 63 6f 6d 70 6c 65 78 2d 63 6f | complex-co|
00000900 6e 73 74 61 6e 74 20 7c 20 63 68 61 72 61 63 74 |nstant | charact|
00000910 65 72 2d 73 74 72 69 6e 67 0d 0a 20 20 20 20 76 |er-string.. v|
00000920 61 72 69 61 62 6c 65 20 3d 20 69 64 65 6e 74 69 |ariable = identi|
00000930 66 69 65 72 20 7c 20 69 64 65 6e 74 69 66 69 65 |fier | identifie|
00000940 72 20 28 20 76 61 6c 75 65 20 7b 20 2c 20 76 61 |r ( value { , va|
00000950 6c 75 65 20 7d 20 29 0d 0a 20 20 20 20 6f 70 20 |lue } ).. op |
00000960 3d 20 3d 20 7c 20 3c 3e 20 7c 20 3c 20 7c 20 3e |= = | <> | < | >|
00000970 3d 20 7c 20 3e 20 7c 20 3c 3d 0d 0a 20 20 20 20 |= | > | <=.. |
00000980 72 6f 75 74 69 6e 65 2d 6e 61 6d 65 20 3d 20 69 |routine-name = i|
00000990 64 65 6e 74 69 66 69 65 72 0d 0a 20 20 20 20 66 |dentifier.. f|
000009a0 69 6c 65 2d 6e 61 6d 65 20 3d 20 63 68 61 72 61 |ile-name = chara|
000009b0 63 74 65 72 2d 73 74 72 69 6e 67 0d 0a 20 20 20 |cter-string.. |
000009c0 20 63 68 61 72 61 63 74 65 72 2d 73 74 72 69 6e | character-strin|
000009d0 67 20 3d 20 27 20 7b 20 63 68 61 72 61 63 74 65 |g = ' { characte|
000009e0 72 20 7d 20 27 0d 0a 54 68 65 20 66 6f 72 6d 20 |r } '..The form |
000009f0 6f 66 20 69 64 65 6e 74 69 66 69 65 72 73 2c 20 |of identifiers, |
00000a00 61 6e 64 20 74 68 65 20 76 61 72 69 6f 75 73 20 |and the various |
00000a10 6e 75 6d 62 65 72 20 63 6f 6e 73 74 61 6e 74 73 |number constants|
00000a20 20 69 73 20 61 73 20 69 6e 20 46 6f 72 74 72 61 | is as in Fortra|
00000a30 6e 2e 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 |n..... |
00000a40 41 53 53 49 47 4e 20 5b 71 75 61 6c 69 66 69 65 |ASSIGN [qualifie|
00000a50 72 5d 20 76 61 72 69 61 62 6c 65 20 3d 20 76 61 |r] variable = va|
00000a60 6c 75 65 0d 0a 0d 0a 54 68 65 20 20 76 61 6c 75 |lue....The valu|
00000a70 65 20 20 6f 66 20 20 74 68 65 20 67 69 76 65 6e |e of the given|
00000a80 20 76 61 72 69 61 62 6c 65 20 69 73 20 63 68 61 | variable is cha|
00000a90 6e 67 65 64 20 61 73 20 20 73 70 65 63 69 66 69 |nged as specifi|
00000aa0 65 64 2e 20 20 20 54 68 65 20 20 76 61 72 69 61 |ed. The varia|
00000ab0 62 6c 65 0d 0a 69 64 65 6e 74 69 66 69 65 64 20 |ble..identified |
00000ac0 20 69 73 20 74 68 61 74 20 77 68 69 63 68 20 77 | is that which w|
00000ad0 6f 75 6c 64 20 62 65 20 72 65 66 65 72 72 65 64 |ould be referred|
00000ae0 20 74 6f 20 62 79 20 74 68 65 20 6e 61 6d 65 20 | to by the name |
00000af0 77 68 65 6e 20 75 73 65 64 20 61 74 20 20 74 68 |when used at th|
00000b00 65 0d 0a 63 75 72 72 65 6e 74 20 28 6f 72 20 67 |e..current (or g|
00000b10 69 76 65 6e 29 20 70 6f 69 6e 74 20 69 6e 20 74 |iven) point in t|
00000b20 68 65 20 73 6f 75 72 63 65 20 70 72 6f 67 72 61 |he source progra|
00000b30 6d 2e 20 20 41 72 72 61 79 20 76 61 72 69 61 62 |m. Array variab|
00000b40 6c 65 73 20 6d 61 79 20 6f 6e 6c 79 20 62 65 0d |les may only be.|
00000b50 0a 61 6c 74 65 72 65 64 20 65 6c 65 6d 65 6e 74 |.altered element|
00000b60 20 62 79 20 65 6c 65 6d 65 6e 74 2e 0d 0a 0d 0a | by element.....|
00000b70 0d 0a 65 78 61 6d 70 6c 65 73 0d 0a 0d 0a 20 20 |..examples.... |
00000b80 20 20 20 20 20 20 20 20 41 20 63 6f 75 6e 74 3d | A count=|
00000b90 33 0d 0a 20 20 20 20 20 20 20 20 20 20 41 20 73 |3.. A s|
00000ba0 69 7a 65 5b 49 2c 20 33 5d 3d 32 35 2e 33 0d 0a |ize[I, 3]=25.3..|
00000bb0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 |.. |
00000bc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | |
*
00000be0 20 20 20 20 20 20 20 20 0d 0a 0d 0a 0d 0a 20 20 | ...... |
00000bf0 20 20 20 20 20 20 20 20 42 52 45 41 4b 20 5b 62 | BREAK [b|
00000c00 72 65 61 6b 2d 77 61 74 63 68 2d 73 70 65 63 69 |reak-watch-speci|
00000c10 66 69 65 72 5d 20 7c 20 2d 20 7c 20 3f 0d 0a 20 |fier] | - | ?.. |
00000c20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 2d 77 | break-w|
00000c30 61 74 63 68 2d 73 70 65 63 69 66 69 65 72 20 3d |atch-specifier =|
00000c40 20 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 | .. |
00000c50 20 20 20 20 20 20 20 20 5b 71 75 61 6c 69 66 69 | [qualifi|
00000c60 65 72 5d 20 3c 5b 6c 69 6e 65 73 5d 7c 76 61 72 |er] <[lines]|var|
00000c70 69 61 62 6c 65 20 5b 6f 70 20 76 61 6c 75 65 5d |iable [op value]|
00000c80 3e 0d 0a 0d 0a 54 68 65 20 20 65 78 65 63 75 74 |>....The execut|
00000c90 69 6e 67 20 20 70 72 6f 67 72 61 6d 20 77 69 6c |ing program wil|
00000ca0 6c 20 62 65 20 69 6e 74 65 72 72 75 70 74 65 64 |l be interrupted|
00000cb0 20 65 61 63 68 20 74 69 6d 65 20 20 74 68 65 20 | each time the |
00000cc0 20 73 70 65 63 69 66 69 65 64 20 20 65 76 65 6e | specified even|
00000cd0 74 0d 0a 6f 63 63 75 72 73 2e 20 20 54 68 65 20 |t..occurs. The |
00000ce0 20 71 75 61 6c 69 66 69 65 72 20 20 69 64 65 6e | qualifier iden|
00000cf0 74 69 66 69 65 73 20 61 20 73 6f 75 72 63 65 20 |tifies a source |
00000d00 20 66 69 6c 65 20 20 6f 72 20 20 73 75 62 72 6f | file or subro|
00000d10 75 74 69 6e 65 2f 66 75 6e 63 74 69 6f 6e 2e 20 |utine/function. |
00000d20 0d 0a 45 78 65 63 75 74 69 6f 6e 20 20 69 73 20 |..Execution is |
00000d30 20 69 6e 74 65 72 72 75 70 74 65 64 20 61 74 20 | interrupted at |
00000d40 67 69 76 65 6e 20 73 6f 75 72 63 65 20 6c 69 6e |given source lin|
00000d50 65 28 73 29 2c 20 20 6f 6e 20 63 68 61 6e 67 65 |e(s), on change|
00000d60 73 20 69 6e 20 20 61 20 20 67 69 76 65 6e 0d 0a |s in a given..|
00000d70 76 61 72 69 61 62 6c 65 2c 20 20 6f 72 20 6f 6e |variable, or on|
00000d80 20 61 20 76 61 72 69 61 62 6c 65 20 62 65 69 6e | a variable bein|
00000d90 67 20 67 72 65 61 74 65 72 2c 20 65 71 75 61 6c |g greater, equal|
00000da0 20 6f 72 20 6c 65 73 73 20 74 68 61 6e 20 61 20 | or less than a |
00000db0 67 69 76 65 6e 20 76 61 6c 75 65 2e 20 0d 0a 54 |given value. ..T|
00000dc0 68 65 20 20 62 72 65 61 6b 20 20 69 73 20 20 61 |he break is a|
00000dd0 64 64 65 64 20 20 74 6f 20 65 78 69 73 74 69 6e |dded to existin|
00000de0 67 20 62 72 65 61 6b 73 2c 20 20 61 6e 79 20 20 |g breaks, any |
00000df0 6f 6e 65 20 20 6f 66 20 20 77 68 69 63 68 20 20 |one of which |
00000e00 77 69 6c 6c 20 20 63 61 75 73 65 0d 0a 69 6e 74 |will cause..int|
00000e10 65 72 72 75 70 74 69 6f 6e 20 20 6f 66 20 20 65 |erruption of e|
00000e20 78 65 63 75 74 69 6f 6e 2e 20 20 22 42 20 2d 22 |xecution. "B -"|
00000e30 20 20 72 65 6d 6f 76 65 73 2c 20 61 6e 64 20 22 | removes, and "|
00000e40 42 20 3f 22 20 20 6c 69 73 74 73 20 20 61 6c 6c |B ?" lists all|
00000e50 20 20 63 75 72 72 65 6e 74 0d 0a 62 72 65 61 6b | current..break|
00000e60 73 2e 20 20 20 57 69 74 68 20 22 42 22 20 20 61 |s. With "B" a|
00000e70 6c 6f 6e 65 2c 20 20 61 20 62 72 65 61 6b 20 6f |lone, a break o|
00000e80 63 63 75 72 73 20 6f 6e 20 61 6c 6c 20 73 6f 75 |ccurs on all sou|
00000e90 72 63 65 20 6c 69 6e 65 73 2e 20 20 20 53 70 65 |rce lines. Spe|
00000ea0 63 69 66 79 69 6e 67 0d 0a 6a 75 73 74 20 20 61 |cifying..just a|
00000eb0 20 20 73 74 61 72 74 20 20 6c 69 6e 65 20 20 6e | start line n|
00000ec0 75 6d 62 65 72 20 67 69 76 65 73 20 61 20 73 69 |umber gives a si|
00000ed0 6e 67 6c 65 20 6c 69 6e 65 2e 20 20 20 57 68 65 |ngle line. Whe|
00000ee0 72 65 20 20 61 20 20 73 75 62 72 6f 75 74 69 6e |re a subroutin|
00000ef0 65 20 20 69 73 0d 0a 73 70 65 63 69 66 69 65 64 |e is..specified|
00000f00 2c 20 65 78 65 63 75 74 69 6f 6e 20 6f 66 20 61 |, execution of a|
00000f10 6e 79 20 73 6f 75 72 63 65 20 6c 69 6e 65 20 69 |ny source line i|
00000f20 6e 20 74 68 65 20 73 75 62 72 6f 75 74 69 6e 65 |n the subroutine|
00000f30 20 63 61 75 73 65 73 20 61 20 62 72 65 61 6b 2e | causes a break.|
00000f40 0d 0a 65 78 61 6d 70 6c 65 73 0d 0a 20 20 20 20 |..examples.. |
00000f50 20 20 20 20 20 20 42 20 52 65 61 64 49 74 65 6d | B ReadItem|
00000f60 3a 0d 0a 20 20 20 20 20 20 20 20 20 20 42 20 73 |:.. B s|
00000f70 69 7a 65 3c 3d 30 0d 0a 20 20 20 20 20 20 20 20 |ize<=0.. |
00000f80 20 20 43 41 4c 4c 53 0d 0a 0d 0a 54 68 65 20 20 | CALLS....The |
00000f90 6e 65 73 74 20 20 6f 66 20 20 61 63 74 69 76 65 |nest of active|
00000fa0 20 20 70 72 6f 63 65 64 75 72 65 20 6f 72 20 66 | procedure or f|
00000fb0 75 6e 63 74 69 6f 6e 20 63 61 6c 6c 73 20 6c 65 |unction calls le|
00000fc0 61 64 69 6e 67 20 20 74 6f 20 20 74 68 65 20 20 |ading to the |
00000fd0 63 75 72 72 65 6e 74 0d 0a 65 78 65 63 75 74 69 |current..executi|
00000fe0 6f 6e 20 70 6f 69 6e 74 20 69 73 20 64 69 73 70 |on point is disp|
00000ff0 6c 61 79 65 64 2c 20 73 74 61 72 74 69 6e 67 20 |layed, starting |
00001000 77 69 74 68 20 74 68 65 20 63 75 72 72 65 6e 74 |with the current|
00001010 6c 79 20 61 63 74 69 76 65 20 73 6f 75 72 63 65 |ly active source|
00001020 20 6c 69 6e 65 0d 0a 61 6e 64 20 77 6f 72 6b 69 | line..and worki|
00001030 6e 67 20 6f 75 74 77 61 72 64 73 20 74 6f 20 74 |ng outwards to t|
00001040 68 65 20 6d 61 69 6e 20 70 72 6f 67 72 61 6d 2e |he main program.|
00001050 20 20 20 54 68 65 20 6e 61 6d 65 73 20 6f 66 20 | The names of |
00001060 74 68 65 20 61 63 74 69 76 65 20 72 6f 75 74 69 |the active routi|
00001070 6e 65 73 0d 0a 61 72 65 20 20 64 69 73 70 6c 61 |nes..are displa|
00001080 79 65 64 2e 20 20 20 54 68 65 69 72 20 76 61 72 |yed. Their var|
00001090 69 61 62 6c 65 73 20 63 61 6e 20 62 65 20 69 6e |iables can be in|
000010a0 73 70 65 63 74 65 64 20 62 79 20 75 73 69 6e 67 |spected by using|
000010b0 20 74 68 65 73 65 20 20 6e 61 6d 65 73 20 20 61 | these names a|
000010c0 73 0d 0a 71 75 61 6c 69 66 69 65 72 73 20 74 6f |s..qualifiers to|
000010d0 20 74 68 65 20 64 69 73 70 6c 61 79 20 63 6f 6d | the display com|
000010e0 6d 61 6e 64 2e 0d 0a 0d 0a 65 78 61 6d 70 6c 65 |mand.....example|
000010f0 0d 0a 20 20 20 20 20 20 20 20 20 20 43 0d 0a 0d |.. C...|
00001100 0a 0d 0a 0d 0a 0d 0a 0d 0a 0d 0a 20 20 20 20 20 |........... |
00001110 20 20 20 20 20 44 49 53 50 4c 41 59 20 5b 20 71 | DISPLAY [ q|
00001120 75 61 6c 69 66 69 65 72 20 5d 20 5b 20 76 61 72 |ualifier ] [ var|
00001130 69 61 62 6c 65 20 5d 0d 0a 0d 0a 49 66 20 20 61 |iable ]....If a|
00001140 20 20 76 61 72 69 61 62 6c 65 20 69 73 20 6e 61 | variable is na|
00001150 6d 65 64 2c 20 20 74 68 65 20 63 75 72 72 65 6e |med, the curren|
00001160 74 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 76 |t value of the v|
00001170 61 72 69 61 62 6c 65 20 20 69 73 20 20 64 69 73 |ariable is dis|
00001180 70 6c 61 79 65 64 2e 20 0d 0a 57 68 6f 6c 65 20 |played. ..Whole |
00001190 61 72 72 61 79 73 20 6d 61 79 20 62 65 20 64 69 |arrays may be di|
000011a0 73 70 6c 61 79 65 64 20 69 6e 20 74 68 69 73 20 |splayed in this |
000011b0 77 61 79 2e 20 20 57 68 65 72 65 20 6f 6e 6c 79 |way. Where only|
000011c0 20 61 20 71 75 61 6c 69 66 69 65 72 20 69 73 20 | a qualifier is |
000011d0 67 69 76 65 6e 2c 0d 0a 70 61 72 61 6d 65 74 65 |given,..paramete|
000011e0 72 73 20 61 6e 64 20 6c 6f 63 61 6c 20 76 61 72 |rs and local var|
000011f0 69 61 62 6c 65 73 20 6f 66 20 74 68 65 20 72 6f |iables of the ro|
00001200 75 74 69 6e 65 20 61 72 65 20 6e 61 6d 65 64 20 |utine are named |
00001210 61 6e 64 20 64 69 73 70 6c 61 79 65 64 2e 20 57 |and displayed. W|
00001220 68 65 72 65 0d 0a 6f 6e 6c 79 20 61 20 73 6f 75 |here..only a sou|
00001230 72 63 65 20 66 69 6c 65 20 69 73 20 67 69 76 65 |rce file is give|
00001240 6e 2c 20 20 76 61 72 69 61 62 6c 65 73 20 6f 66 |n, variables of|
00001250 20 74 68 65 20 6d 61 69 6e 20 70 72 6f 67 72 61 | the main progra|
00001260 6d 20 69 6e 20 74 68 61 74 20 66 69 6c 65 20 61 |m in that file a|
00001270 72 65 0d 0a 64 69 73 70 6c 61 79 65 64 2e 20 20 |re..displayed. |
00001280 20 57 68 65 72 65 20 6e 6f 20 70 61 72 61 6d 65 | Where no parame|
00001290 74 65 72 20 69 73 20 67 69 76 65 6e 2c 20 20 70 |ter is given, p|
000012a0 61 72 61 6d 65 74 65 72 73 20 61 6e 64 20 76 61 |arameters and va|
000012b0 72 69 61 62 6c 65 73 20 20 6f 66 20 20 74 68 65 |riables of the|
000012c0 0d 0a 63 75 72 72 65 6e 74 6c 79 20 61 63 74 69 |..currently acti|
000012d0 76 65 20 73 75 62 72 6f 75 74 69 6e 65 2c 20 20 |ve subroutine, |
000012e0 66 75 6e 63 74 69 6f 6e 20 6f 72 20 70 72 6f 67 |function or prog|
000012f0 72 61 6d 20 61 72 65 20 6e 61 6d 65 64 20 61 6e |ram are named an|
00001300 64 20 64 69 73 70 6c 61 79 65 64 2e 0d 0a 0d 0a |d displayed.....|
00001310 65 78 61 6d 70 6c 65 73 0d 0a 20 20 20 20 20 20 |examples.. |
00001320 20 20 20 20 44 49 53 50 4c 41 59 20 52 65 61 64 | DISPLAY Read|
00001330 49 74 65 6d 3a 0d 0a 20 20 20 20 20 20 20 20 20 |Item:.. |
00001340 20 44 20 53 4f 52 54 3a 61 28 31 37 36 29 0d 0a | D SORT:a(176)..|
00001350 0d 0a 0d 0a 0d 0a 0d 0a 20 20 20 20 20 20 20 20 |........ |
00001360 20 20 45 43 48 4f 0d 0a 0d 0a 54 68 65 20 20 73 | ECHO....The s|
00001370 75 62 73 65 71 75 65 6e 74 20 63 6f 6e 73 6f 6c |ubsequent consol|
00001380 65 20 64 69 61 6c 6f 67 75 65 20 77 69 74 68 20 |e dialogue with |
00001390 50 52 4f 42 45 20 77 69 6c 6c 20 61 6c 73 6f 20 |PROBE will also |
000013a0 62 65 20 63 6f 70 69 65 64 20 74 6f 20 74 68 65 |be copied to the|
000013b0 20 20 64 69 73 6b 0d 0a 66 69 6c 65 20 50 52 4f | disk..file PRO|
000013c0 42 45 2e 4c 4f 47 2e 20 20 49 66 20 6c 6f 67 67 |BE.LOG. If logg|
000013d0 69 6e 67 20 69 73 20 61 6c 72 65 61 64 79 20 6f |ing is already o|
000013e0 6e 2c 20 69 74 20 77 69 6c 6c 20 62 65 20 73 77 |n, it will be sw|
000013f0 69 74 63 68 65 64 20 6f 66 66 2e 0d 0a 20 0d 0a |itched off... ..|
00001400 65 78 61 6d 70 6c 65 3a 0d 0a 0d 0a 20 20 20 20 |example:.... |
00001410 20 20 20 20 20 45 43 48 4f 0d 0a 20 20 20 20 20 | ECHO.. |
00001420 20 20 20 20 45 0d 0a 0d 0a 0d 0a 0d 0a 0d 0a 0d | E...........|
00001430 0a 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 47 |..... G|
00001440 4f 20 5b 62 72 65 61 6b 2d 77 61 74 63 68 2d 73 |O [break-watch-s|
00001450 70 65 63 69 66 69 65 72 5d 0d 0a 20 20 20 20 20 |pecifier].. |
00001460 20 20 20 20 20 62 72 65 61 6b 2d 77 61 74 63 68 | break-watch|
00001470 2d 73 70 65 63 69 66 69 65 72 20 3d 20 0d 0a 20 |-specifier = .. |
00001480 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | |
00001490 20 20 20 20 5b 71 75 61 6c 69 66 69 65 72 5d 20 | [qualifier] |
000014a0 3c 5b 6c 69 6e 65 73 5d 7c 76 61 72 69 61 62 6c |<[lines]|variabl|
000014b0 65 20 5b 6f 70 20 76 61 6c 75 65 5d 3e 0d 0a 0d |e [op value]>...|
000014c0 0a 45 78 65 63 75 74 69 6f 6e 20 20 6f 66 20 74 |.Execution of t|
000014d0 68 65 20 73 75 62 6a 65 63 74 20 70 72 6f 67 72 |he subject progr|
000014e0 61 6d 20 69 73 20 72 65 73 75 6d 65 64 2c 20 20 |am is resumed, |
000014f0 77 69 74 68 20 63 75 72 72 65 6e 74 20 57 61 74 |with current Wat|
00001500 63 68 20 61 6e 64 20 20 42 72 65 61 6b 0d 0a 63 |ch and Break..c|
00001510 6f 6e 64 69 74 69 6f 6e 73 20 61 63 74 69 76 65 |onditions active|
00001520 2e 20 20 41 20 62 72 65 61 6b 2d 77 61 74 63 68 |. A break-watch|
00001530 20 63 6f 6e 64 69 74 69 6f 6e 20 6d 61 79 20 62 | condition may b|
00001540 65 20 73 70 65 63 69 66 69 65 64 2c 20 20 69 6e |e specified, in|
00001550 20 77 68 69 63 68 20 63 61 73 65 0d 0a 74 68 61 | which case..tha|
00001560 74 20 20 63 6f 6e 64 69 74 69 6f 6e 20 20 77 69 |t condition wi|
00001570 6c 6c 20 20 62 65 63 6f 6d 65 20 61 63 74 69 76 |ll become activ|
00001580 65 20 69 6e 20 61 64 64 69 74 69 6f 6e 20 74 6f |e in addition to|
00001590 20 74 68 6f 73 65 20 73 70 65 63 69 66 69 65 64 | those specified|
000015a0 20 77 69 74 68 20 74 68 65 0d 0a 42 72 65 61 6b | with the..Break|
000015b0 20 61 6e 64 20 57 61 74 63 68 20 63 6f 6d 6d 61 | and Watch comma|
000015c0 6e 64 73 2c 20 20 62 75 74 20 77 69 6c 6c 20 6e |nds, but will n|
000015d0 6f 74 20 72 65 6d 61 69 6e 20 61 63 74 69 76 65 |ot remain active|
000015e0 20 77 68 65 6e 20 74 68 65 20 70 72 6f 67 72 61 | when the progra|
000015f0 6d 20 75 6e 64 65 72 0d 0a 74 65 73 74 20 69 73 |m under..test is|
00001600 20 6e 65 78 74 20 69 6e 74 65 72 72 75 70 74 65 | next interrupte|
00001610 64 2e 0d 0a 0d 0a 65 78 61 6d 70 6c 65 73 0d 0a |d.....examples..|
00001620 0d 0a 20 20 20 20 20 20 20 20 20 20 47 4f 0d 0a |.. GO..|
00001630 20 20 20 20 20 20 20 20 20 20 47 20 31 34 37 37 | G 1477|
00001640 0d 0a 20 20 20 20 20 20 20 20 20 20 47 20 74 65 |.. G te|
00001650 73 74 70 72 6f 63 3a 0d 0a 0d 0a 20 20 20 20 20 |stproc:.... |
00001660 20 20 20 20 20 20 20 48 45 4c 50 20 5b 20 41 73 | HELP [ As|
00001670 73 69 67 6e 20 7c 20 42 72 65 61 6b 20 20 20 7c |sign | Break ||
00001680 20 43 61 6c 6c 73 20 7c 20 44 69 73 70 6c 61 79 | Calls | Display|
00001690 20 7c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 | |.. |
000016a0 20 20 20 20 20 20 20 45 63 68 6f 20 20 20 7c 20 | Echo | |
000016b0 47 6f 20 20 20 20 20 20 7c 20 48 65 6c 70 20 20 |Go | Help |
000016c0 7c 20 4b 65 79 20 20 20 20 20 7c 0d 0a 20 20 20 || Key |.. |
000016d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | |
000016e0 4c 69 73 74 20 20 20 7c 20 50 72 6f 66 69 6c 65 |List | Profile|
000016f0 20 7c 20 51 75 69 74 20 20 7c 20 52 6f 75 74 65 | | Quit | Route|
00001700 20 20 20 7c 0d 0a 20 20 20 20 20 20 20 20 20 20 | |.. |
00001710 20 20 20 20 20 20 20 20 20 53 74 65 70 20 20 20 | Step |
00001720 7c 20 54 72 61 63 65 20 20 20 7c 20 56 44 55 20 || Trace | VDU |
00001730 20 20 7c 20 57 61 74 63 68 20 20 20 7c 20 58 20 | | Watch | X |
00001740 5d 0d 0a 0d 0a 49 6e 66 6f 72 6d 61 74 69 6f 6e |]....Information|
00001750 20 20 72 65 67 61 72 64 69 6e 67 20 74 68 65 20 | regarding the |
00001760 73 70 65 63 69 66 69 65 64 20 63 6f 6d 6d 61 6e |specified comman|
00001770 64 20 69 73 20 67 69 76 65 6e 2c 20 20 6f 72 20 |d is given, or |
00001780 69 66 20 6e 6f 20 63 6f 6d 6d 61 6e 64 20 20 69 |if no command i|
00001790 73 0d 0a 73 70 65 63 69 66 69 65 64 2c 20 61 20 |s..specified, a |
000017a0 67 65 6e 65 72 61 6c 20 64 65 73 63 72 69 70 74 |general descript|
000017b0 69 6f 6e 20 6f 66 20 50 72 6f 62 65 20 66 61 63 |ion of Probe fac|
000017c0 69 6c 69 74 69 65 73 20 69 73 20 64 69 73 70 6c |ilities is displ|
000017d0 61 79 65 64 2e 20 20 43 6f 6d 6d 61 6e 64 73 0d |ayed. Commands.|
000017e0 0a 61 62 6f 75 74 20 20 77 68 69 63 68 20 20 69 |.about which i|
000017f0 6e 66 6f 72 6d 61 74 69 6f 6e 20 20 69 73 20 20 |nformation is |
00001800 72 65 71 75 65 73 74 65 64 20 6d 61 79 20 62 65 |requested may be|
00001810 20 20 61 62 62 72 65 76 69 61 74 65 64 20 20 77 | abbreviated w|
00001820 68 65 6e 20 20 75 73 65 64 20 20 61 73 0d 0a 70 |hen used as..p|
00001830 61 72 61 6d 65 74 65 72 73 20 74 6f 20 48 45 4c |arameters to HEL|
00001840 50 2c 20 69 6e 20 74 68 65 20 73 61 6d 65 20 77 |P, in the same w|
00001850 61 79 20 61 73 20 77 68 65 6e 20 75 73 69 6e 67 |ay as when using|
00001860 20 74 68 65 20 63 6f 6d 6d 61 6e 64 73 20 74 68 | the commands th|
00001870 65 6d 73 65 6c 76 65 73 2e 20 0d 0a 20 20 20 20 |emselves. .. |
00001880 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | |
*
00001900 0d 0a 65 78 61 6d 70 6c 65 73 0d 0a 20 20 20 20 |..examples.. |
00001910 20 20 20 20 20 20 48 45 4c 50 0d 0a 20 20 20 20 | HELP.. |
00001920 20 20 20 20 20 20 48 20 57 0d 0a 20 20 20 20 20 | H W.. |
00001930 20 20 20 20 20 48 45 4c 50 20 42 52 45 41 4b 0d | HELP BREAK.|
00001940 0a 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 4b |..... K|
00001950 45 59 0d 0a 0d 0a 50 72 6f 62 65 27 73 20 20 66 |EY....Probe's f|
00001960 61 63 69 6c 69 74 79 20 20 74 6f 20 20 69 6e 74 |acility to int|
00001970 65 72 72 75 70 74 20 20 61 20 72 75 6e 6e 69 6e |errupt a runnin|
00001980 67 20 70 72 6f 67 72 61 6d 20 62 79 20 20 73 74 |g program by st|
00001990 72 69 6b 69 6e 67 20 20 61 20 20 6b 65 79 20 20 |riking a key |
000019a0 69 73 0d 0a 73 77 69 74 63 68 65 64 20 6f 6e 20 |is..switched on |
000019b0 6f 72 20 6f 66 66 20 28 72 65 76 65 72 73 69 6e |or off (reversin|
000019c0 67 20 69 74 73 20 63 75 72 72 65 6e 74 20 73 65 |g its current se|
000019d0 74 74 69 6e 67 29 2e 20 20 20 41 20 6d 65 73 73 |tting). A mess|
000019e0 61 67 65 20 69 73 20 64 69 73 70 6c 61 79 65 64 |age is displayed|
000019f0 0d 0a 63 6f 6e 66 69 72 6d 69 6e 67 20 20 69 74 |..confirming it|
00001a00 73 20 6e 65 77 20 73 65 74 74 69 6e 67 2e 20 20 |s new setting. |
00001a10 20 54 68 65 20 63 6f 6d 6d 61 6e 64 20 69 73 20 | The command is |
00001a20 6f 6e 6c 79 20 75 73 65 66 75 6c 20 77 68 65 6e |only useful when|
00001a30 20 20 74 68 65 20 20 70 72 6f 67 72 61 6d 0d 0a | the program..|
00001a40 75 6e 64 65 72 20 20 74 65 73 74 20 20 69 74 73 |under test its|
00001a50 65 6c 66 20 20 74 65 73 74 73 20 74 68 65 20 6b |elf tests the k|
00001a60 65 79 62 6f 61 72 64 2e 20 20 20 55 6e 6c 65 73 |eyboard. Unles|
00001a70 73 20 50 72 6f 62 65 27 73 20 20 75 73 65 20 20 |s Probe's use |
00001a80 6f 66 20 20 6b 65 79 62 6f 61 72 64 0d 0a 69 6e |of keyboard..in|
00001a90 74 65 72 72 75 70 74 73 20 69 73 20 64 69 73 61 |terrupts is disa|
00001aa0 62 6c 65 64 2c 20 69 74 20 69 73 20 6e 6f 74 20 |bled, it is not |
00001ab0 70 6f 73 73 69 62 6c 65 20 74 6f 20 65 78 65 72 |possible to exer|
00001ac0 63 69 73 65 20 74 68 65 20 6b 65 79 62 6f 61 72 |cise the keyboar|
00001ad0 64 20 63 68 65 63 6b 69 6e 67 0d 0a 69 6e 20 74 |d checking..in t|
00001ae0 68 65 20 70 72 6f 67 72 61 6d 20 75 6e 64 65 72 |he program under|
00001af0 20 74 65 73 74 2e 0d 0a 0d 0a 65 78 61 6d 70 6c | test.....exampl|
00001b00 65 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 4b |e.... K|
00001b10 0d 0a 0d 0a 0d 0a 0d 0a 0d 0a 20 20 20 20 20 20 |.......... |
00001b20 20 20 20 20 4c 49 53 54 20 5b 20 71 75 61 6c 69 | LIST [ quali|
00001b30 66 69 65 72 20 5d 20 5b 20 6c 69 6e 65 73 20 5d |fier ] [ lines ]|
00001b40 0d 0a 0d 0a 54 68 65 20 20 73 70 65 63 69 66 69 |....The specifi|
00001b50 65 64 20 73 6f 75 72 63 65 20 6c 69 6e 65 73 20 |ed source lines |
00001b60 61 72 65 20 64 69 73 70 6c 61 79 65 64 2e 20 20 |are displayed. |
00001b70 49 66 20 6e 6f 20 73 6f 75 72 63 65 20 66 69 6c |If no source fil|
00001b80 65 20 20 69 73 20 20 73 70 65 63 69 66 69 65 64 |e is specified|
00001b90 0d 0a 74 68 65 6e 20 20 74 68 65 20 20 73 6f 75 |..then the sou|
00001ba0 72 63 65 20 66 69 6c 65 20 66 6f 72 20 74 68 65 |rce file for the|
00001bb0 20 63 75 72 72 65 6e 74 20 65 78 65 63 75 74 69 | current executi|
00001bc0 6f 6e 20 70 6f 69 6e 74 20 69 73 20 20 61 73 73 |on point is ass|
00001bd0 75 6d 65 64 2e 20 20 20 49 66 20 20 6e 6f 0d 0a |umed. If no..|
00001be0 73 6f 75 72 63 65 20 6c 69 6e 65 20 69 73 20 73 |source line is s|
00001bf0 70 65 63 69 66 69 65 64 2c 20 20 74 68 65 6e 20 |pecified, then |
00001c00 6c 69 6e 65 73 20 69 6e 20 74 68 65 20 76 69 63 |lines in the vic|
00001c10 69 6e 69 74 79 20 6f 66 20 74 68 65 20 63 75 72 |inity of the cur|
00001c20 72 65 6e 74 20 70 72 6f 67 72 61 6d 0d 0a 65 78 |rent program..ex|
00001c30 65 63 75 74 69 6f 6e 20 70 6f 69 6e 74 20 61 72 |ecution point ar|
00001c40 65 20 64 69 73 70 6c 61 79 65 64 2e 20 20 53 75 |e displayed. Su|
00001c50 62 73 65 71 75 65 6e 74 20 6c 69 73 74 20 63 6f |bsequent list co|
00001c60 6d 6d 61 6e 64 73 20 77 69 74 68 6f 75 74 20 20 |mmands without |
00001c70 70 61 72 61 6d 65 74 65 72 73 0d 0a 77 69 6c 6c |parameters..will|
00001c80 20 20 64 69 73 70 6c 61 79 20 20 6c 69 6e 65 73 | display lines|
00001c90 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 6e 20 66 72 | following on fr|
00001ca0 6f 6d 20 74 68 65 20 70 72 65 63 65 64 69 6e 67 |om the preceding|
00001cb0 20 6c 69 73 74 20 63 6f 6d 6d 61 6e 64 2e 20 20 | list command. |
00001cc0 20 49 66 20 20 74 68 65 0d 0a 71 75 61 6c 69 66 | If the..qualif|
00001cd0 69 65 72 20 67 69 76 65 73 20 61 20 73 75 62 72 |ier gives a subr|
00001ce0 6f 75 74 69 6e 65 20 6e 61 6d 65 2c 20 20 69 74 |outine name, it|
00001cf0 20 6d 75 73 74 20 62 65 20 63 75 72 72 65 6e 74 | must be current|
00001d00 6c 79 20 69 6e 20 65 78 65 63 75 74 69 6f 6e 2e |ly in execution.|
00001d10 20 20 20 54 68 65 0d 0a 73 6f 75 72 63 65 20 66 | The..source f|
00001d20 69 6c 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 |ile containing t|
00001d30 68 65 20 73 75 62 72 6f 75 74 69 6e 65 20 77 69 |he subroutine wi|
00001d40 6c 6c 20 62 65 20 6c 69 73 74 65 64 2e 0d 0a 0d |ll be listed....|
00001d50 0a 65 78 61 6d 70 6c 65 0d 0a 0d 0a 20 20 20 20 |.example.... |
00001d60 20 20 20 20 20 20 4c 0d 0a 20 20 20 20 20 20 20 | L.. |
00001d70 20 20 20 4c 20 6d 6f 76 65 74 6f 3a 31 35 2e 2e | L moveto:15..|
00001d80 33 30 0d 0a 0d 0a 0d 0a 20 20 20 20 20 20 20 20 |30...... |
00001d90 20 20 50 52 4f 46 49 4c 45 0d 0a 0d 0a 54 68 65 | PROFILE....The|
00001da0 20 70 72 6f 66 69 6c 69 6e 67 20 6f 70 74 69 6f | profiling optio|
00001db0 6e 20 69 73 20 73 77 69 74 63 68 65 64 20 6f 6e |n is switched on|
00001dc0 2f 6f 66 66 2e 20 20 41 20 6d 65 73 73 61 67 65 |/off. A message|
00001dd0 20 64 69 73 70 6c 61 79 73 20 74 68 65 20 6e 65 | displays the ne|
00001de0 77 20 73 65 74 74 69 6e 67 0d 0a 28 4f 4e 20 20 |w setting..(ON |
00001df0 6f 72 20 4f 46 46 29 2e 20 20 41 20 27 70 72 6f |or OFF). A 'pro|
00001e00 66 69 6c 65 27 20 20 6f 66 20 61 20 70 72 6f 67 |file' of a prog|
00001e10 72 61 6d 20 73 68 6f 77 73 20 68 6f 77 20 66 72 |ram shows how fr|
00001e20 65 71 75 65 6e 74 6c 79 20 65 61 63 68 20 20 6c |equently each l|
00001e30 69 6e 65 20 20 69 73 0d 0a 65 78 65 63 75 74 65 |ine is..execute|
00001e40 64 2e 20 20 20 57 68 65 6e 20 70 72 6f 66 69 6c |d. When profil|
00001e50 69 6e 67 20 69 73 20 73 65 6c 65 63 74 65 64 2c |ing is selected,|
00001e60 20 65 78 65 63 75 74 69 6f 6e 20 63 6f 75 6e 74 | execution count|
00001e70 73 20 6f 66 20 61 6c 6c 20 73 6f 75 72 63 65 20 |s of all source |
00001e80 6c 69 6e 65 73 0d 0a 61 72 65 20 6d 61 69 6e 74 |lines..are maint|
00001e90 61 69 6e 65 64 2e 20 20 57 68 65 6e 20 61 20 4c |ained. When a L|
00001ea0 49 53 54 20 63 6f 6d 6d 61 6e 64 20 69 73 20 73 |IST command is s|
00001eb0 75 62 73 65 71 75 65 6e 74 6c 79 20 65 78 65 63 |ubsequently exec|
00001ec0 75 74 65 64 2c 20 74 68 65 20 65 78 65 63 75 74 |uted, the execut|
00001ed0 69 6f 6e 0d 0a 63 6f 75 6e 74 73 20 20 61 72 65 |ion..counts are|
00001ee0 20 64 69 73 70 6c 61 79 65 64 20 6f 6e 20 73 63 | displayed on sc|
00001ef0 72 65 65 6e 20 69 6e 20 61 64 64 69 74 69 6f 6e |reen in addition|
00001f00 20 74 6f 20 74 68 65 20 6c 69 6e 65 20 6e 75 6d | to the line num|
00001f10 62 65 72 73 2e 20 20 20 54 68 65 20 20 45 43 48 |bers. The ECH|
00001f20 4f 0d 0a 63 6f 6d 6d 61 6e 64 20 63 61 6e 20 62 |O..command can b|
00001f30 65 20 75 73 65 64 20 74 6f 20 72 65 74 61 69 6e |e used to retain|
00001f40 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 63 | a copy of the c|
00001f50 6f 75 6e 74 73 20 66 6f 72 20 61 6e 61 6c 79 73 |ounts for analys|
00001f60 69 73 20 6f 72 20 70 72 69 6e 74 69 6e 67 2e 0d |is or printing..|
00001f70 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 |. |
00001f80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | |
*
00001ff0 20 20 20 20 20 0d 0a 65 78 61 6d 70 6c 65 0d 0a | ..example..|
00002000 20 20 20 20 20 20 20 20 20 20 50 52 4f 46 49 4c | PROFIL|
00002010 45 0d 0a 0d 0a 0d 0a 0d 0a 0d 0a 0d 0a 20 20 20 |E............ |
00002020 20 20 20 20 20 20 20 51 55 49 54 0d 0a 0d 0a 4f | QUIT....O|
00002030 62 6a 65 63 74 20 20 70 72 6f 67 72 61 6d 20 61 |bject program a|
00002040 6e 64 20 50 72 6f 62 65 20 65 78 65 63 75 74 69 |nd Probe executi|
00002050 6f 6e 20 61 72 65 20 74 65 72 6d 69 6e 61 74 65 |on are terminate|
00002060 64 2e 20 20 20 54 68 69 73 20 63 6f 6d 6d 61 6e |d. This comman|
00002070 64 20 20 6d 75 73 74 20 20 62 65 0d 0a 65 6e 74 |d must be..ent|
00002080 65 72 65 64 20 20 69 6e 20 66 75 6c 6c 20 69 6e |ered in full in|
00002090 20 6f 72 64 65 72 20 74 6f 20 74 61 6b 65 20 65 | order to take e|
000020a0 66 66 65 63 74 3b 20 20 61 62 62 72 65 76 69 61 |ffect; abbrevia|
000020b0 74 69 6f 6e 73 20 77 69 6c 6c 20 20 62 65 20 20 |tions will be |
000020c0 72 65 6a 65 63 74 65 64 2e 0d 0a 4f 6e 6c 79 20 |rejected...Only |
000020d0 74 68 65 20 45 43 48 4f 20 66 69 6c 65 20 28 69 |the ECHO file (i|
000020e0 66 20 61 6e 79 29 20 77 69 6c 6c 20 62 65 20 63 |f any) will be c|
000020f0 6c 6f 73 65 64 2e 20 20 20 41 6e 79 20 66 69 6c |losed. Any fil|
00002100 65 73 20 6f 66 20 74 68 65 20 70 72 6f 67 72 61 |es of the progra|
00002110 6d 20 75 6e 64 65 72 0d 0a 74 65 73 74 20 77 69 |m under..test wi|
00002120 6c 6c 20 6e 6f 74 20 62 65 20 63 6c 6f 73 65 64 |ll not be closed|
00002130 2e 20 20 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 |. Information |
00002140 73 74 69 6c 6c 20 62 75 66 66 65 72 65 64 20 69 |still buffered i|
00002150 6e 20 74 68 65 20 72 75 6e 74 69 6d 65 20 6c 69 |n the runtime li|
00002160 62 72 61 72 79 0d 0a 77 69 6c 6c 20 6e 6f 74 20 |brary..will not |
00002170 68 61 76 65 20 62 65 65 6e 20 77 72 69 74 74 65 |have been writte|
00002180 6e 20 74 6f 20 64 69 73 63 2e 0d 0a 0d 0a 65 78 |n to disc.....ex|
00002190 61 6d 70 6c 65 0d 0a 20 20 20 20 20 20 20 20 20 |ample.. |
000021a0 20 51 55 49 54 0d 0a 0d 0a 0d 0a 0d 0a 0d 0a 0d | QUIT...........|
000021b0 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 52 4f 55 |... ROU|
000021c0 54 45 0d 0a 0d 0a 54 68 65 20 20 6d 6f 73 74 20 |TE....The most |
000021d0 72 65 63 65 6e 74 6c 79 20 65 78 65 63 75 74 65 |recently execute|
000021e0 64 20 66 65 77 20 73 6f 75 72 63 65 20 6c 69 6e |d few source lin|
000021f0 65 73 20 61 72 65 20 64 69 73 70 6c 61 79 65 64 |es are displayed|
00002200 2e 20 20 20 54 68 65 72 65 20 20 61 72 65 20 20 |. There are |
00002210 6e 6f 0d 0a 70 61 72 61 6d 65 74 65 72 73 2e 20 |no..parameters. |
00002220 20 20 54 68 65 20 6c 69 6e 65 73 20 61 72 65 20 | The lines are |
00002230 64 69 73 70 6c 61 79 65 64 20 69 6e 20 74 68 65 |displayed in the|
00002240 20 6f 72 64 65 72 20 69 6e 20 77 68 69 63 68 20 | order in which |
00002250 74 68 65 69 72 20 20 65 78 65 63 75 74 69 6f 6e |their execution|
00002260 0d 0a 73 74 61 72 74 65 64 2e 20 20 20 4c 69 6e |..started. Lin|
00002270 65 73 20 20 63 6f 6e 74 61 69 6e 69 6e 67 20 61 |es containing a|
00002280 20 73 75 62 72 6f 75 74 69 6e 65 20 6f 72 20 66 | subroutine or f|
00002290 75 6e 63 74 69 6f 6e 20 63 61 6c 6c 20 6d 61 79 |unction call may|
000022a0 20 73 74 69 6c 6c 20 20 62 65 20 20 69 6e 0d 0a | still be in..|
000022b0 63 6f 75 72 73 65 20 6f 66 20 65 78 65 63 75 74 |course of execut|
000022c0 69 6f 6e 20 69 66 20 74 68 65 20 66 75 6e 63 74 |ion if the funct|
000022d0 69 6f 6e 20 68 61 73 20 6e 6f 74 20 79 65 74 20 |ion has not yet |
000022e0 72 65 74 75 72 6e 65 64 2e 20 20 20 54 68 65 73 |returned. Thes|
000022f0 65 20 6c 69 6e 65 73 20 77 69 6c 6c 0d 0a 61 6c |e lines will..al|
00002300 73 6f 20 61 70 70 65 61 72 20 69 6e 20 61 20 43 |so appear in a C|
00002310 41 4c 4c 53 20 63 6f 6d 6d 61 6e 64 20 64 69 73 |ALLS command dis|
00002320 70 6c 61 79 2e 0d 0a 0d 0a 65 78 61 6d 70 6c 65 |play.....example|
00002330 0d 0a 20 20 20 20 20 20 20 20 20 20 52 4f 55 54 |.. ROUT|
00002340 45 0d 0a 0d 0a 0d 0a 0d 0a 0d 0a 0d 0a 0d 0a 20 |E.............. |
00002350 20 20 20 20 20 20 20 20 20 53 54 45 50 20 5b 20 | STEP [ |
00002360 6c 69 6e 65 2d 63 6f 75 6e 74 20 5d 0d 0a 20 20 |line-count ].. |
00002370 20 20 20 20 20 20 20 20 0d 0a 54 68 65 20 6f 62 | ..The ob|
00002380 6a 65 63 74 20 70 72 6f 67 72 61 6d 27 73 20 65 |ject program's e|
00002390 78 65 63 75 74 69 6f 6e 20 69 73 20 72 65 73 75 |xecution is resu|
000023a0 6d 65 64 20 66 6f 72 20 74 68 65 20 73 70 65 63 |med for the spec|
000023b0 69 66 69 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 |ified number of |
000023c0 6c 69 6e 65 73 2e 20 0d 0a 49 66 20 6e 6f 20 6c |lines. ..If no l|
000023d0 69 6e 65 2d 63 6f 75 6e 74 20 69 73 20 73 70 65 |ine-count is spe|
000023e0 63 69 66 69 65 64 2c 20 20 61 20 73 69 6e 67 6c |cified, a singl|
000023f0 65 20 6c 69 6e 65 20 69 73 20 65 78 65 63 75 74 |e line is execut|
00002400 65 64 2e 20 20 20 4e 6f 74 65 20 74 68 61 74 20 |ed. Note that |
00002410 20 6f 6e 6c 79 0d 0a 6c 69 6e 65 73 20 6f 6e 20 | only..lines on |
00002420 77 68 69 63 68 20 61 6e 20 65 78 65 63 75 74 61 |which an executa|
00002430 62 6c 65 20 73 74 61 74 65 6d 65 6e 74 20 73 74 |ble statement st|
00002440 61 72 74 73 20 61 72 65 20 63 6f 75 6e 74 65 64 |arts are counted|
00002450 2e 20 20 54 68 65 73 65 20 61 72 65 20 6d 61 72 |. These are mar|
00002460 6b 65 64 0d 0a 69 6e 20 74 68 65 20 73 6f 75 72 |ked..in the sour|
00002470 63 65 20 6c 69 73 74 69 6e 67 20 62 79 20 61 6e |ce listing by an|
00002480 20 61 73 74 65 72 69 73 6b 20 66 6f 6c 6c 6f 77 | asterisk follow|
00002490 69 6e 67 20 74 68 65 20 6c 69 6e 65 20 6e 75 6d |ing the line num|
000024a0 62 65 72 2e 0d 0a 0d 0a 20 20 20 20 20 20 20 20 |ber..... |
000024b0 20 20 53 20 35 0d 0a 0d 0a 0d 0a 0d 0a 0d 0a 0d | S 5...........|
000024c0 0a 0d 0a 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 |....... |
000024d0 20 54 52 41 43 45 0d 0a 20 20 20 20 20 20 20 20 | TRACE.. |
000024e0 20 20 0d 0a 54 68 65 20 6f 62 6a 65 63 74 20 70 | ..The object p|
000024f0 72 6f 67 72 61 6d 27 73 20 65 78 65 63 75 74 69 |rogram's executi|
00002500 6f 6e 20 69 73 20 72 65 73 75 6d 65 64 20 66 6f |on is resumed fo|
00002510 72 20 74 68 65 20 6e 65 78 74 20 73 6f 75 72 63 |r the next sourc|
00002520 65 20 6c 69 6e 65 2e 20 20 20 49 66 20 74 68 65 |e line. If the|
00002530 0d 0a 44 4f 53 20 44 45 42 55 47 20 70 72 6f 67 |..DOS DEBUG prog|
00002540 72 61 6d 20 69 73 20 61 63 74 69 76 65 2c 20 20 |ram is active, |
00002550 69 74 20 69 73 20 66 69 72 73 74 20 65 6e 74 65 |it is first ente|
00002560 72 65 64 20 61 74 20 74 68 65 20 73 74 61 72 74 |red at the start|
00002570 20 6f 66 20 74 68 65 20 6f 62 6a 65 63 74 0d 0a | of the object..|
00002580 63 6f 64 65 20 66 6f 72 20 74 68 65 20 63 75 72 |code for the cur|
00002590 72 65 6e 74 20 73 6f 75 72 63 65 20 6c 69 6e 65 |rent source line|
000025a0 2e 20 20 20 44 45 42 55 47 20 22 54 22 20 20 63 |. DEBUG "T" c|
000025b0 6f 6d 6d 61 6e 64 73 20 63 61 6e 20 74 68 65 6e |ommands can then|
000025c0 20 62 65 20 75 73 65 64 20 20 74 6f 0d 0a 73 74 | be used to..st|
000025d0 65 70 20 20 74 68 72 6f 75 67 68 20 20 74 68 65 |ep through the|
000025e0 20 20 6f 62 6a 65 63 74 20 20 70 72 6f 67 72 61 | object progra|
000025f0 6d 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 2e 20 |m instructions. |
00002600 20 20 49 6e 20 20 6f 72 64 65 72 20 20 74 6f 20 | In order to |
00002610 20 75 73 65 20 20 74 68 69 73 0d 0a 66 61 63 69 | use this..faci|
00002620 6c 69 74 79 2c 20 20 73 74 61 72 74 20 50 72 6f |lity, start Pro|
00002630 62 65 20 77 69 74 68 20 61 20 44 4f 53 20 63 6f |be with a DOS co|
00002640 6d 6d 61 6e 64 20 73 75 63 68 20 61 73 20 22 50 |mmand such as "P|
00002650 52 4f 42 45 20 44 45 42 55 47 20 50 52 4f 47 52 |ROBE DEBUG PROGR|
00002660 41 4d 2e 45 58 45 22 2c 0d 0a 74 68 65 6e 20 20 |AM.EXE",..then |
00002670 73 74 61 72 74 20 20 74 68 65 20 70 72 6f 67 72 |start the progr|
00002680 61 6d 20 75 73 69 6e 67 20 74 68 65 20 44 45 42 |am using the DEB|
00002690 55 47 20 22 67 22 20 63 6f 6d 6d 61 6e 64 2c 20 |UG "g" command, |
000026a0 20 74 6f 20 65 6e 74 65 72 20 50 72 6f 62 65 20 | to enter Probe |
000026b0 61 74 20 74 68 65 0d 0a 73 74 61 72 74 20 6f 66 |at the..start of|
000026c0 20 74 68 65 20 70 72 6f 67 72 61 6d 20 75 6e 64 | the program und|
000026d0 65 72 20 74 65 73 74 2e 0d 0a 20 0d 0a 20 20 20 |er test... .. |
000026e0 65 78 61 6d 70 6c 65 0d 0a 20 20 20 20 20 20 20 |example.. |
000026f0 20 20 54 0d 0a 0d 0a 0d 0a 0d 0a 0d 0a 20 20 20 | T.......... |
00002700 20 20 20 20 20 20 20 56 44 55 20 69 6e 74 65 67 | VDU integ|
00002710 65 72 2d 63 6f 6e 73 74 61 6e 74 20 7b 20 2c 20 |er-constant { , |
00002720 69 6e 74 65 67 65 72 2d 63 6f 6e 73 74 61 6e 74 |integer-constant|
00002730 20 7d 0d 0a 50 72 6f 62 65 20 63 61 6e 20 73 65 | }..Probe can se|
00002740 6e 64 20 63 6f 6e 74 72 6f 6c 20 73 65 71 75 65 |nd control seque|
00002750 6e 63 65 73 20 74 6f 20 74 68 65 20 73 63 72 65 |nces to the scre|
00002760 65 6e 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 64 |en in order to d|
00002770 69 73 74 69 6e 67 75 69 73 68 20 20 74 65 78 74 |istinguish text|
00002780 0d 0a 6f 75 74 70 75 74 20 62 79 20 74 68 65 20 |..output by the |
00002790 70 72 6f 67 72 61 6d 20 75 6e 64 65 72 20 74 65 |program under te|
000027a0 73 74 2c 20 20 74 65 78 74 20 6f 75 74 70 75 74 |st, text output|
000027b0 20 62 79 20 50 72 6f 62 65 2c 20 20 61 6e 64 20 | by Probe, and |
000027c0 63 6f 6d 6d 61 6e 64 73 20 69 6e 70 75 74 0d 0a |commands input..|
000027d0 74 6f 20 50 72 6f 62 65 2e 20 20 20 54 68 65 73 |to Probe. Thes|
000027e0 65 20 63 6f 6e 74 72 6f 6c 20 73 65 71 75 65 6e |e control sequen|
000027f0 63 65 73 20 61 72 65 20 69 64 65 6e 74 69 66 69 |ces are identifi|
00002800 65 64 20 62 79 20 74 68 65 20 6e 75 6d 62 65 72 |ed by the number|
00002810 73 20 30 2c 20 31 20 61 6e 64 20 32 0d 0a 72 65 |s 0, 1 and 2..re|
00002820 73 70 65 63 74 69 76 65 6c 79 2e 20 20 20 54 68 |spectively. Th|
00002830 65 79 20 20 6d 61 79 20 62 65 20 73 65 74 20 75 |ey may be set u|
00002840 70 20 6f 72 20 61 6c 74 65 72 65 64 20 77 69 74 |p or altered wit|
00002850 68 20 74 68 65 20 20 56 44 55 20 20 63 6f 6d 6d |h the VDU comm|
00002860 61 6e 64 2e 20 20 20 54 68 65 0d 0a 66 69 72 73 |and. The..firs|
00002870 74 20 20 70 61 72 61 6d 65 74 65 72 20 20 69 73 |t parameter is|
00002880 20 74 68 65 20 73 74 72 69 6e 67 20 6e 75 6d 62 | the string numb|
00002890 65 72 2c 20 20 61 6e 64 20 66 6f 6c 6c 6f 77 69 |er, and followi|
000028a0 6e 67 20 20 70 61 72 61 6d 65 74 65 72 73 20 20 |ng parameters |
000028b0 61 72 65 20 20 74 68 65 0d 0a 63 68 61 72 61 63 |are the..charac|
000028c0 74 65 72 20 63 6f 64 65 73 20 66 6f 72 20 74 68 |ter codes for th|
000028d0 65 20 63 68 61 72 61 63 74 65 72 73 20 66 6f 72 |e characters for|
000028e0 6d 69 6e 67 20 74 68 65 20 63 6f 6e 74 72 6f 6c |ming the control|
000028f0 20 73 65 71 75 65 6e 63 65 2e 20 20 20 52 65 66 | sequence. Ref|
00002900 65 72 20 20 74 6f 0d 0a 63 6f 6d 70 75 74 65 72 |er to..computer|
00002910 20 6d 61 6e 75 66 61 63 74 75 72 65 72 27 73 20 | manufacturer's |
00002920 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66 6f |documentation fo|
00002930 72 20 73 75 69 74 61 62 6c 65 20 63 6f 6e 74 72 |r suitable contr|
00002940 6f 6c 20 73 65 71 75 65 6e 63 65 73 2e 0d 0a 0d |ol sequences....|
00002950 0a 65 78 61 6d 70 6c 65 0d 0a 20 20 20 20 20 20 |.example.. |
00002960 20 20 20 20 56 44 55 20 30 2c 32 37 2c 27 5b 27 | VDU 0,27,'['|
00002970 2c 27 33 27 2c 27 32 27 2c 27 6d 27 0d 0a 20 20 |,'3','2','m'.. |
00002980 20 20 20 20 20 20 20 20 56 44 55 20 31 2c 32 37 | VDU 1,27|
00002990 2c 27 5b 27 2c 27 33 27 2c 27 36 27 2c 27 6d 27 |,'[','3','6','m'|
000029a0 0d 0a 20 20 20 20 20 20 20 20 20 20 56 44 55 20 |.. VDU |
000029b0 32 2c 32 37 2c 27 5b 27 2c 27 33 27 2c 27 33 27 |2,27,'[','3','3'|
000029c0 2c 27 6d 27 0d 0a 0d 0a 20 20 20 20 20 20 54 68 |,'m'.... Th|
000029d0 69 73 20 77 6f 75 6c 64 20 73 65 74 20 67 72 65 |is would set gre|
000029e0 65 6e 20 70 72 6f 67 72 61 6d 20 6f 75 74 70 75 |en program outpu|
000029f0 74 2c 20 63 79 61 6e 20 50 72 6f 62 65 20 6f 75 |t, cyan Probe ou|
00002a00 74 70 75 74 20 61 6e 64 20 79 65 6c 6c 6f 77 20 |tput and yellow |
00002a10 50 72 6f 62 65 0d 0a 20 20 20 20 20 20 69 6e 70 |Probe.. inp|
00002a20 75 74 20 75 6e 64 65 72 20 4d 53 2d 44 4f 53 20 |ut under MS-DOS |
00002a30 77 69 74 68 20 41 4e 53 49 2e 53 59 53 20 69 6e |with ANSI.SYS in|
00002a40 73 74 61 6c 6c 65 64 2e 0d 0a 20 20 20 20 20 20 |stalled... |
00002a50 20 20 20 20 57 41 54 43 48 20 5b 62 72 65 61 6b | WATCH [break|
00002a60 2d 77 61 74 63 68 2d 73 70 65 63 69 66 69 65 72 |-watch-specifier|
00002a70 5d 20 7c 20 2d 20 7c 20 3f 0d 0a 20 20 20 20 20 |] | - | ?.. |
00002a80 20 20 20 20 20 62 72 65 61 6b 2d 77 61 74 63 68 | break-watch|
00002a90 2d 73 70 65 63 69 66 69 65 72 20 3d 20 0d 0a 20 |-specifier = .. |
00002aa0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | |
00002ab0 20 20 20 20 5b 71 75 61 6c 69 66 69 65 72 5d 20 | [qualifier] |
00002ac0 3c 5b 6c 69 6e 65 73 5d 7c 76 61 72 69 61 62 6c |<[lines]|variabl|
00002ad0 65 20 5b 6f 70 20 76 61 6c 75 65 5d 29 3e 0d 0a |e [op value])>..|
00002ae0 0d 0a 57 68 65 6e 20 74 68 65 20 67 69 76 65 6e |..When the given|
00002af0 20 63 6f 6e 64 69 74 69 6f 6e 20 68 6f 6c 64 73 | condition holds|
00002b00 20 64 75 72 69 6e 67 20 70 72 6f 67 72 61 6d 20 | during program |
00002b10 65 78 65 63 75 74 69 6f 6e 2c 20 20 73 6f 75 72 |execution, sour|
00002b20 63 65 20 6c 69 6e 65 2c 20 20 28 61 6e 64 0d 0a |ce line, (and..|
00002b30 76 61 72 69 61 62 6c 65 20 76 61 6c 75 65 29 20 |variable value) |
00002b40 61 72 65 20 64 69 73 70 6c 61 79 65 64 2e 20 20 |are displayed. |
00002b50 57 68 65 6e 20 74 68 65 20 73 6f 75 72 63 65 20 |When the source |
00002b60 74 65 78 74 20 69 73 20 6e 6f 74 20 61 76 61 69 |text is not avai|
00002b70 6c 61 62 6c 65 2c 20 20 6f 6e 6c 79 0d 0a 74 68 |lable, only..th|
00002b80 65 20 20 73 6f 75 72 63 65 20 20 66 69 6c 65 20 |e source file |
00002b90 20 6e 61 6d 65 2c 20 20 73 75 62 72 6f 75 74 69 | name, subrouti|
00002ba0 6e 65 20 6e 61 6d 65 20 61 6e 64 20 20 6c 69 6e |ne name and lin|
00002bb0 65 20 20 6e 75 6d 62 65 72 20 20 61 72 65 20 20 |e number are |
00002bc0 64 69 73 70 6c 61 79 65 64 2e 20 0d 0a 53 75 62 |displayed. ..Sub|
00002bd0 72 6f 75 74 69 6e 65 20 20 61 6e 64 20 66 69 6c |routine and fil|
00002be0 65 20 6e 61 6d 65 20 61 72 65 20 73 75 70 70 72 |e name are suppr|
00002bf0 65 73 73 65 64 20 69 66 20 74 68 65 79 20 68 61 |essed if they ha|
00002c00 76 65 20 6e 6f 74 20 63 68 61 6e 67 65 64 20 73 |ve not changed s|
00002c10 69 6e 63 65 20 20 74 68 65 0d 0a 70 72 65 76 69 |ince the..previ|
00002c20 6f 75 73 20 64 69 73 70 6c 61 79 65 64 20 76 61 |ous displayed va|
00002c30 6c 75 65 73 2e 20 20 20 53 65 76 65 72 61 6c 20 |lues. Several |
00002c40 77 61 74 63 68 20 61 6e 64 20 62 72 65 61 6b 20 |watch and break |
00002c50 72 65 71 75 65 73 74 73 20 63 61 6e 20 62 65 20 |requests can be |
00002c60 20 61 63 74 69 76 65 0d 0a 61 74 20 20 74 68 65 | active..at the|
00002c70 20 20 73 61 6d 65 20 74 69 6d 65 2e 20 20 20 49 | same time. I|
00002c80 6e 20 74 68 69 73 20 63 61 73 65 2c 20 20 74 68 |n this case, th|
00002c90 65 20 6f 76 65 72 61 6c 6c 20 64 69 73 70 6c 61 |e overall displa|
00002ca0 79 20 20 77 69 6c 6c 20 20 72 65 66 6c 65 63 74 |y will reflect|
00002cb0 20 20 74 68 65 0d 0a 63 6f 6d 62 69 6e 61 74 69 | the..combinati|
00002cc0 6f 6e 20 6f 66 20 61 6c 6c 20 74 68 65 20 63 75 |on of all the cu|
00002cd0 72 72 65 6e 74 20 72 65 71 75 65 73 74 73 2e 0d |rrent requests..|
00002ce0 0a 0d 0a 65 78 61 6d 70 6c 65 73 0d 0a 20 20 20 |...examples.. |
00002cf0 20 20 20 20 20 20 20 57 20 20 20 20 20 0d 0a 20 | W .. |
00002d00 20 20 20 20 20 20 20 20 20 57 20 64 6f 73 6f 72 | W dosor|
00002d10 74 3a 31 32 30 2e 2e 31 35 30 0d 0a 20 20 20 20 |t:120..150.. |
00002d20 20 20 20 20 20 20 57 20 61 28 49 29 3c 3d 33 34 | W a(I)<=34|
00002d30 2e 32 45 39 0d 0a 20 20 20 20 20 20 20 20 20 20 |.2E9.. |
00002d40 58 0d 0a 0d 0a 54 68 65 20 20 72 65 6d 61 69 6e |X....The remain|
00002d50 64 65 72 20 20 6f 66 20 74 68 65 20 6c 69 6e 65 |der of the line|
00002d60 20 61 66 74 65 72 20 74 68 65 20 58 20 69 73 20 | after the X is |
00002d70 70 61 73 73 65 64 20 74 6f 20 44 4f 53 20 61 73 |passed to DOS as|
00002d80 20 20 61 20 20 63 6f 6d 6d 61 6e 64 20 20 66 6f | a command fo|
00002d90 72 0d 0a 65 78 65 63 75 74 69 6f 6e 2e 20 20 20 |r..execution. |
00002da0 49 6e 20 20 74 68 69 73 20 20 77 61 79 20 69 74 |In this way it|
00002db0 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 75 73 65 | possible to use|
00002dc0 20 63 6f 6d 6d 61 6e 64 73 20 6c 69 6b 65 20 20 | commands like |
00002dd0 44 49 52 2c 20 20 6f 72 20 20 45 44 4c 49 4e 0d |DIR, or EDLIN.|
00002de0 0a 77 69 74 68 6f 75 74 20 64 69 73 74 75 72 62 |.without disturb|
00002df0 69 6e 67 20 74 68 65 20 50 72 6f 62 65 20 73 65 |ing the Probe se|
00002e00 73 73 69 6f 6e 2e 20 49 66 20 61 6e 6f 74 68 65 |ssion. If anothe|
00002e10 72 20 50 61 73 63 61 6c 20 70 72 6f 67 72 61 6d |r Pascal program|
00002e20 20 69 73 20 65 78 65 63 75 74 65 64 2c 0d 0a 69 | is executed,..i|
00002e30 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c |t is not possibl|
00002e40 65 20 74 6f 20 75 73 65 20 74 68 65 20 73 61 6d |e to use the sam|
00002e50 65 20 63 6f 70 79 20 6f 66 20 50 72 6f 62 65 20 |e copy of Probe |
00002e60 20 74 6f 20 74 65 73 74 20 69 74 20 75 6e 6c 65 | to test it unle|
00002e70 73 73 20 74 68 65 72 65 20 69 73 0d 0a 6e 6f 20 |ss there is..no |
00002e80 70 72 6f 67 72 61 6d 20 63 75 72 72 65 6e 74 6c |program currentl|
00002e90 79 20 75 6e 64 65 72 20 74 65 73 74 2e 0d 0a 0d |y under test....|
00002ea0 0a 0d 0a 65 78 61 6d 70 6c 65 73 0d 0a 20 20 20 |...examples.. |
00002eb0 20 20 20 20 20 20 58 20 44 49 52 20 2a 2e 44 41 | X DIR *.DA|
00002ec0 54 0d 0a 20 20 20 20 20 20 20 20 20 58 20 50 52 |T.. X PR|
00002ed0 4f 42 45 20 41 4e 4f 54 48 45 52 0d 0a 0d 0a 0d |OBE ANOTHER.....|
00002ee0 0a 0d 0a 0d 0a 0d 0a 1a 00 00 00 00 00 00 00 00 |................|
00002ef0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 |................|
00002f00 
06-05-89/PROBE_HLP.m0
06-05-89/PROBE_HLP.m1
06-05-89/PROBE_HLP.m2
06-05-89/PROBE_HLP.m4
06-05-89/PROBE_HLP.m5
.