home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / modem / cs_mac08.zip / WHAT < prev    next >
Text File  |  1993-10-24  |  13KB  |  231 lines
  1.  
  2.  ┌────────────────────────────────┐
  3.  │  Chuck Seyboldt's COMMO Macro  │   CS-MAC08:WHAT
  4.  └────────────────────────────────┘
  5.  
  6. ! *  Contents:  CS-COMMO.MAC    The Base Commo Macro file (may REN to COMMO.MAC)
  7. ^ *             TABLE.MAC       Prompts for a variety of BBS and Mail doors
  8. │ *             LOGON.MAC       Generic Logon and Mailrun routines
  9. │ *             ACTION.MAC      File fetchin' and sendin' routines
  10. │ *             CS-MAC.MAC      This text plus menu and config drivers
  11. │ *             ASSIGN.KEY      List of COMMO.MAC key assignments
  12. ^ *
  13. ! *  In CS-COMMO.MAC, you *NEED* to edit lines that have a "!"
  14.   *  in the first column.  These lines deal with BBS definition,
  15.   *  F-key dialing conveniences, and Autopilot operation.
  16.   *
  17.   *  All "editing required" lines are grouped near the end of CS-COMMO.MAC
  18.   *  to provide easiest installation and upgrading.
  19.   *
  20.   *  CS-MAC provides an automated mail and file fetchin' Commo environment.
  21.   *  This automation is accomplished with several linked macros.
  22.   *
  23.   *  COMMO.FON links to COMMO.MAC    with a linked macro label.
  24.   *  COMMO.MAC links to TABLE.MAC    to setup MailWare and BBSWare responses.
  25.   *  TABLE.MAC links to LOGON.MAC    A generic logon occurs.  If the
  26.   *                                  macro label has an ACTION file
  27.   *                                  associated with it .....
  28.   *  LOGON.MAC links to ACTION.MAC   for file transfers.  After file
  29.   *                                  transfers are complete ....
  30.   *  ACTION.MAC returns to LOGON.MAC for a MAILRUN.  After logoff,
  31.   *  LOGON.MAC returns to COMMO.MAC  and dials the next marked entry.
  32.   *
  33.   *  In pictures, the sequence looks something like this .......
  34.   *
  35.   * +-------------------------+           +----------------------------+
  36.   * | 1.    COMMO.FON         |           | 2.      COMMO.MAC          |
  37.   * |-------------------------|           |----------------------------|
  38.   * | BBS  {#}  {_pas}  {lnk} | ----|     | {:start}   set your name   |
  39.   * | set bbsid, abbr, bbs ...|     |     | and other personal stuff   |
  40.   * +-------------------------+     |     | --------                   |
  41.   *                                 |     |    Central Commo Control   |
  42.   * +----------------------------+  |     | {:various} key assignments |
  43.   * | 3.      TABLE.MAC          |  |     | for manual terminal control|
  44.   * |----------------------------|  |     | --------                   |
  45.   * | {:m_ware} MAILware prompt  |  |---> | {:lnk} {unmark .FON} option|
  46.   * |           table            |        |                            |
  47.   * | ---------                  |        | {:qwk} {load TABLE.MAC,qwk}| --|
  48.   * | {:bbs_type} BBSware prompt |        +----------------------------+   |
  49.   * |             table          |                                         |
  50.   * | ---------                  |                                         |
  51.   * | {:qwk} {call m_ware}       | <---------------------------------------|
  52.   * |        {call bbs_type}     |
  53.   * |        {load LOGON.MAC,glr}| --|
  54.   * |                            |   |    +-----------------------------+
  55.   * +----------------------------+   |    | 4.       LOGON.MAC          |
  56.   *                                  |    |-----------------------------|
  57.   *                                  |    | {:respond} set generic BBS  |
  58.   *                                  |    |            response strings |
  59.   *                                  |    | --------                    |
  60.   *                                  |--> | {:glr} Generic Logon Routine|
  61.   * +----------------------------+        |        Using responses from |
  62.   * | 5.      ACTION.MAC         |        |        TABLE.MAC & LOGON.MAC|
  63.   * |----------------------------|        |                             |
  64.   * | {open and read ACTION}     | <----- | {ifex ACTION,load ACTION!}  |
  65.   * | {fetch and send files}     |        | {otherwise, goto :noact}    |
  66.   * |     --> By BBSID           |        |                             |
  67.   * | {load LOGON.MAC,noact}     | -----> | {:noact} BBSID empty?  If so|
  68.   * |                            |        |          return to COMMO.MAC|
  69.   * +----------------------------+        |                             |
  70.   *    (ACTION.MAC is optional)           | {:mailrun} Open maildoor    |
  71.   *                                       |            Send a .REP      |
  72.   *                                       |            Take a .QWK      |
  73.   *                                       | {:byz}     Loop to TABLE.MAC|
  74.   *                                       |             if %door2 exists|
  75.   *                                       |             Then to LOGON   |
  76.   *                                       |             for second mail |
  77.   *                                       | {:bye}     Logoff BBS       |
  78.   *                                       |   {load COMMO.MAC,aln}      |
  79.   *                                       |    (Dial marked BBS's)      |
  80.   *                                       |                             |
  81.   *                                       +-----------------------------+
  82.   *
  83.   *  Names and definitions:
  84.   *
  85.   *  %bbsid    The .QWK identifier (%bbsid empty skips attempt at mail)
  86.   *  %dorno    The string to send to the host to get to MAILware prompt
  87.   *  %mprot    The mail transfer protocol to use.  Z, Y, X-CRC supported
  88.   *  %abbr     A two or three character convenience with various uses:
  89.   *            - .ext for ACTION. files.  Separate ACTION per %bbsid
  90.   *            - identity for .qwk renaming and ACTION. archiving
  91.   *
  92.   *  BBSware:  One of a variety of BBS software packages that is available.
  93.   *            This family of Commo macros supports;
  94.   *            -  PCBoard v14.5a    (Clark Development)
  95.   *            -  PCBoard v15.0     (Clark Development)
  96.   *            -  Spitfire
  97.   *            -  Wildcat!          (Mustang Software)
  98.   *            -  Remote Access
  99.   *            -  GAP
  100.   *            -  T.A.G.
  101.   *            -  MacroBBS          (Jeff Oberlee's BBS via Commo macros)
  102.   *            -  MAXIMUS-CBCS
  103.   *            -  Major BBS
  104.   *            -  Virtual BBS       (Roland de Graaf)
  105.   *            -  EXEC-PC BBS       (Bob Mahoney)
  106.   *
  107.   *  MAILware: One of a family of mail doors
  108.   *            This family of Commo macros supports;
  109.   *            -  PCBoard 15.0      (Clark Development)
  110.   *            -  MarkMail 2
  111.   *            -  Qmail 2           (Mark Herring)
  112.   *            -  Qmail 4           (Mark Herring)
  113.   *            -  Jimmer            (Jim Goodenough)
  114.   *            -  Jetmail
  115.   *            -  MKQwk
  116.   *            -  DCQwk
  117.   *            -  Rosemail
  118.   *            -  Silver Express
  119.   *            -  Charlie's OFFline .QWK Reader
  120.   *            -  ZIPNEWS           (Jack Kilday)
  121.   *            -  Major QWK
  122.   *            -  Virtual QWK 6.10  (Roland de Graaf)
  123.   *            -  EXEC-PC BBS       (Bob Mahoney)
  124.   *            -  Cam-Mail          (Cam DeBuck)
  125.   *            -  LAKOTA            (Mike Woltz)
  126.   *
  127. *───────────────────────────────────────────────────────────────────────────────
  128.   *
  129.   *  Lines with a  "*"  may be deleted.
  130.   *  Deleting my comments is a good thing to do, it saves much RAM.
  131.   *  Use the macro subroutine ":strip" to automagically clean up .MACs
  132.   *
  133.   *  You have exactly the same macro family that I use myself.
  134.   *  Supported by COMMO v5.41   The macro text has terse commentary.
  135.   *
  136.   *  You may use a file, RENQWK.BAT, in your COMMO home directory, to
  137.   *  rename .QWK packets to avert download crashes.  If you choose to
  138.   *  not use a RENQWK.BAT, LOGON.MAC has built in renaming macro routines.
  139.   *  An example RENQWK.BAT is in the LOGON.MAC file ... ready to snip out.
  140.   *
  141.   *  Many thanks to Fred Brucker for providing the intelligent, excellent
  142.   *  platform that supports this work.  COMMO is powerful and fun.
  143.   *
  144.   * ASSUMPTIONS *
  145.   *
  146.   *  These macros are setup with Zmodem as the default transfer protocol.
  147.   *  I assume that you set complete drive:path\filename.ext for %z_prog
  148.   *
  149.   * KEY ASSIGNMENTS *
  150.   *
  151.   *  These macros contain many features that can be called without
  152.   *  being ONLINE or in a mailrun.  Review ASSIGN.KEY for key assigments.
  153.   *
  154.   * FEATURES *
  155.   *
  156.   *     -  fast
  157.   *     -  runs unattended
  158.   *     -  one macro for many BBSs
  159.   *     -  one session may call several BBSs
  160.   *     -  works for MarkMail, Qmail, RoseMail, Jimmer, JetMail, MKQwk
  161.   *        (all BBS and mail door prompts be set to EXPERT)
  162.   *     -  renames .QWK files  (with configurable renaming methods)
  163.   *     -  deletes .REP files  (testing ERRORLEVEL from transfer)
  164.   *     -  checks message count from  MarkMail  and other doors.
  165.   *        Skips mail download if message count is less than 30.
  166.   *     -  ACTION PROCESSOR macro for file uploads and downloads.
  167.   *     -  Includes a macro (Alt-F) that will prompt you for selections
  168.   *        and make the BBS specific "ACTION" lists based on your input.
  169.   *     -  Keeps a timestamped ACTION history file for each BBS.
  170.   *     -  Lean use of RAM by using multiple .MAC files instead of 1 big one.
  171.   *     -  Easily expands to new or changing BBSware and MAILware.
  172.   *     -  Can open multiple mail doors on one phone call.
  173.   *     -  Supports more than one type of mail reader (packet design).
  174.   *     -    By example, supports both .QWK and .ZNS based mail doors.
  175.   *     -  Autopilot facility for extended unattended running.
  176.   *     -  Menu driven session management and BBS additions.
  177.   *     -  Can be set to capture newfiles list with %flag variable.
  178.   *     -  Now, easier future upgrades via CS-MACxx.CFG facility.
  179.   *     -  Includes a macro to strip comments from .MAC files (saving RAM).
  180.   *     -  Includes a modem configuration macro.
  181.   *
  182.   *  Support  *
  183.   *
  184.   *     -  I really enjoy sharing COMMO.  Your questions and advice
  185.   *        are welcome.  You may find me in U'NI's and Ilink's COMMO
  186.   *        conferences almost daily ... on RIME via Directory Assistance
  187.   *        occasionally ... or at NLBBS (1,207 761-4782).
  188.   *     -  No $ charge for this work.  It's full of room to improve.
  189.   *        I consider your comments to be ample payment.
  190.   *
  191. *───────────────────────────────────────────────────────────────────────────────
  192.   *
  193.   *  One of the beauties of Commo is the ease with which it can call other
  194.   *  DOS programs.  These assigments may help as you peruse my COMMO.MAC.
  195.   *
  196.   *                                      Tradename     Author
  197.   *
  198.   *  Support files in my %ramdr are:     LIST.COM      (Vern Buerg)
  199.   *                                      QEDIT.EXE     (Sam Mitchell)
  200.   *                                      DSZ.COM       (Chuck Forsberg)
  201.   *  as well as the requisite            COMMAND.COM
  202.   *
  203.   *  Support files in my %dosdir are:    COMMOPNS.EXE  (Shad Muegge)
  204.   *                                      HSLINK.EXE    (Sam Smith)
  205.   *
  206.   *  Support files in my %utildir are:   PHONE.EXE     (Johnathan Wayne)
  207.   *                                      DFR.COM       (Gordon Haff)
  208.   *                                      MJOG.COM      (Chris Dunford)
  209.   *
  210.   *  Support file in my %ins_dir are:    COMMO.DOC     (Fred Brucker)
  211.   *                                      MACRO.DOC     (Fred Brucker)
  212.   *  The Home key uses your external LIST program to read docs.
  213.   *
  214.   *  The %savedir holds these files:     WHATEVER.CAP    (session captures)
  215.   *                                      USED-ACT.%abbr% (ACTION-file history)
  216.   *                                      ADDRESS         (address book)
  217.   *                                      RING.LOG        (timestamp of RINGs)
  218.   *
  219.   *  The Commo %_hom% directory has:     ASSIGN.KEY      (one-page-help  screen)
  220.   *                                      ACTION.%abbr%   (ACTION-file to be run)
  221.   *
  222.   *                                      COMMO.MAC      \
  223.   *                                      TABLE.MAC        \   Components
  224.   *                                      LOGON.MAC         >  of  CS-MAC
  225.   *                                      ACTION.MAC       /   Linked  to
  226.   *                                      CS-MAC.MAC     /     each other
  227.   *
  228.   *                                      RINGLOG.MAC    \   Aux facilities
  229.   *                                      DOSFUNC.MAC     >
  230.   *                                      MACROBBS.MAC   /   (Jeff Oberlee)
  231.