home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / modem / jbtutor1.zip / LESSON12.TXT < prev    next >
Text File  |  1993-09-19  |  2KB  |  52 lines
  1. Enhancement #1 - Open a capture file
  2. ------------------------------------
  3.  
  4.         Since the primary purpose of a mailrun script will be to
  5. handle a BBS session unattended, you're very likely to want some
  6. method for determining what exactly transpired during the session
  7. while you weren't there.  A capture file will provide that
  8. information.
  9.  
  10.         Two {COMMO} macro commands apply to the creation of a capture
  11. file -- CAPTure and CAPMode.  CAPTure opens (and closes) the capture
  12. file.  CAPMode is an optional command that changes the type of
  13. capture file which is open (screen/filter/raw). This command is only
  14. required if you wish to have a different type capture file than is
  15. set as your default in your .SET file (the "cpm" setting).  I
  16. recommend that you use "raw" as the capture file type for unattended
  17. sessions.  Besides providing a record of what transpired during an
  18. unattended session, the capture file can be used as a debugging tool
  19. to determine what went wrong during failed sessions.  "Raw" mode
  20. ensures you see everything that came into the port.  So, if your
  21. default setting is "screen" (which is very likely), then you'll need
  22. to use CAPMode in your script to change to "raw".
  23.  
  24.         I recommend that creation of the capture file be the very
  25. first command associate with a BBS' linked macro.  For example, let's
  26. suppose your mailrun script is setup to call Big Sky BBS and in the
  27. dialing directory, Big Sky's linked macro name is "pcb".  Here's how
  28. you'd turn on the capture file for your mailrun session:
  29.  
  30. .
  31. .
  32. {:PCB}
  33.      {CAPM raw}                       Note 1
  34.      {CAPT y,%qwkdir%%bbsid.cap}      Note 2
  35. {:LOGIN}                              Note 3
  36. .
  37. . the rest of your login/mailrun routine
  38. .
  39.  
  40. Note 1:  Sets capture file type to "raw"
  41. Note 2:  Opens a capture file in directory specified by variable
  42.          "qwkdir" with filename "bbsid".cap.  You can use whatever
  43.          directory/filename you like.  I just wanted to show that
  44.          variables can also be used in this command.
  45. Note 3:  The label "login" is not really required.  I've included it
  46.          here to provide continuity with previous lessons.
  47.  
  48.         If you recall from Lesson 11, the capture file would be
  49. turned off with the "{CAPT n}" command contained in the "gby" macro.
  50.  
  51. Jim
  52.