
 Ŀ
   Chuck Seyboldt's COMMO Macro     CS-MAC09:WHAT
 

! *  Contents:  CS-COMMO.CSM    The Base Commo Macro file (may REN to COMMO.MAC)
^ *             CS-TABLE.CSM    Prompts for a variety of BBS and Mail doors
 *             CS-LOGON.CSM    Generic Logon and Mailrun routines
 *             CS-ACTON.CSM    File fetchin' and sendin' routines
 *             CS-PILOT.CSM    Autopilot routine
 *             CS-MAC.CSM      Menu and config drivers
 *             ASSIGN.KEY      List of COMMO.MAC key assignments
^ *
! *  In CS-COMMO.CSM, you *NEED* to edit lines that have a "!"
  *  in the first column.  These lines deal with BBS definition,
  *  F-key dialing conveniences, and Autopilot operation.
  *
  *  All "editing required" lines are grouped near the end of CS-COMMO.CSM
  *  to provide easiest installation and upgrading.
  *
  *  CS-MAC provides an automated mail and file fetchin' Commo environment.
  *  This automation is accomplished with several linked macros.
  *
  *  COMMO.FON links to CS-COMMO.CSM       with a linked macro label.
  *  CS-COMMO.CSM links to CS-TABLE.CSM    for MailWare and BBSWare responses.
  *  CS-TABLE.CSM links to CS-LOGON.CSM    A generic logon occurs.  If the
  *                                        macro label has an ACTION file
  *                                        associated with it .....
  *  CS-LOGON.CSM links to CS-ACTON.CSM    for file transfers.  After file
  *                                        transfers are complete ....
  *  CS-ACTON.CSM returns to CS-LOGON.CSM  for a MAILRUN.  After logoff,
  *  CS-LOGON.CSM returns to CS-COMMO.CSM  and dials the next marked entry.
  *
  *  In pictures, the sequence looks something like this .......
  *
  * +-------------------------+           +----------------------------+
  * | 1.    COMMO.FON         |           | 2.     CS-COMMO.CSM        |
  * |-------------------------|           |----------------------------|
  * | BBS  {#}  {_pas}  {lnk} | ----|     | {:start}   set your name   |
  * | set bbsid, abbr, bbs ...|     |     | and other personal stuff   |
  * +-------------------------+     |     | --------                   |
  *                                 |     |    Central Commo Control   |
  * +----------------------------+  |     | {:various} key assignments |
  * | 3.    CS-TABLE.CSM         |  |     | for manual terminal control|
  * |----------------------------|  |     | --------                   |
  * | {:m_ware} MAILware prompt  |  |---> | {:lnk} {unmark .FON} option|
  * |           table            |        |                            |
  * | ---------                  |        | {:qwk} {goto CS-TABLE,qwk} | --|
  * | {:bbs_type} BBSware prompt |        +----------------------------+   |
  * |             table          |                                         |
  * | ---------                  |                                         |
  * | {:qwk} {call m_ware}       | <---------------------------------------|
  * |        {call bbs_type}     |
  * |        {goto CS-LOGON,glr} | --|
  * |                            |   |    +-----------------------------+
  * +----------------------------+   |    | 4.     CS-LOGON.CSM         |
  *                                  |    |-----------------------------|
  *                                  |    | {:respond} set generic BBS  |
  *                                  |    |            response strings |
  *                                  |    | --------                    |
  *                                  |--> | {:glr} Generic Logon Routine|
  * +----------------------------+        |        Using responses from |
  * | 5.     CS-ACTON.CSM        |        |        CS-TABLE & CS-LOGON  |
  * |----------------------------|        |                             |
  * | {open and read ACTION}     | <----- | {ifex ACTION,load ACTION!}  |
  * | {fetch and send files}     |        | {otherwise, goto :noact}    |
  * |     --> By BBSID           |        |                             |
  * | {goto CS-LOGON,noact}      | -----> | {:noact} BBSID empty?  If so|
  * |                            |        |          return to CS-COMMO |
  * +----------------------------+        |                             |
  *    (CS-ACTON.CSM is optional)         | {:mailrun} Open maildoor    |
  *                                       |            Send a .REP      |
  *                                       |            Take a .QWK      |
  *                                       | {:byz}     Loop to CS-TABLE |
  *                                       |             if %door2 exists|
  *                                       |             Then to CS-LOGON|
  *                                       |             for second mail |
  *                                       | {:bye}     Logoff BBS       |
  *                                       |   {goto CS-COMMO.CSM,aln}   |
  *                                       |    (Dial marked BBS's)      |
  *                                       |                             |
  *                                       +-----------------------------+
  *
  *  Names and definitions:
  *
  *  %bbsid    The .QWK identifier (%bbsid empty skips attempt at mail)
  *  %dorno    The string to send to the host to get to MAILware prompt
  *  %mprot    The mail transfer protocol to use.  Z, Y, X-CRC supported
  *  %abbr     A two or three character convenience with various uses:
  *            - .ext for ACTION. files.  Separate ACTION per %bbsid
  *            - identity for .qwk renaming and ACTION. archiving
  *
  *  BBSware:  One of a variety of BBS software packages that is available.
  *            This family of Commo macros supports;
  *            -  PCBoard v14.5a    (Clark Development)
  *            -  PCBoard v15.0     (Clark Development)
  *            -  Spitfire
  *            -  Wildcat!          (Mustang Software)
  *            -  Remote Access
  *            -  GAP
  *            -  T.A.G.
  *            -  MacroBBS          (Jeff Oberlee's BBS via Commo macros)
  *            -  MAXIMUS-CBCS
  *            -  Major BBS
  *            -  Virtual BBS       (Roland de Graaf)
  *            -  EXEC-PC BBS       (Bob Mahoney)
  *
  *  MAILware: One of a family of mail doors
  *            This family of Commo macros supports;
  *            -  PCBoard 15.0      (Clark Development)
  *            -  MarkMail 2
  *            -  Qmail 2           (Mark Herring)
  *            -  Qmail 4           (Mark Herring)
  *            -  Jimmer            (Jim Goodenough)
  *            -  Jetmail
  *            -  MKQwk
  *            -  DCQwk
  *            -  Rosemail
  *            -  Silver Express
  *            -  Charlie's OFFline .QWK Reader
  *            -  ZIPNEWS           (Jack Kilday)
  *            -  Major QWK
  *            -  Virtual QWK 6.10  (Roland de Graaf)
  *            -  EXEC-PC BBS       (Bob Mahoney)
  *            -  Cam-Mail          (Cam DeBuck)
  *            -  LAKOTA            (Mike Woltz)
  *
*
  *
  *  Lines with a  "*"  may be deleted.
  *  Deleting my comments is a good thing to do, it saves much RAM.
  *  Use the macro subroutine ":strip" to automagically clean up .MACs
  *
  *  You have exactly the same macro family that I use myself.
  *  Supported by COMMO v6  The macro text has terse commentary.
  *
  *  You may use a file, RENQWK.BAT, in your COMMO home directory, to
  *  rename .QWK packets to avert download crashes.  If you choose to
  *  not use a RENQWK.BAT, LOGON.MAC has built in renaming macro routines.
  *  An example RENQWK.BAT is in the LOGON.MAC file ... ready to snip out.
  *
  *  Many thanks to Fred Brucker for providing the intelligent, excellent
  *  platform that supports this work.  COMMO is powerful and fun.
  *
  * ASSUMPTIONS *
  *
  *  These macros are setup with Zmodem as the default transfer protocol.
  *  I assume that you set complete drive:path\filename.ext for %z_prog
  *
  * KEY ASSIGNMENTS *
  *
  *  These macros contain many features that can be called without
  *  being ONLINE or in a mailrun.  Review ASSIGN.KEY for key assigments.
  *
  * FEATURES *
  *
  *     -  fast
  *     -  runs unattended
  *     -  one macro for many BBSs
  *     -  one session may call several BBSs
  *     -  works for MarkMail, Qmail, RoseMail, Jimmer, JetMail, MKQwk
  *        (all BBS and mail door prompts be set to EXPERT)
  *     -  renames .QWK files  (with configurable renaming methods)
  *     -  deletes .REP files  (testing ERRORLEVEL from transfer)
  *     -  checks message count from  MarkMail  and other doors.
  *        Skips mail download if message count is less than 30.
  *     -  ACTION PROCESSOR macro for file uploads and downloads.
  *     -  Includes a macro (Alt-F) that will prompt you for selections
  *        and make the BBS specific "ACTION" lists based on your input.
  *     -  Keeps a timestamped ACTION history file for each BBS.
  *     -  Lean use of RAM by using multiple .MAC files instead of 1 big one.
  *     -  Easily expands to new or changing BBSware and MAILware.
  *     -  Can open multiple mail doors on one phone call.
  *     -  Supports more than one type of mail reader (packet design).
  *     -    By example, supports both .QWK and .ZNS based mail doors.
  *     -  Autopilot facility for extended unattended running.
  *     -  Menu driven session management and BBS additions.
  *     -  Can be set to capture newfiles list with %flag variable.
  *     -  Now, easier future upgrades via CS-MACxx.CFG facility.
  *     -  Includes a macro to strip comments from .MAC files (saving RAM).
  *     -  Includes a modem configuration macro.
  *
  *  Support  *
  *
  *     -  I really enjoy sharing COMMO.  Your questions and advice
  *        are welcome.  You may find me in U'NI's and Ilink's COMMO
  *        conferences almost daily ... on RIME via Directory Assistance
  *        occasionally ... or at NLBBS (1,207 761-4782).
  *     -  No $ charge for this work.  It's full of room to improve.
  *        I consider your comments to be ample payment.
  *
*
  *
  *  One of the beauties of Commo is the ease with which it can call other
  *  DOS programs.  These assigments may help as you peruse my COMMO.MAC.
  *
  *                                      Tradename     Author
  *
  *  Support files in my %ramdr are:     LIST.COM      (Vern Buerg)
  *                                      QEDIT.EXE     (Sam Mitchell)
  *                                      DSZ.COM       (Chuck Forsberg)
  *  as well as the requisite            COMMAND.COM
  *
  *  Support files in my %dosdir are:    COMMOPNS.EXE  (Shad Muegge)
  *                                      HSLINK.EXE    (Sam Smith)
  *
  *  Support files in my %utildir are:   PHONE.EXE     (Johnathan Wayne)
  *                                      DFR.COM       (Gordon Haff)
  *                                      MJOG.COM      (Chris Dunford)
  *
  *  Support file in my %ins_dir are:    COMMO.DOC     (Fred Brucker)
  *                                      MACRO.DOC     (Fred Brucker)
  *  The Home key uses your external LIST program to read docs.
  *
  *  The %savedir holds these files:     WHATEVER.CAP    (session captures)
  *                                      USED-ACT.%abbr% (ACTION-file history)
  *                                      ADDRESS         (address book)
  *                                      RING.LOG        (timestamp of RINGs)
  *
  *  The Commo %_hom% directory has:     ASSIGN.KEY      (one-page-help  screen)
  *                                      ACTION.%abbr%   (ACTION-file to be run)
  *
  *                                      CS-COMMO.CSM      \
  *                                      CS-TABLE.CSM        \   Components
  *                                      CS-LOGON.CSM         >  of  CS-MAC
  *                                      CS-ACTON.CSM       /   Linked  to
  *                                      CS-MAC.CSM     /     each other
  *
  *                                      RINGLOG.MAC    \   Aux facilities
  *                                      DOSFUNC.MAC     >
  *                                      MACROBBS.MAC   /   (Jeff Oberlee)
