****************************************
          *                  MEX                 *
          *             STEP by STEP             *
          *                  by                  *
          *           Curtis W. Givens           *
          *  Kaypro Users of Dayton Ohio (KUDO)  *
          ****************************************

    The  step by step outline for MEX114.COM listed  below  is
meant   to  accompany  and  supplement  the  file   MEX-IMP.WMT
previously up-loaded to the KUDO Host.

                           Step 1:

    You will need MEX114.COM and the appropriate overlay  file
for  you  computer/modem  combination. A  file  called  MEX.HLP
should  also  be  available  to be  placed  on  the  disk  with
MEX114.COM so you can use MEX's built in help facility. All  of
these  files are in the library file MEX114.LBR except for  the
overlay. The library contains a catalog of available  overlays.
The  library  also has a file  called  MLOADxx.COM  (xx-version
number). You will need this file also.

                           Step 2:

    Use  your  word processor or editor to read  through  your
overlay  file and make any changes that you need  to  customize
the overlay for your computer modem combination. In the case of
Kaypro  computers and the overlay MEXOVL.ASM there weren't  any
major changes to make.

                           Step 3:

    Place  your  overlay and ASM.COM on a disk and  enter  the
following: ASM MEXOVL <cr><-- use name of your overlay.

    ASM.COM  will generate two files one a .HEX file  and  the
other  a  .PRN file. Before leaving this step read  the  screen
carefully  and make sure there are no error messages  generated
by ASM.COM.

                           Step 4:

    Place  MEX114.COM, the .HEX file generated in step 3,  and
MLOADxx.COM on a disk and enter the following:

           MLOAD MEX.COM-MEX114.COM,XXXXXX.HEX <CR>

MEX.COM  can  be replaced by any name that you want to  use  to
call  your  working  version of  the  program.  Substitute  the
filename of you .HEX file for the X's. MLOAD will generate  the
file MEX.COM in this case, this is a working copy of MEX114.COM
ready to run with you computer/modem.

                           Step 5:

    If you already have several phone numbers that you want to
use you'll want to do one more thing before we start using MEX.
    Use  you word processor or editor to create a file  called
PHONE.PHN with the following format:
               PHONE ID-1-XXX-XXX-XXXX baud rate
               PHONE ID- etc
ID can be any identifier for a phone number up to 8 characters.
Baud  Rate is optional. You can include up to 32 phone  numbers
in this library.

                           Step 6:

    You  need  a  disk with your working  copy  of  MEX114.COM
generated  by MLOAD in step 4, MEX.HLP and the  PHONE.PHN  file
you  created in step 5. With these files together and ready  to
go call MEX up by whatever name you gave it in step 4 and we'll
finish the customizing process.

                           Step 7:

    You  should  now  have MEX running and  have  your  cursor
waiting  for you at the MEX prompt. Enter SET<cr> and MEX  will
show  you  a  list  of its current  settings.  Look  them  over
carefully and see if any of them need changed. For Kaypro users
with  internal modems you should enter SET INTERNAL<cr> to  get
you internal modem activated. If you use rotary phones and  you
have tone dialing as one of the entries enter SET PULSE<cr>  to
change the dialing mode. You may find some BBS's that need more
than the 30 second answer delay but most of them will work okay
with  30.  For now leave the parity, stop and bits/char  as  is
since these settings will work with nearly any board you  might
want to contact.

                           Step 8:

    Enter  STAT<cr>  and  MEX will display  all  of  its  STAT
variables.  For this exercise we are interested in two  entries
in this table the one labeled ESC and the one label CLOCK.  The
information  following ESC (T-mode escape char) will  tell  you
what  character you will use to get out of the  terminal  mode.
The  character in quotes is the key you'll use. In some  copies
of MEX114.COM, it is shown as "^[" which is the key labeled ESC
on  most keyboards. Other versions of MEX114.COM have just  "["
or  the left bracket key as the escape character. From  now  on
when  I say use your ESC key I'll be referring to whatever  key
your version uses for its escape character.
    The  entry  after CLOCK is the clock speed for  your  CPU.
Most  distribution copies of MEX114 have this set at 46 or  4.6
mhz. If you have one of the older Kaypros with the 2 mhz  clock
you will need to change this by entering STAT CLOCK 20<cr>. Use
this command to set the clock speed in the program to match you
CPU's clock speed.

                          Step 10:

    Now  we  want to read the phone library that  you  created
