

               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

