home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / modem / jbtutor1.zip / LESSON15.TXT < prev    next >
Text File  |  1993-10-08  |  3KB  |  66 lines
  1.  
  2. Lesson #15 - Debugging Your Script
  3. ----------------------------------
  4.  
  5.         This is the final lesson in my first tutorial set of lessons
  6. on the {COMMO} macro language.  Stay tuned for the next set which
  7. will discuss more advanced script topics..
  8.  
  9.         Debugging is the art of determining what went wrong with your
  10. script, and what needs to be done to make it right.  There are two
  11. error categories which can cause your script to fail:
  12.  
  13.         a.  Syntax Errors - Examples include misspelled macro
  14. commands, missing colons in macro IDs, extra spaces in commands,
  15. missing "braces", extra punctuation, invalid command switches, etc.
  16. These type errors are sometimes very difficult to detect since the
  17. commands you are using are not "pure English".  You must carefully
  18. scrutinize offending command lines when they are highlighted by
  19. {COMMO}.
  20.  
  21.         b.  Logical Errors - All the syntax is correct, however,
  22. your script program flow is incorrect.  Subroutines are executed out
  23. of sequence, important routines are skipped, etc.  Oftentimes,
  24. logical errors can go undiscovered unless you pay close attention to
  25. script flow.  After all, it's easy to miss something if everything
  26. *seemed* to work OK.
  27.  
  28.         The single most significant tool you have at your disposal
  29. during the debugging process is a literal (raw) capture file of the
  30. failed BBS session.  That's why I included setting a capture file as
  31. one of the "enhancements" during a previous lesson.
  32.  
  33.         The second most significant tool you have is your script
  34. flowchart.  The flowchart will provide you a picture of _what_ should
  35. be going on.  Comparing the _what should_ to the _what did_ will
  36. often illuminate logical errors.
  37.  
  38.         Finally, if all else fails, a significant tool you have is a
  39. "second set of eyes", i.e., post script segments that are causing you
  40. difficulty in various {COMMO} support conferences.  There is a wealth
  41. of talent available...don't be afraid to use it.  Be sure to include
  42. as much information as you can about what seems to be going wrong
  43. with your script.
  44.  
  45.         Debugging is a continuous process.  Sysops are going to make
  46. changes that will affect your script.  Don't be discouraged by the
  47. process..it's something we all have to do.
  48.  
  49.         This lesson concludes the first set of lessons.  I will be
  50. continuing the series..more advanced topics will follow.  Hopefully,
  51. this first set has provided you enough information to get you on your
  52. way to writing scripts.  If you've enjoyed this first set, I have two
  53. simple requests:
  54.  
  55.         - Please register your copy of {COMMO} if you already haven't
  56.           done so
  57.  
  58.         - Please let me know what areas you'd like to see covered in
  59.           the next set.  I will be glad to oblige if it's within my
  60.           ability.
  61.  
  62.         I want you all to know that I appreciate the very positive
  63. feedback I've received concerning these lessons.
  64.  
  65. Jim
  66.