GO -- Begins or resumes execution of the target program.
FORMAT
| Zero or one options | Zero or one option | Any number (including zero) |
| from this group. | from this group. | from this group. |
| | | |
| -Location statement-id | | |
Go | -Exit | -After integer | -Until statement-id -OR statement-id |
| -Return (expr) -Alt integer| | |
| -Cleanup | | |
| | | |
REQUIRED ARGUMENTS
None. If you enter GO with no arguments, DEBUG resumes execution
from the statement where the program is currently stopped.
OPTIONAL ARGUMENTS
-Location Causes your program to resume execution at the specified
statement. The specified statement must be part of the run
environment. You cannot use -Location to jump to a different
routine. Due to program optimization, it is possible that the
GO -Location command may cause unexpected results. See
the "GO" listing of Chapter 3 of the debugger manual for
details.
-Exit Sets "one-shot" breakpoints on all exits of the current
routine thus allowing you to examine the state of the routine's
variables just before control returns to the caller. Note that
an "exit" is a return to the calling routine, an "exit" is
not a call to another routine.
-Return Causes the current routine to exit immediately. The optional
(expr) argument defines a return value if the routine is a
function. You must enclose the (expr) argument in
parentheses. The phrase -Alt integer is optional, and
only be used when debugging FORTRAN programs. Use it to
specify an alternate routine return. Note that (expr) and
-Alt are mutually exclusive, since the former applies only
to functions and the latter only to subroutines.
-Cleanup This option is valid only after the target program has stopped
for a fault (other than a normal breakpoint or single-step.)
It causes the fault to be delivered to the target program,
so that any cleanup handlers are executed.
-After Applies only if the target program is currently stopped at
a breakpoint. If it is, the current break will not occur
again for the number of passes through the statement that
you specify with integer. The action of this option is
identical to that of the -After option of the BREAKPOINT
command. This option replaces any existing "after count" on
the breakpoint.
-Until, -OR Sets one or more one-shot breakpoints at the given
statement-ids. -Until and -OR produce completely identical
results. (We provided both so that the interface would
look more like English.)
DESCRIPTION
Use the GO command to begin or resume execution of the target program.
All options are mutually exclusive except for -After and -Until, which can
be combined with any of the others.
Several of GO's arguments establish one-shot breakpoints. A one-shot
breakpoint, like all other breakpoints, stops the program before the statement
executes. Once set, a one-shot breakpoint remains in effect until the program
stops for any reason. A one-shot breakpoint replaces any existing
breakpoint at the same statement. Therefore, after you set a one-shot
breakpoint, you lose any permanent breakpoint set at the same statement.
For full details, see the "GO" listing in Chapter 3 of the DOMAIN Language
Level Debugger Reference manual.