CMC.DOC
{COMMO} MASTER CONTROL
Version 5.01
The Do Everything macro for {COMMO}
by Don Garrett
29 September 1991


This .DOC file and the CMCREAD.ME file should give you enough
information to run the CMC.MAC file included. Read
INSTALL.CMC for installation instructions. I will assume that
you are somewhat familiar with {COMMO} and have read the
manual.

New Features:

Pull down menus
User defined hotkey macros
Individualized BBS variables for GOLOoks.
Much easier configuration
Fully functional (4DOS is no longer needed)


MASTER CONTROL HELP FUNCTION - HOW IT WORKS

The MASTER CONTROL help function just a simple online way of
accessing the CMC.DOC file with LIST.COM. It is structured
so that it will pop up in a particular screen by using the
LIST.COM's FIND function. The number you see on line 8 of
this display preceded by the [ symbol is the search key. Of
[1 course once you are inside list you can use the FIND function
to search for any key words or any of the other search keys
listed below. Pressing F followed by [ and the topic number
followed by ENTER will take you directly to that topic.

1 - This screen 2 - The Menu system
3 - The Session Planner 4 - Upload
5 - Download 6 - File Download From a List
7 - Configuring MASTER CONTROL







The Menu system

The "pull down" menu system is activated by pressing F2. The
capitalized and highlighted letters of the current menu are
"hot keys."

You may press "X" or ESC to exit from a menu screen.
[2
This is what you will see if you press F2.


Session planner Upload Download List Help(cmc)



The various selections for this menu are explained below.







The Session Planner


Pressing S will bring up the menu below.



Session planner Upload Download List Help(cmc) [3

Plan a new session
Mailrun
Replies only
File download from list
Bimodem transfer
Auto marking
User marking
Hold until
Start session


The Session planner is the heart of CMC. This is where the
session is organized and setup. The various choices are
explained below.

PLAN A NEW SESSION will clear all flags that may be left
from a previous session and clears any marks in the
dialing directory. All sessions should start with this
function. Note the message that appears on the terminal
screen:

"MASTER CONTROL SET FOR:"

As you select various tasks from the list they will be
listed.

MAIL RUN sets the %mail variable a Net Mail download. If
any .REP packets are present they will be uploaded
automatically. When this option is selected "MAIL RUN"
is displayed.

REPLIES ONLY sets the %repsonly variable to Y. After you
have read and replied to your mail with your offline
reader, this will set up a session to upload them to the
proper BBSs. When this option is selected "REPLIES ONLY"
is displayed unless Mail Run has been selected. A mail
run will do both uploads and downloads so the Replies
Only is redundant if Mailrun is selected. Only BBSs that
have a .REP file present will be marked when automarking
is selected.

FILE DOWNLOAD FROM A LIST

FILE DOWNLOAD FROM A LIST sets the %filedown variable.
Only BBSs that have a .GET file present in the
upload/download directory _AND_ are listed in CMCINFO.MAC
in the {:fidolist} will be marked for downloading from a
list. A .GET file name is made up of the BBSID with the
[6 .GET extension. (For example: FORUM!.GET.) When this
option is selected "FILE DOWNLOAD FROM A LIST" is
displayed. If a password is necessary for a file simply
put it on the line immediately following the file name.
The file should consist of a simple ascii list with no
extra spaces or blank lines. For example:

LIST76.ZIP
COMMO50.ZIP
CMC50.ZIP






BIMODEM TRANSFER sets the BIMOD.FLG for a bimodem
transfer. Only BBSs that have a .PTH file present in the
upload/download directory will be marked for a Bimodem
transfer with the automarking function. A .PTH file name
is made up of the BBSID with the .PTH extension. When
this option is selected "BIMODEM TRANSFER" is displayed.

AUTO MARKING will use the appropriate BBS list from
CMCINFO.MAC to automatically mark the BBSs needed to
accomplish the session objective. In the case of REPLIES
ONLY it will use the Mail list to check for the presence
of .REP files for the BBSs on the list. ***NOTE: This
function or manual USER MARKING _MUST_ be done before any
BBSs will be marked. Do this before you select HOLD
UNTIL or START SESSION.

USER MARKING allows you to mark only those BBSs that you
wish to call. Say you had CYBER.GET, FORUM!.GET, and
DOORS.GET in your upload/download directory but only
wanted to call FORUM! now. First select PLAN A NEW
SESSION to clear all flags, select FILE DOWNLOAD FROM A
LIST, then select USER MARKING, this will place you in
the dialing directory where you may mark the boards to
call by pressing the spacebar. Then press START SESSION
to begin. ***NOTE: This AUTO MARKING or manual USER
MARKING _MUST_ be done before any BBSs will be marked. Do
this before you select HOLD UNTIL or START SESSION.

HOLD UNTIL will prompt you for the time to begin the
delayed session. Simply input the time that you want the
event to start, and walk away. Use the format HH:MM.
For example: 01:30 for 1:30 AM or 16:45 for 4:45 PM.
*NOTE* Time must be input in a 24 hour format.

START SESSION will begin your session so you may turn
your attentions to other things. When you come back
later all the work will be done!

The order that you select the options is important. The
proper sequence would be to first select PLAN A NEW SESSION,
then the tasks you want it to perform, then either AUTO
MARKING or USER MARKING, then either HOLD UNTIL or START
SESSION.

UPLOAD


Session planner Upload Download List Help(cmc)

Zmodem batch
Ymodem batch
[4 ymodem Crc
xModem
Puma
Sealink
Bimenu

zmodem pOint & shoot
point & shoot file Tagger



Pressing the capitalized letter of each protocol will execute
that protocol. You will then be prompted for the name of the
file to be uploaded.

ZMODEM POINT & SHOOT. This option must be preceded by using
the POINT AND SHOOT FILE Tagger option using COMMOPNS. You may
also use this option by creating in your upload directory a
file called FILE.LST with the paths and names of files that
you are uploading prior to initiating the transfer. Also, you
may use this option with MPt or PUMA, but you will have to
manually edit the CMC.MAC and add the appropriate line. If the
FILE.LST file is not present this protocol will exit with an
error.


DOWNLOAD



Session planner Upload Download List Help(cmc)

Ymodem batch
[5 ymodem-G
ymodem Crc
xModem
Sealink
Bimenu


Pressing the capitalized letter of the function will execute
the appropriate protocol. Some will then prompt you for the
file name prior to initiating the transfer. Any protocol that
has an AUTOSTART string defined in COMMO.SET will
automatically start and is not listed here.




LIST


Session planner Upload Download List Help(cmc)

Upload/download dir
Commo directory
commo Doc
commo Log


LIST.COM will allow you to list the contents of your
Upload/Download directory, the {COMMO} directory, COMMO.DOC
(if it resides in your {COMMO} directory), and the {COMMO}
logfile if you have that option set in COMMO.SET. I suggest
that you set up LIST.COM to launch your favorite editor. It
is very convenient to be able to call up QEdit from LIST in
the Upload/download directory. For example I can do .GET
files for file downloads.




HELP


Session planner Upload Download List Help(cmc)

How it works
the Menu system
Session planner
Protocols (u/l & d/l)


See how it works for information on the help system.



FUNCTION KEY ASSIGNMENTS

FUNCTION KEY ASSIGNMENTS - QUICK REFERENCE

Misc Menus
nf1 COMMO Help sf1 Auto mail af1 Online Quote cf1
nf2 CMC Menu sf2 Auto replies af2 cf2
nf3 Log Off sf3 Auto files af3 cf3
nf4 u/l rep sf4 af4 cf4
nf5 renqwk sf5 af5 cf5
nf6 WC m d/l sf6 af6 cf6
nf7 quiet sf7 af7 cf7
nf8 loud sf8 af8 cf8
nf9 Time Mark sf9 List COMMO dir af9 cf9
nf0 List uldl dir sf0 List ULDL dir af0 cf0








Macros for Shifted Function Keys

This is my favorite section of CMC, these are the user
configurable keys. You may input the keystrokes that you would
normally input into the CMC Main Menu in the USER INFORMATION
section of CMCINFO.MAC eliminate most of the work in planning
a session.

I found that I really did not want to press F2 S P M A S every
time I wanted to start a mail run. So I added this feature.
Now I just press Shift F1 and accomplish the same thing.

{sf1} Auto mail, automatically plan a session, automark and go!

{sf2} Auto replies, no hassle, it marks for automatic
uploading of all replies!

{sf3} Auto files. Auto mark all boards that have .GET files in
the UL/DL directory!

{sf4-sf8} Use your imagination! Must I do ALL the work?! {grin}

{sf9} List {COMMO} Directory.

{sf0} List Upload/download directory.


Macros for Alternate Function Keys
{af1} Calls the Online Quoting routine. This lets you use your
favorite text editor while messaging on line. It is set
up with Qedit.


Macros for Un shifted Function Keys

{nf1} This is the Help key for the Internal Help within {COMMO}.

{nf2} Calls up {COMMO} MAster Control Main Menu

{nf3} Log off

{nf4} Upload a .REP file. Useful for manual .REP uploads.
The only requirement is that the %bbsid variable be set
to the name of the BBS.

{nf5} Renames .QWK file. Assumes that the %bbsid variable is
set for the BBS name.

{nf6} Call Wildcat Mail download. Useful for manual .QWK
downloads.

{nf7} Quiet modem. This sends a string to the modem to
silence the dialing tones. (Useful late at night when
your spouse is asleep.)

{nf8} Loud modem. Sets modem back to normal volume.

{nf9} Puts a time mark in the current capture file.

{nf0} Calls LIST.COM in the upload/download directory.



Online Quoting Macro

Direct from the Master!

This is Fred's super duper online quoting macro. Very useful
for us offline reader types that feel lost if we can't use our
favorite text editor. Just choose reply on the BBS and call
the macro by pressing Alt-F1, when the scroll back screen pops
up mark the text you want to quote and press enter. Use your
text editor to add quote initials or whatever, add your reply
and exit. Your reply will be "asciied" up.












INSTALLATION AND CONFIGURATION OF {COMMO} MASTER CONTROL


There are only three files that need to be configured to run
CMC.MAC. They are: CMC.BAT; CMC.FON; and CMCINFO.MAC.
These files are described in detail below. Take the time to
do this right. The proper functioning of CMC.MAC depends on
[7 it.


CMC.BAT

The CMC.BAT file can be located anywhere in your path. All
other CMC files must be in the COMMO directory.

c:
cd \com\commo
set commo=c:\com\commo
set DSZLOG=c:\com\commo\commo.log
commo /mcmc.mac /dcmc.fon /:welcome
set DSZLOG=
set commo=
exit

Line by line description.

1. Change to the drive that COMMO is on. Change as
necessary.

2. Change to the COMMO directory. Change as necessary..

3. Set system variable to commo directory. Change as
necessary.

4. Set log file for DSZ to the COMMO.LOG file. Change as
necessary.

5. This line calls COMMO, sets CMC.MAC as the active
macro, CMC.FON as the active .FON file, and starts the CMC
initialization macro. You may omit /dcmc.fon if you plan to
modify your COMMO.FON file to CMC specifications. The rest
should be unchanged.

6. & 7. Sets to null the two system variables DSZLOG and
COMMO.

8. Closes the DesqView window on exit from {COMMO}.


CMC.FON

BBS Name Last On Phone # Password\BBSid Macro Para

B-BEARD (Henry Moore) 09/21/91 {294 9657} {password\b-beard} {passparse} {}
CYBER1 (Philip Yanov) 09/22/91 {242 3766} {password\cyber} {passparse} {}
CYBER2 (Philip Yanov) 09/21/91 {242 3994} {password\cyber} {passparse} {}
DOORS1 (Richard Fuller) 09/14/91 {299 3668} {password\doors} {passparse} {}
DOORS2 (Richard Fuller) 09/21/91 {299 3594} {password\doors} {passparse} {}
FORUM! (Doug Glenn) 09/21/91 {862 4616} {password\forum!} {passparse} {}
GCSO-BBS (HDavid Rice) 09/21/91 {242 2792} {password\gcso-bbs} {passparse} {}
ULTBBS1 (Matt Cooley) 09/21/91 {895 3536} {password\ultbbs} {passparse} {}
ULTBBS2 (Matt Cooley) 09/21/91 {895 5836} {password\ultbbs} {passparse} {}
GOLDEN STRIP CONNECTION 09/21/91 {967 8127} {password\golden} {passparse} {}

Note that the BBSID name, (the name on the .QWK and .REP
packets,) is also the name in the "BBS Name" column. When
there is more than one entry the numbers 1, 2, or 3 can be
appended with no space to the BBSID name.

I use the password field to store both the password and the
BBSID name. (A technique that I got from Shad Muegge.) The \
is used as a separator and cannot be used in you password.
Put your password first, the "\" separator and then the BBSID.

The linked macro for all entries is "passparse".




CMCINFO.MAC


This file is in three parts:

Part 1. BBS INFORMATION contains all the variable information
on the BBSs called. Each BBS called must have a
macro named for the BBSID. You must select the prompt
strings for the various variables for each BBS. Make
sure that _all_ the variables are set to a value.
Unless otherwise noted. When selecting "golook"
variables take care to select variables that are as
short as possible to accomplish the purpose. Long
variables have a greater chance of getting hit by
line noise.

Part 2. BBS LISTS contains the lists of BBSs to mark for the
various supported activities. (.QWK Mail, File down-
load from an ascii list, and Bimodem.)

Part 3. USER INFORMATION contains the users name, paths that
are necessary for the proper functioning of CMC.MAC,
and user defined menu key sequences.

I have included information in the CMCINFO.MAC file
to aid in configuring it to your requirements.

Good luck and have fun!

{don}