into  MEX so that you can call your numbers by  entering  their
ID's. Enter the following at the MEX prompt:
                      READ PHONE.PHN<cr>
MEX will read your phone number library and after the next step
the numbers will be a part of your working copy of MEX.

                          Step 11:

    None  of the changes that we've made since we started  MEX
are permanent and they will all be lost if we exit MEX at  this
point.  If you've finished making changes and want  them  saved
for the next session you use the CLONE command as follows:
                       CLONE MEX.COM<cr>
MEX  will  inform you that the file MEX.COM exists,  if  that's
what you called you working program when you used MLOAD and ask
if  it's  okay  to erase. Say yes and MEX  will  create  a  new
version of MEX.COM with your changes included.

                          Step 12:

    Time has come to make a call. If you're using an  external
modem turn it on and enter this command:
                   CALL ID or CALL xxx-xxxx
MEX  will have the modem dial the phone number associated  with
the  ID you specify or it will dial the phone number  that  you
enter  at the command line. Adding the # symbol will cause  MEX
to  try to dial this number until it gets through or until  you
abort the dialing with a Control-C. A number after # will limit
the  tries to the specified number. You can also have  MEX  try
several numbers until it gets through by including the ID's  on
the command line with just a space between each one.

                          Step 13:

    If  this  is your first contact with a  new  board  you'll
probably want to open a capture file so that you can get a hard
copy of all the material that the remote is going to spew  out.
If  you are already in contact with a remote system  you  start
the capture file as follows:
         a.) ESC E {gets you back to command mode}
         b.) T filename.ext {back to terminal mode with a file
open by the specified name.
    Another  option  is to open the capture  file  before  you
start the call like this:
         a.) T filename.ext {opens the capture file}
         b.) ESC E {gets you back to command mode}
         c.) CALL ID
As soon as the remote system answer MEX will go to the terminal
mode  with  the capture file open. A colon will appear  on  the
screen  at  the  start of each line as an  indicator  that  you
capture  file  is working. MEX uses a 16K  capture  buffer  and
every  16K  it will briefly suspend things while it  writes  to
disk.

                          Step 14:

    As  you  look around through the files of the  remote  you
will  probably come across programs that you would like to  add
to  your  collection. You should find out if the remote  has  a
help  file for downloading and copy it into you  capture  file.
After you get off line read through the instructions or  better
yet  print the instructions out so you'll have it  beside  your
keyboard when you try your first download. Procedures will vary
from  system to system but downloading will go  something  like
this:

    a.)  xmodem s du:filename.ext<cr> <-- you enter  this,  du
can  be  omitted if you are logged on the drive and  user  area
that has the file you want to download. If the remote  supports
the new 1K protocol you will want a "k" after the "s".
    b.)  The  remote will display some information  about  the
transfer  and then tell you that the file is open and ready  to
send.
    c.) Enter ESC E {you're back in command mode}
    d.) Enter rt filename.ext<cr> you can include a drive  and
user  area  if you wish the file to be placed  on  a  different
drive  or user than you are currently logged to. The "r"  tells
MEX to receive a file, the "t" tells it to go back to  terminal
mode  when the transfer is completed. If you are using  the  1K
protocol put a "k" between the "r" and "t".

                          Step 15:

    Sending a file to the remote is also fairly simple.  Again
exact  procedures  may vary slightly from board  to  board  but
it'll go something like this:
    a.)  xmodem r filename.ext<cr> <-- tells the  remote  that
you are sending it a file.
    b.)  The remote will tell you it has a file open ready  to
receive.
    c.) ESC E
    d.) st filename.ext<cr> <-- MEX will send the file and  go
back to terminal when the transfer is complete.

Note: If you have a capture file open MEX will suspend it while
you do xmodem transfers and reopen it each time you go back  to
the terminal mode.

                          Step 16:

    After  you sign off from the remote and after  the  remote
drops  its carrier you want to enter ESC E to get back  to  the
command  mode.  Now enter WRT<cr> to close  your  capture  file
properly.  You can now exit from MEX with EXIT<cr> or go on  to
make more calls.