RUNTO command

The RUNTO command runs your program to a valid executable statement without setting a breakpoint. You can indicate at which statement to stop by specifying the statement id or by positioning the cursor on a statement.

Read syntax diagramSkip visual syntax diagramRUNTOstatement_id ;
statement_id
A valid statement identifier. If you are debugging a disassembled program, specify the statement identifier as an offset in hexadecimal form (X'offset').

Usage notes

  • If you indicate a statement by positioning the cursor on the statement, the cursor must be in the Source window and positioned on a line where an executable statement begins.
  • If you indicate a statement by positioning the cursor on the statement and there are multiple statements on the same line, the target of the RUNTO command is the first relative statement on the line. For optimized COBOL programs, the target of the command is the first executable command which was not discarded by the optimizer.
  • If you indicate a statement by providing a statement id, the statement id must be an executable statement.
  • Execution continues until one of the following conditions occurs:
    • The location indicated by the cursor position or the statement id is reached.
    • A previously set breakpoint is encountered.
    • The end of the job is reached.
  • For optimized COBOL programs, the RUNTO command remains in effect until the statement you indicated is reached. For example, if your program encounters a breakpoint and then you enter the GO or RUN command, the program runs until the next breakpoint is encountered or the statement you indicated is reached.
  • You can use the RUNTO command in remote debug mode by entering it in the Debug Console or the Action field, which is in the Optional Parameters section of the Add a Breakpoint task.

Examples

  • Run to statement 67, where statement 67 is in a currently active block. 
    RUNTO 67;
  • Run to the statement 11 in the block IPLI11A, where IPLI11A is known in the current enclave. 
    RUNTO IPLI11A :> 11
  • Run to statement 36, where statement 36 is located in the Source window.
    1. Type RUNTO in the command line.
    2. Place the cursor on statement 36.
    3. Press Enter.
  • Run to the statement 74, using a PF key.
    1. Define a PF key to run to the cursor position. 
      SET PF13 = RUNTO;
    2. Place the cursor at the statement 74 and hit shift+PF1 key.

Refer to the following topics for more information related to the material discussed in this topic.