RUNTO

Description

Use the RUNTO command to make your program run to a specific point, then pause. The RUNTO command sets a onetime breakpoint and starts execution. The breakpoint is automatically removed after it is reached and execution is halted.

You can make this command easy to use by assigning RUNTO CSR to a PF key with the SET command. When you position the cursor on the desired line and press the PF key, the program will execute up to that line and stop. For more information, see SET.

Input

RUNTO Line Command Syntax

The following are the parameter descriptions for the RUNTO command:

line-number

The number of the line where you want execution to stop. Specify a valid program statement number or Code Debug-assigned line number.

CSR

Indicates that you want to start execution, then stop at the location of the cursor.

offset

The offset of the instruction where you want execution to stop. The hexadecimal offset is relative to the beginning of the module. This parameter is valid only if used in Assembler or Pseudo Source. The line command area must be set to display offset. (For more information, see Entering Line Commands.)

address

24- or 31-bit address where you want execution to stop. This parameter is valid only if used in Assembler or Pseudo Source. The line command area must be set to display the address in 24- or 31-bit mode. (For more information, see Entering Line Commands.)

Usage Notes

1. You can set a PF key to RUNTO CSR to provide a quick method of executing up to the desired location. For example, enter SET PF13 RUNTO CSR to map the command to the PF13 key.
2. If an event such as an abend or another breakpoint interrupts execution before the RUNTO breakpoint is encountered, the desired line is marked with an O. If there was also an after breakpoint on the desired line, it is marked with a #.
3. If you enter a RUNTO command and specify a location such as a data line that does not support breakpoints, Code Debug will issue an error message and no action will be taken.
4. The RUNTO command cannot be used on a line that already contains a before breakpoint.
5. You cannot include the RUNTO command in a script because the GO command terminates script processing, and the RUNTO command is equivalent to setting a breakpoint and then entering the GO command.
6. The RUNTO command cannot be used in an INSERT or an INCLUDE.
7. If a RUNTO command is issued against a line containing a skip breakpoint, the skip breakpoint will be deleted.