Microsoft KB Archive/32948

How to Use Breakpoints in COBOL 3.0 Animator, ANIMATE.EXE

PSS ID Number: Q32948 Article last modified on 04-21-1993

3.00 | 3.00 MS-DOS | OS/2

Summary: The article below describes how to set breakpoints in ANIMATE.EXE, the Animator debugging program provided with Microsoft COBOL Version 3.0.

More Information: To set breakpoints, position the cursor on the first character of a verb and type “BS”;Breakpoint Set (without quotation marks). To (In)activate breakpoints, breakpoints cannot be made active and inactive; they are either set or unset. To delete breakpoints, position the cursor on a verb and type “BU”; Breakpoint Unset (without quotation marks). To remove all breakpoints, type “BC”; Breakpoint Cancel-all (without quotation marks). No confirmation. To examine breakpoints, type “BE”; Breakpoint Examine (without quotation marks). Text is repositioned so that the cursor is placed on the first breakpoint. A conditional breakpoint can be performed as follows: Type “BI”; Breakpoint If, associates a condition with the breakpoint. If the condition is true, execution is halted. A modifiable program execution by breakpoint can be performed as follows: Type “BD”; Breakpoint Do. Prompt for a COBOL statement. Each keyed statement is automatically executed. Upon termination of this feature, program execution returns at the point where the program was halted. A designated statement frequency by breakpoint can be performed as follows: Type “BO”; Breakpoint On count. Periodic breakpoints halt execution with a designated frequency when a specific statement is encountered. To animate a single program in a suite, do the following: Type “EP”; Environment Program break. Use to set a mode other than Zoom for one program in a suite, even when executing the entire suite in Zoom mode. Step/Trace modes are performed as follows: Type “ET”; Environment Threshold level. Specify a nesting level of subroutines and CALLed subprograms below that PERFORMs and CALLs are executed as single steps rather than animated. Breaking from Go/Zoom mode is performed as follows: Type “EU”; Environment Until. Conditional breakpoint halts execution when operating in Go or Zoom mode when the condition becomes true. For backtracking through program execution, do the following: Type “EB”; Environment Backtrack. Record and examine the program execution path by stepping back through the 100 most recently executed part of the program. For additional information, please refer to the “Microsoft COBOL 3.0 Compiler: Operating Guide” Pages 3-1 through 3-38.

Additional reference words: 3.00 Copyright Microsoft Corporation 1993.