TP-COBOL DEBUGGER Opensource version 0.1.7 Build 11-07-2010 USER MANUAL Usage: animator file [options] file: cobol source[cbl/cpy/src/cob/CBL/CPY/SRC/COB] If missing animator will add ".cbl" extension. Options: -? This support panel -d turn off data analisys -c Don't compile the source -k keep the .ani source -K keep the .ani source -S use 'stop run' sentence instead GOBACK to find end of program. -f use the "anidata" for name for the session file instead of time (useful for single debugging if you need to read your session file) -F force the software to the free format (if not used the animator use the autodetect to control the file is free format) -x Buld a executable program (by default it will produce a dll) -m Advanced manual (this file) -A create a Control flow graph (beta version) (use with the http://www.graphviz.org/ packge) File supplied with the package: ANIMATOR.CBL The TP-COBOL-Debugger source program that prepare the animated source cobol to be animated after a successfully compilation. To haveyour build compile it with: cobc -x animator.cbl ANIMATOR.INF Configuration file where it finds the words you want to animate it contains cobol words; temp directory to save file... cobc= to customize your compiler directives workanim.cpy copy used to add the data analysis procanim.cpy copy used to add procedure for data analysis ANIMDATA.CBL cobol source of the dll called during animation data analysis To have your dll compile it with: cobc animator.cbl ANIMATE.CBL cobol source of the dll called during animation To have your dll compile it with: cobc animate.cbl SET tp-inf-path=\whereisyouranimate.inf\ if you want to customize the location where is the animator ANIMATE.INF where you can put some options they are all optionals. Options you can manage: a) Options to move cursor inside the debug panel PAGE-NEXT=nn ascii page next key default is standard page down key. PAGE-PREV=nn ascii page prev.key default is standard page up key. LINE-NEXT=nn ascii line next key default is standard down arrow key. LINE-PREV=nn ascii line prev key default is standard up arrow key. b) Options to run the animate library GO=nn ascii command for go start default value is "G" key ANIM=nn ascii command for go start default value is "A" key SLEEP=number of nanoseconds wait between lines execution default is 500000000 BREAK=nn ascii for break point set/unset default value is "B" key. STEP1=nn third ascii key for execute step default value is "N" key. STEP2=nn first ascii key for execute step default value is Enter key. STEP3=nn second ascii key for execute step default value is space bar key. LAB-COLOR-BACK= colors used for the label words. LAB-COLOR-FORE= ACC-COLOR-BACK= colors used for the cobol animated line ACC-COLOR-FORE= REM-COLOR-BACK= color used for remarks lines REM-COLOR-FORE= WOK-COLOR-BACK= color used for environment and data division WOK-COLOR-FORE= NUL-COLOR-BACK= color used for statementes where you cannot put a break NUL-COLOR-FORE= TEMP=./temp/ File created by the package: nnnnn.log File log created during ANIMATOR execution. Used by the animated program. If the animate program just starts by using the GO command simple delete DATI.LOG file and start the animated program again nnnnnn.dat file created during creating animator source. It will used during the animation execution it contains source lines nnnnnn.fld File created during creating animator source. It will used during the analysys data to choose a name without write it ito the box field.. do-anim.cpy File created during creating animator source. It's compilated inside the animator source program. It contains the data analysis features. ALL "nnnnn" filesare save into the temp directory, you CAN use debugger with lots source files at the same session How to run the TP-COBOL-ANIMATOR: You need to put the package files in the opencobol directory after from the command line run: C:\Opencobol>ANIMATOR yourcobolsource.cbl [options] -x After the animator runs the cobc compiler to build the animate version. c:\Opencobol>Yourcobolsource.exe (if build with -x) or c:\Opencobol>cobcrun yourcobolsource.dll (if you used the default) then you can move the cursor with page and arrow key pressing "B" you can set or remove a breapoint pressing "G" your program will go until next breakpoint by pressing "A" your program will go until next breakpoint by stepping all instruction with a short delay... Pressing the "V" you can choose a variable to view Don't forget that the program will move in the test all variable (also from the FD file). Use the -k option to keep the animate cobol version so you can compile it with your library if need. When you stop a debugger session by using the break (Ctrl+C) the program leave a file named DATA.LOG that contains the last option it was executing. You should delete that file before running again the animated program (or simple re-run animator to compite your source cobol again). Otherwise if last was a "G" command it will start again by going with that command. just done ! T&P Soluzioni Informatiche srl Via Paradiso 6 02034 Montopoli 02304 Montopoli di Sabina (RI) Italy www.tp-srl.it priolof@tp-srl.it End of manual July 2010