home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / MODEM / MXLIT195.ZIP / MXLIGHT.DOC < prev    next >
Text File  |  1994-01-10  |  40KB  |  856 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                           MxLight Version 1.95
  8.  
  9.                            Operations Manual
  10.  
  11.                Copyright (c) 1993-94 by MX Communications
  12.  
  13.                           ALL RIGHTS RESERVED
  14.  
  15.  
  16.                          For support, contact:
  17.  
  18.                             James E. Fielden
  19.                           307 E. Oak Hill Ave.
  20.                           Knoxville, TN 37917
  21.                                   USA
  22.  
  23.  
  24.  
  25.  
  26.                           TABLE OF CONTENTS
  27.                            -----------------
  28.  
  29.  
  30.  
  31.         1. INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . .   2
  32.              Overview . . . . . . . . . . . . . . . . . . . . . . . . .   2
  33.              Features . . . . . . . . . . . . . . . . . . . . . . . . .   2
  34.              Licensing and Distribution . . . . . . . . . . . . . . . .   3
  35.  
  36.         2. GETTING STARTED  . . . . . . . . . . . . . . . . . . . . . .   4
  37.              System Requirements  . . . . . . . . . . . . . . . . . . .   4
  38.              Installation . . . . . . . . . . . . . . . . . . . . . . .   4
  39.              Starting MxLight . . . . . . . . . . . . . . . . . . . . .   4
  40.              Line Editing . . . . . . . . . . . . . . . . . . . . . . .   5
  41.              Configuring MxLight  . . . . . . . . . . . . . . . . . . .   5
  42.  
  43.         3. USING MXLIGHT  . . . . . . . . . . . . . . . . . . . . . . .   6
  44.              External Edit  . . . . . . . . . . . . . . . . . . . . . .   6
  45.              Getting Help . . . . . . . . . . . . . . . . . . . . . . .   6
  46.              The Status Line  . . . . . . . . . . . . . . . . . . . . .   6
  47.              MxLight's Functions  . . . . . . . . . . . . . . . . . . .   7
  48.                 Path  . . . . . . . . . . . . . . . . . . . . . . . . .   8
  49.                 Shell . . . . . . . . . . . . . . . . . . . . . . . . .   8
  50.                 Exit  . . . . . . . . . . . . . . . . . . . . . . . . .   8
  51.                 Dial  . . . . . . . . . . . . . . . . . . . . . . . . .   8
  52.                 Buffer  . . . . . . . . . . . . . . . . . . . . . . . .   9
  53.                 Hangup  . . . . . . . . . . . . . . . . . . . . . . . .   9
  54.                 Download & Upload . . . . . . . . . . . . . . . . . . .   9
  55.                 Chat  . . . . . . . . . . . . . . . . . . . . . . . . .   9
  56.                 Clear . . . . . . . . . . . . . . . . . . . . . . . . .  10
  57.                 Taglines  . . . . . . . . . . . . . . . . . . . . . . .  10
  58.                 Doorway . . . . . . . . . . . . . . . . . . . . . . . .  10
  59.                 Emulation . . . . . . . . . . . . . . . . . . . . . . .  10
  60.                 Capture . . . . . . . . . . . . . . . . . . . . . . . .  10
  61.                 Baud  . . . . . . . . . . . . . . . . . . . . . . . . .  10
  62.                 Windows . . . . . . . . . . . . . . . . . . . . . . . .  10
  63.                 Configure . . . . . . . . . . . . . . . . . . . . . . .  11
  64.                 Help  . . . . . . . . . . . . . . . . . . . . . . . . .  11
  65.                 View Text . . . . . . . . . . . . . . . . . . . . . . .  11
  66.                 Logon . . . . . . . . . . . . . . . . . . . . . . . . .  11
  67.  
  68.         4. FILE TRANSFERS & PROTOCOLS . . . . . . . . . . . . . . . . .  12
  69.              What is a File Transfer  . . . . . . . . . . . . . . . . .  12
  70.              Supported Protocols  . . . . . . . . . . . . . . . . . . .  12
  71.                 Ascii . . . . . . . . . . . . . . . . . . . . . . . . .  12
  72.                 Xmodem  . . . . . . . . . . . . . . . . . . . . . . . .  13
  73.                 1k-Xmodem . . . . . . . . . . . . . . . . . . . . . . .  13
  74.                 1k-XmodemG  . . . . . . . . . . . . . . . . . . . . . .  13
  75.                 Ymodem  . . . . . . . . . . . . . . . . . . . . . . . .  14
  76.                 YmodemG . . . . . . . . . . . . . . . . . . . . . . . .  14
  77.                 Kermit  . . . . . . . . . . . . . . . . . . . . . . . .  14
  78.                 Zmodem  . . . . . . . . . . . . . . . . . . . . . . . .  15
  79.                 ZedZap  . . . . . . . . . . . . . . . . . . . . . . . .  15
  80.              External Protocols . . . . . . . . . . . . . . . . . . . .  16
  81.  
  82.         5. REGISTERING MXLIGHT  . . . . . . . . . . . . . . . . . . . .  16
  83.            WARRANTY . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  84.  
  85.   MxLight 1.95 Copyright (c) 1993-94 by MX Communications     Page  2
  86.  
  87.                               INTRODUCTION
  88.                                Chapter 1
  89.  
  90.  
  91.         OVERVIEW
  92.  
  93.         Do you ever get tired of your Terminal program taking up more space
  94.         then your operating system.  Now communications program's are growing
  95.         to 500k to 900k easy.  Loaded with so many features that you have
  96.         to print out their 500 page + doc's.  Features that you will never
  97.         use, features that are never needed.  Have you been looking for a
  98.         good communications program with all the features you need but with
  99.         out taking a BIG chunk of your disk space.
  100.  
  101.         MxLight may be what your looking for.  Occupying just under 100k of
  102.         disk space and requiring around 128k of free memory, MxLight will
  103.         run on just about any system with no problem.  MxLight is small but
  104.         it's not bare, packed with features and runs at lighting speed on
  105.         even the slowest computers.  Check out the list of features below and
  106.         you'll see, everthing you'll need to communicate with anything.
  107.  
  108.  
  109.         FEATURES
  110.  
  111.             * Ansi,Ansi-BBS,Ansi-Music,Avatar and VT100 terminal emulations.
  112.             * Hot key commands to all the functions for quick access.
  113.             * Very low disk and memory requriments.
  114.             * No slow overlay files to load so it responds quickly.
  115.             * Dialing directory with over 200 numbers.
  116.             * Phone Book is loaded into RAM for Speed.
  117.             * Ansi driver built in so no need for ANSI.SYS to be loaded.
  118.             * Full support for Extended Doorway mode.
  119.             * TagLine file with as many taglines as you want.
  120.             * Send you Name and Password for each number with F1 & F2.
  121.             * Handles speeds from 300 to 115200 baud.
  122.             * Supports Com1 through Com8.
  123.             * Auto Flow Control and status buffering.
  124.             * Capture session to file supported with ANSI codes.
  125.             * Full Swap to DOS so you can run anything from a shell.
  126.             * Ascii, Xmodem, 1k-Xmodem, 1k-XmodemG, Ymodem(tm),
  127.               YmodemG, Kermit, Zmodem & ZedZap(8k-Zmodem)
  128.             * Support for upto 3 external protocols, without batch files.
  129.             * Two-way Split screen Chat mode.
  130.             * Auto Zmodem Download and crash recovery.
  131.             * View text files at any time in MxLight.
  132.             * Back ground ANSI-Music.
  133.             * Complete control over all menus and window colors.
  134.             * Phone Book Number Tagging.
  135.             * Easy Edit Line Editor.
  136.             * Choice of Modem Type (Hayes, Courier, Microcom).
  137.             * Very Low Price.
  138.  
  139.   MxLight 1.95 Copyright (c) 1993-94 by MX Communications     Page  3
  140.  
  141.         LICENSING AND DISTRIBUTION
  142.  
  143.         MxLight is not, nor has it ever been free software.  It is copyright
  144.         and is distributed as SHAREWARE.  You are granted a limited license
  145.         to use MxLight for an evaluation period.  If you use MxLight and you
  146.         like it then you should register it.
  147.  
  148.         Upon registering MxLight, you will receive a serial number and
  149.         instructions on how to apply it to your copy of MxLight for it
  150.         to become a registered version.  See Register.Txt for complete
  151.         details on how to register your copy of MxLight.
  152.  
  153.         You are encourged to give copies of MxLight to others so they may
  154.         evaluate it as well.  MxLight may also be uploaded to bulletin
  155.         board systems (BBS's) as long as you do not deleate any of the files
  156.         that came with MxLight.  SysOp's fell free to add your BBS logo to
  157.         the Compressed file discription, but please to not add any files
  158.         to the archive it's self.  Do not delete, add, or in anyway modify
  159.         any of the files in the MxLight package.  MxLight must be distributed
  160.         in it's entirety, complete with documentation.
  161.  
  162.         MxLight May be distributed with Shareware bundles, CD-ROMS and/or
  163.         disk.  Due to the low price to register MxLight Please don't charge
  164.         more then $5.00 per disk if the disk only contains MxLight.
  165.  
  166.   MxLight 1.95 Copyright (c) 1993-94 by MX Communications     Page  4
  167.  
  168.                             GETTING STARTED
  169.                                Chapter 2
  170.  
  171.         SYSTEM REQUIREMENTS
  172.  
  173.         IBM PC/XT/AT or close compatible computer running DOS v3.2 or above.
  174.         One floppy or Hard disk drive, a modem, and 512k of RAM.
  175.  
  176.         NOTE: Mxlight actually requires about 128k of free RAM to run.  if you
  177.         have less then 512k then try running MxLight anyway, it just might
  178.         fit, I have run MxLight on a 4.7Mhz XT with 256k of RAM on a 360k
  179.         floppy.
  180.  
  181.         INSTALLATION
  182.  
  183.         Installing MxLight is very easy to install.  First, copy the file
  184.         MX.EXE to the disk or directory where you will be using it.  Then
  185.         type MX and you are ready to start the configuration.
  186.  
  187.         STARTING MXLIGHT
  188.  
  189.         To start MxLight simply change to the disk/directory where you put the
  190.         file MX.EXE and type:
  191.  
  192.         MX
  193.  
  194.         followed by pressing the ENTER key.
  195.  
  196.         The first time you run MxLight it will create a configuration file
  197.         called MXLIGHT.CFG which will need to get some information from
  198.         you about your ComPort default baud rate and a few other things.
  199.         You will be presented with a Menu you should try and run thur each
  200.         selection on the menu to make sure MxLight is set to your liking.
  201.  
  202.   MxLight 1.95 Copyright (c) 1993-94 by MX Communications     Page  5
  203.  
  204.         LINE EDITING
  205.  
  206.         The new Easy Edit Line Editing, is very easy to use, just Hit
  207.         F10 to Save your Work or Esc to Abort it and Reload the Old
  208.         data.
  209.  
  210.  
  211.  
  212.         CONFIGURING MXLIGHT
  213.  
  214.         After MxLight starts up the first time you will be looking at a small
  215.         configuring Menu:
  216.                           *******************
  217.                           *  A - ComPort    *
  218.                           *  B - BaudRate   *
  219.                           *  C - D/L Path   *
  220.                           *  D - Emulation  *
  221.                           *  E - Windows    *
  222.                           *  F - User Name  *
  223.                           *  G - Password   *
  224.                           *  H - Dialing    *
  225.                           *  I - Colors     *
  226.                           *  J - Protocols  *
  227.                           *  K - ModemType  *
  228.                           *  Q - Quit       *
  229.                           *******************
  230.  
  231.         First off hit the A key:
  232.           If your using an IBM-PS2 it will ask for your ComPort 1 thur 8
  233.           else it will ask Enter your ComPort 1 to 4:
  234.           Just enter what comport your modem is hooked up to.
  235.  
  236.         Next hit the B key:
  237.           It will simpley ask Enter your Baud Rate(300 to 115200):
  238.           You should enter the Highest speed your modem supports.
  239.  
  240.         Next hit the C key:
  241.           Download Path must end with a backslash "\" example"C:\MX\FILES\"
  242.           If you don't want a default download path just hit enter, other wise
  243.           Enter your Download Path:  Where you want the files you get from
  244.           BBS's to go.
  245.  
  246.         Next hit the D key:
  247.           If your not sure what Terminal Emulation you need or want then
  248.           pick ANSI-BBS it is the most common and includes standard Ansi and
  249.           ANSI-Background music support.
  250.             A)NSI-BBS  V)T100  T) AVATAR /0+
  251.           Pick the letter for what type emulation you want as a default you
  252.           can always change this inside MxLight.
  253.  
  254.         Next hit the E key:
  255.           Do you want Exploding Windows(Y/n)
  256.           If you hit ENTER then Menus and display windows will explode on to
  257.           the screen if you type a "n" then the windows will appear on screen
  258.           with out the explosing.  This may also be toggled inside MxLight.
  259.  
  260.         Next hit the F key:
  261.           Enter default Name for Phone Book:
  262.           Enter the name you use most of the time when logging on to BBS's
  263.           You can have a different name for each bbs in the phone book it
  264.           will just default to this on for quicker access to the Phone Book.
  265.  
  266.         Next hit the G key:
  267.           Enter default Password for Phone Book:
  268.           Again same as above you can set a different password for each.
  269.  
  270.         Next hit the H key:
  271.           Pick your dialing mode
  272.              T)one dialing or P)ulse dialing.
  273.           If you have Push Button phones then pick T or if your phone system
  274.           is the old rotatory type then pick P
  275.  
  276.         Next hit the I key:
  277.           You will be shown a box with all possible colors for the MxLight
  278.           Windows and Menus.  Move the arrow keys around to change the
  279.           color of the Windows.  Once you find the color you want Hit ENTER.
  280.           Now move the arrow keys again to pick the color for normal text.
  281.           Again hit ENTER to accecpt the color or ESCAPE to keep the defaults.
  282.           Last Move the arrow keys to pick the color for highlighted text.
  283.           You can play with the colors more once your in MxLight by using the
  284.           Alt-G combo to find colors you like, using the Alt-G only makes the
  285.           changes Temp.  Once you exit MxLight the colors are restored to
  286.           what you have set in your configure.
  287.  
  288.         Next hit the J key:
  289.           You'll be ask which Protocol to Edit(1,2 or 3).  Start with one
  290.           Protocol Name: Enter The Name of the Protocol as you want it to
  291.           appear on the download menu(MobyTurbo,HS/LINK ect), upto 9 Letters.
  292.           d/l DOS command line:  Enter the command line to run the protocol
  293.           not a batch file name, use "%p" for ComPort number, use "%b" for
  294.           Current baud rate and "%f" for files to be transfered.
  295.           Example: dsz port %p speed %b rz -m
  296.           u/l DOS command line:  Same as above only the Upload command line.
  297.           Example: dsz port %p speed %b sz -m %f
  298.           Batch(y/N) if your external protocol enter "Y" else just hit enter
  299.           or "N".  Do this for how many of the protocls you want to set up
  300.           1,2,3 and your done.
  301.  
  302.  
  303.         Next hit the K key:
  304.          You will be shown another Menu such as.
  305.  
  306.                                Pick MOdem Type
  307.                                ===============
  308.                                 A> Hayes
  309.                                 B> Courier
  310.                                 C> Microcom
  311.  
  312.          Pick the Modem of choice, most user's will only Need to pick
  313.          'A' for Hayes type Modem with AT commands
  314.  
  315.  
  316.         Now hit the Q key:
  317.          Your ready to start using MxLight.
  318.  
  319.   MxLight 1.95 Copyright (c) 1993-94 by MX Communications     Page  6
  320.  
  321.                              USING MXLIGHT
  322.                                Chapter 3
  323.  
  324.  
  325.         USING THE EDITOR
  326.  
  327.         I've moved the editor to an external file called "EDIT.COM", so if
  328.         you liked using the internal editor then their is know changes just
  329.         an extra file about 5k in size that MxLight needs to find.
  330.         Now Alt-E will run the first file it finds called edit.  So if you
  331.         want to run your favorite editor from MxLight make a file
  332.         called EDIT.BAT put it in the same directory with MxLight or in
  333.         your DOS Path statement.  Deleat "EDIT.COM" and run your editor like
  334.         it was internal to MxLight.  My EDIT.BAT looks like this:
  335.  
  336.                                   @echo off
  337.                                   q
  338.  
  339.         Now whenever I hit Alt-E I'm in my favorite editor with all it's
  340.         power and commands that I'm used to.
  341.  
  342.         MxLight SWAP's all out to give you all but a few K to do your
  343.         editing.
  344.  
  345.  
  346.         GETTING HELP
  347.  
  348.         Hit the HOME key from inside MxLight to get a general Help screen
  349.         with a listing of all commands.
  350.  
  351.         THE STATUS LINE
  352.  
  353.         The status line displays some helpful information.  Hit reminds you
  354.         how to get help, what version of the program your using, your current
  355.         terminal emulation, if the capture buffer is open, and your registrion
  356.         information.
  357.  
  358.   MxLight 1.95 Copyright (c) 1993-94 by MX Communications     Page  7
  359.  
  360.                           MXLIGHT'S FUNCTIONS
  361.  
  362.         In this section of the doc I will go over each function of MxLight
  363.         in detail.  You don't really need to understand all of this but it
  364.         could be helpful if you run into trouble while using MxLight or any
  365.         other communications program.
  366.  
  367.         COMMUNICATIONS BASICS
  368.  
  369.            Asynchronous Serial Communication
  370.               The brodest definition of serial communications would include
  371.               anything that transits or receives data in a serial fashion.
  372.               In the PC world when someone speaks of serial commuications
  373.               they are talking about the communications facility provided by
  374.               the "serial ports"(or com ports)
  375.  
  376.            Baud Rate
  377.               When given a choice of selecting a baud rate you should select
  378.               the highest baud rate your modem supports.  Although here is a
  379.               small list of the Highest baud rate you should pick compaired
  380.               to your CPU speed:
  381.  
  382.                    CPU Speed                 Highest Baud
  383.                  ------------------------------------------
  384.                    4.77 Mhz PC/XT (8088)        9600
  385.                    8 Mhz PC/XT (8088)          19200
  386.                    8 Mhz PC/AT (286) +         57600
  387.                    16 Mhz AT (386) +          115200
  388.  
  389.               This is just a basic guide line but even if you have a 14.4
  390.               modem, but you just have a 4.77 Mhz XT you will probley only
  391.               be able to get 9600 baud or less.  If you try to get more then
  392.               this it may seem to work but will be alot more prone to line
  393.               errors, aborted transfers and failed connects.  So you would
  394.               lose more time using 14.4 then if you would have just kept your
  395.               modem at 9600 baud.
  396.  
  397.            Data Bits
  398.               A data byte can contain 5, 6, 7 or 8 bits. The vast majority
  399.               of applications will use 8 bits.
  400.  
  401.            Stop Bits
  402.               Stop bits follow the data bits in the serial data stream.  The
  403.               value for stop bits will always be either 1 or 2.  Generally,
  404.               you'll use 1 stop bit.
  405.  
  406.            Parity
  407.               Parity describes a bit checking scheme.  When used, all of the
  408.               bits in a data byte are added together.  A final bit called the
  409.               parity bit, is added such that the sum of all bits will be made
  410.               either odd or even.  Geerally you'll use NoParity since all
  411.               Protocols now use their own error checking.
  412.   MxLight 1.95 Copyright (c) 1993-94 by MX Communications     Page  8
  413.  
  414.                                   PATH
  415.  
  416.         DOWNLOAD PATH
  417.  
  418.            MxLight will download all files into the directory that you picked
  419.            when you configured MxLight.  If you did'nt pick a default download
  420.            directory then MxLight will download into the current directory
  421.            that you are running MxLight from.
  422.  
  423.         UPLOAD PATH
  424.  
  425.            MxLight does'nt use a default upload path so when you enter a
  426.            filename to upload, after you give the BBS the filename you're
  427.            uploading then tell MxLight the full path and filename of the
  428.            file you wish to send.  If the file is in the same directory as
  429.            MxLight, you only need to enter the filename.
  430.  
  431.                                  SHELL
  432.  
  433.         DROP TO DOS
  434.  
  435.            When you hit Alt-~J~ to enter a dos shell from MxLight, MxLight
  436.            Swaps all of itself but a small amount to EMS/XMS or disk if
  437.            you don't have EMS/XMS.  This allows you to run very large programs
  438.            from a MxLight Dos Shell.  You can even run MxLight from a MxLight
  439.            Dos Shell with out any problems.  MxLight Shell has been tested
  440.            with DOS Version's 3.3 and up, DRDOS and 4DOS, MxLight does this
  441.            by not looking for COMMAND.COM as many other programs do when they
  442.            go into a DOS shell it reads the systems environmet to find out
  443.            what it's surroundings are and Shells to the proper Disk Operating
  444.            System.
  445.  
  446.         EXIT
  447.  
  448.           To Exit MxLight You need to hit Alt-~X~ and then will be prompted
  449.           for a "Y" or "N" hit "y" and your back in DOS and out of MxLight.
  450.  
  451.         DIAL
  452.  
  453.           The dialing directory is very easy to use, to dial a number user
  454.           the up and down arrow keys to scroll one number at a time.  Use
  455.           PgUp and PgDn to move up or down a whole page.  Use Home and End
  456.           to got to first number or last number in phone book.  Once the
  457.           scroll bar is on the number you want hit ENTER or D to dial that
  458.           number.  Hit A to add a number to the end of the phone book.  Hit
  459.           I to insert a number anywere in the phone book.  Hit K to kill a
  460.           number(erase).  Hit C to clear a number, the entry stays in the
  461.           phone book but it deleats all the info.  Hit L to dial a number
  462.           that is not in the phone book.  Hit M to modify a number in the
  463.           phone book you'll be prompted for all the information for that
  464.           entry just hit enter at any prompt for No Changes.  And hit Q
  465.           or Escape to Exit the phone book.
  466.           When you dial a number that is in the book are using L for Local
  467.           dial MxLight will get trying the number until their is a connect
  468.           or you hit escape.
  469.   MxLight 1.95 Copyright (c) 1993-94 by MX Communications     Page  9
  470.  
  471.         BUFFER
  472.  
  473.            MxLight uses a 5k input and output buffer which is large enough
  474.            for most everthing.  But when MxLight goes into a file transfer
  475.            at high speed or using ZedZap it will change the buffer and set
  476.            everthing up for you.  No longer to you have to change your buffer
  477.            size when using a high speed modem, MxLight will sence then need
  478.            for a larger buffer and increse it.  When the transfer is done
  479.            MxLight closes the large buffer and reopens the default 5k buffer
  480.            for normal use.
  481.  
  482.  
  483.         HANGUP
  484.  
  485.            Sometimes while on-line you'll need to break the connection for
  486.            some reason or another.  Use Alt-~H~ to Hangup the line.
  487.  
  488.  
  489.  
  490.         DOWNLOAD & UPLOAD
  491.  
  492.            MxLight Has all the protocols you need and will talk more about
  493.            protocols later.  For now to download hit PgDn, you'll be prompt
  494.            with a Menu  pick the protocol that you told the BBS that you
  495.            wanted to use and if it's Ascii, or Xmodem tell MxLight the
  496.            filename and set back and enjoy.  Almost as easy to Upload PgUp
  497.            Pick the protocol that you want and tell MxLight what file to
  498.            upload.  If your using Ymodem, YmodemG, Kermit, Zmodem or ZedZap
  499.            you may enter as many files as you want.  Enter the first filename
  500.            just like doing a Xmodem upload, hit enter and you'll be prompted
  501.            for another filename.  If you're only uploading one file then
  502.            hit ENTER on the blank line to start the Upload, if your uploading
  503.            more then one file keep repeating the above cycle until you've
  504.            told MxLight all the files you want to send, then hit ENTER on
  505.            a blank line and pat your-self on the back for Uploading.
  506.  
  507.         CHAT
  508.  
  509.           When you're logged on to a BBS and want to chat with the SysOp their
  510.           is know problem Most BBS's have a nice split screen chat and echo
  511.           back to you want you type.  But if you like to call other's using
  512.           your modem then you need someway to see what you type and someway
  513.           to keep your's and the other person's typing apart.  Enter the
  514.           splitscreen Chat Alt-~T~ and enjoy TwoWay SplitScreen Chat.  In
  515.           MxLight you get half the screen, I don't cramp you into the last
  516.           3 lines on the screen like most, and the remote end gets the top
  517.           half of the screen.  Each screen is a different color and the chat
  518.           leaves your screen up under it the way it was once you entered chat.
  519.   MxLight 1.95 Copyright (c) 1993-94 by MX Communications     Page  10
  520.  
  521.         CLEAR
  522.           To clear the screen in MxLight hit Alt-~C~ this will give you a
  523.           normal Clear The Screen.  If you like to clear the screen with
  524.           alittle bit different style then hold down your Alt Key then
  525.           press 1 on your number pad then press 2 on your number pad then
  526.           let go of the Alt key, that is a scroll clear screen.
  527.  
  528.         TAGLINES
  529.  
  530.         See the example tagline file MXTAG.DAT the only think you really need
  531.         to know about the format of the file is.  The 1st line must containe
  532.         the number of taglines in the file.  Also Taglines can be know longer
  533.         then 70 charcters long.
  534.  
  535.         DOORWAY
  536.  
  537.            MxLight supports Extended doorway codes, what this means to most
  538.            people is that in doorway mode you can move around full screen
  539.            editors alot easier using the up and down arrows.  To Enter
  540.            doorway mode use Alt-~=~ you notice a change your status line
  541.            will goaway.  This is because Doorway should only be used with
  542.            a full 25 line screen.
  543.  
  544.         EMULATION
  545.  
  546.            MxLight will let you pick between three different types of terminal
  547.            emulation.  But really MxLight has support for more then 3.
  548.            Hit Alt-~V~ to change your emulation.  Select A for ANSI, ANSI-BBS
  549.            ANSI-MUSIC(with Background support) and TTY(ASCII).  This is what
  550.            most people will use all the time.  Select V for VT100, ANSI and
  551.            TTY support.  Select T for AVATAR Level 0/+(STANDARD), with fall
  552.            back to ANSI and TTY.
  553.  
  554.         CAPTURE
  555.  
  556.            MxLight will allow you to capture a complete session to a text file.
  557.            Toggle this on and off with Alt-~A~.  Hit Alt-A and you'll be
  558.            prompted for a filename, just hit enter to use the default of
  559.            MXLIGHT.CAP, or type in your own filename.  The status line let's
  560.            you know if capture is on or off, sometimes capture files can
  561.            become very large so the status line will let you know if it's
  562.            on or off.  When you exit MxLight the capture is turned off
  563.            for you if it is on.  The only time that capture is not active
  564.            if you have it on is when files are been transfered.
  565.  
  566.         BAUD
  567.  
  568.            Use Alt-~P~ to change your baud rate if you need to change it
  569.            for some reason.
  570.            If your baud is different then what you have listed in the
  571.            phone book for a number then MxLight will change it before it
  572.            dials the number.
  573.            Also this is were you can change your Parity, Data bits and
  574.            stop bits.  Hit ESCape to exit this menu.
  575.  
  576.  
  577.         WINDOWS
  578.  
  579.            Use Alt-~W~ to toggle Exploding windows on or off.  If you
  580.            did'nt select exploding windows in your configure then
  581.            sometimes you might want to watch them blow up this goes back
  582.            to the default in your configure when you exit MxLight.
  583.   MxLight 1.95 Copyright (c) 1993-94 by MX Communications     Page  11
  584.  
  585.  
  586.         CONFIGURE
  587.  
  588.            If at anytime while using MxLight if you need to change
  589.            something in your configure file use Alt-~K~, this brings up
  590.            the same menu that you saw when you first started MxLight and
  591.            gave it all your default information.
  592.  
  593.  
  594.         HELP
  595.  
  596.            Sometimes you may forget a command, Hit the ~HOME~ key to
  597.            bring up MxLight's Help screen with a list of all the
  598.            commands.
  599.            In the editor use the ~F1~ key for help.
  600.  
  601.  
  602.         VIEW TEXT
  603.  
  604.            If you ever need to view a text file while using MxLight and
  605.            don't want to put it into the editor then use the Alt-~M~ key
  606.            and you view a text file in the more style.
  607.  
  608.  
  609.         LOGON
  610.  
  611.            A couple of hints to speed up your logons.  You can use the
  612.            ~F1~ and ~F2~ keys to send the name and password from the
  613.            phone book to save you some typing.  This can be different
  614.            for each entry in the phone book.
  615.  
  616.  
  617.  
  618.   MxLight 1.95 Copyright (c) 1993-94 by MX Communications     Page  12
  619.  
  620.                        FILE TRANSFERS & PROTOCOLS
  621.                                Chapter 4
  622.  
  623.  
  624.         WHAT IS A FILE TRANSFER
  625.  
  626.         File transfers allow you to exchange programs, text, or any other
  627.     type of file with any BBS system that supports a file section.    In
  628.     order to transfer files over phone lines, the receiving system must
  629.     have some way to tell if the data it received is the same as what
  630.     was originally sent.  Phone lines are seldom perfectly clear of
  631.     static or noise, and this noise can alter the data as it travels
  632.     from one system to the other.  This is the purpose of transfer
  633.     "protocols".
  634.  
  635.     Transfer protocols generally break a file into small chunks called
  636.     "packets" or "blocks", then perform some calculation on the data
  637.     and send the "packet", followed by the result of the calculation,
  638.     to the receiver.  The receiver performs the same calculation on the
  639.     data as it comes in and then compares it's result with the
  640.     following sender's result.  If the two match, the receiver writes
  641.     this data to it's copy of the file and sends some acknowledgement
  642.     signal to alert the sender to send the next packet.  If the two
  643.     calculation results don't match then the data was corrupted in
  644.     transit and the receiver sends a negative acknowledgement signal to
  645.     alert the sender to resend the same packet.
  646.  
  647.     Different protocols use different methods for calculating the error
  648.     check value, signaling the start of a packet, and acknowledging
  649.     good and bad packets.  Therefore it is important to use the same
  650.         protocol as the system you're connected to.
  651.  
  652.  
  653.         SUPPORTED PROTOCOLS
  654.  
  655.         MxLight has the following protocols:
  656.         Ascii, Xmodem, 1k-Xmodem, 1k-XmodemG, Ymodem, YmodemG, Kermit,
  657.         Zmodem and ZedZap
  658.  
  659.         Now for brief description of each protocol.
  660.  
  661.         Ascii
  662.         Ascii isn't really a protocol since it has no method for error
  663.     checking built in and as such is only useful for text files.  It
  664.     does however provide one very useful function, you can upload a
  665.         message that was entered offline.
  666.         Since Ascii just reads a file and sends out the characters as if
  667.     you were typing them at the keyboard, it allows you to use a text
  668.     editor or word processor to create a message that you want to
  669.     "post" on a BBS.  This is done when you're not connected and not
  670.     paying for online charges.  You save your message as a pure ASCII
  671.         text file and then use MxLight to connect to the BBS.  Do whatever is
  672.     required to enter a message and when the BBS is waiting for you to
  673.     type in your message, upload your text file with the Ascii
  674.     protocol.  You will see the text appearing on your screen as the
  675.         BBS echoes it back, just as if you were typing it.
  676.   MxLight 1.95 Copyright (c) 1993-94 by MX Communications     Page  13
  677.  
  678.         Xmodem
  679.  
  680.     Xmodem is not particularly efficient nor 100% reliable, but it is
  681.     supported by almost every online service there is.  No matter how
  682.     limited a BBS's list of supported protocols is, it will probably
  683.     support Xmodem.  This is why it was essential to support Xmodem.
  684.  
  685.     Some BBS's may offer you two varieties of Xmodem reflecting the two
  686.     types of error checking that Xmodem can use.  These are Checksum
  687.         and CRC.  MxLight supports both methods and detects which one the BBS
  688.     is using so it will work with either one.  Whenever you have the
  689.     option, CRC is the preferred method as it is a great deal more
  690.     reliable than the Checksum method.
  691.  
  692.     1k-Xmodem
  693.  
  694.     1k-Xmodem is basically the same as Xmodem except for the size of
  695.     it's packets.  Xmodem uses 128 byte packets and 1k-Xmodem uses 1024
  696.     byte packets, which is where the "1k" prefix came from.  This makes
  697.     it a bit faster than Xmodem since it's packet overhead is reduced
  698.     by a factor of 8.
  699.  
  700.     You should be warned that not all BBS's refer to this protocol as
  701.     1k-Xmodem.  On some systems it's called "Old Ymodem" and others
  702.     just call it "Ymodem".    This can lead to confusion since this is
  703.         not that same as real "Ymodem (tm)" that MxLight supports.  So if
  704.     you're trying to use Ymodem and it just won't work, the BBS is
  705.         probably using a misnamed 1k-Xmodem, so tell MxLight to use 1k-Xmodem
  706.     even though the BBS calls it Ymodem.
  707.  
  708.         1k-XmodemG
  709.  
  710.         This is the same as 1k-Xmodem but it does'nt do any error checking it
  711.         leaves all error checking up to the modem.  You must have a MNP type
  712.         modem to use this protocol
  713.   MxLight 1.95 Copyright (c) 1993-94 by MX Communications     Page  14
  714.  
  715.         Ymodem (tm)
  716.  
  717.         Ymodem (tm) uses the same type of packets as Xmodem but can use
  718.     both 128 and 1024 byte packets dynamically.  The most important
  719.     feature, however, is that it starts the transfer with a special
  720.     header packet that contains complete filename, size, date, and time
  721.     information about the file.  The transfer is ended with a blank
  722.     header packet (all 0's).  These header packets allow more than one
  723.     file to be transmitted in a single session, thus it is called a
  724.     "batch" protocol.  On some BBS's this is called "True Ymodem" or
  725.     just "Ymodem" so it can be confusing to tell whether you have to
  726.         use Ymodem or 1k-Xmodem.
  727.  
  728.         YmodemG
  729.  
  730.         YmodemG like 1k-XmodemG is for MNP type modems only.  YmodemG is said
  731.         to be the fastest protocol around, if you have a MNP type modem.
  732.         YmodemG does know error checking so it must not be used with out
  733.         a error correction modem(MNP)
  734.  
  735.         Kermit
  736.  
  737.         Kermit is alot like Xmodem it was developed to facillitate file
  738.         transfers in environments that other protocols couldn't handle.
  739.         Such environments include links that only pass 7 data bits,
  740.         links that can't handle control characters, computer systems
  741.         that can't handle large blocks and other diverse links such as
  742.         those between a PC and a mainframe.
  743.  
  744.         Kermit was developed at Columbia University in New York City.
  745.         The name Kermit refers to Kermit the Frog, from the television
  746.         program The Muppet Show.
  747.  
  748.   MxLight 1.95 Copyright (c) 1993-94 by MX Communications     Page  15
  749.  
  750.  
  751.         Zmodem
  752.  
  753.         Zmodem was developed for the public domain by Chuck Forsberg
  754.         under contract to Telenet.  The purpose was to provide a durable
  755.         protocol with strong error recovery features and good
  756.         performance over a variety of network types(switched,
  757.         satellite, ect.).  It has generally achieved these design goals
  758.         and therefore, should be your protocol of choice whenever
  759.         possible.
  760.  
  761.         Zmodem borrows some concepts from Xmodem, Ymodem and Kermit but
  762.         is really a completely different protocol.
  763.  
  764.         ZedZap
  765.  
  766.         ZedZap is still new on the scene for most modem user's but
  767.         ZedZap has been around for sometime and in use on Fidonet.
  768.         ZedZap is the same as Zmodem execpt that it will attempt to use
  769.         8k blocks instead of the 1024 used by Zmodem.  It starts just
  770.         the same as Zmodem and if their is no errors it grows and keeps
  771.         growing the block size until it reaches 8k or has an error.
  772.         Both sending and receiving sides must be using ZedZap for it to
  773.         work, but if your downloading using ZedZap and the other side is
  774.         using Zmodem it will just stay at the 1024 block size.
  775.  
  776.   MxLight 1.95 Copyright (c) 1993-94 by MX Communications     Page  16
  777.  
  778.         External Protocols
  779.  
  780.         MxLight now will support upto 3 external protocols.  They are very
  781.         easy to set up and you don't need external batch files to run your
  782.         protocols so that speeds up access to them.  MxLight will use 3
  783.         codes in your external protocol command line.
  784.  
  785.         %p will pass the Comport number to the command line.  %b will pass
  786.         the baud rate to your command line.  %f will pass any files your
  787.         uploading or on non-batch protocols will pass the file name on d/l.
  788.         Case does'nt matter for the %b,%p or %f Exp: %p,%P,%b,%B,%f,%F
  789.  
  790.         Examples
  791.  
  792.         MobyTurbo
  793.  
  794.         Download   "dsz port %p speed %b rz -m"
  795.         Upload     "dsz port %p speed %B sz -m %f"
  796.         Batch      "Y"
  797.  
  798.         HS/LINK
  799.  
  800.         Download   "hslink -P%p -B%b"
  801.         Upload     "hslink -P%p -B%b %F"
  802.         Batch      "Y"
  803.  
  804.         After typing in the command lines and the name of the protocol make
  805.         sure MxLight can find your protocol by having it in your DOS path
  806.         or in the same directory as MxLight.
  807.  
  808.  
  809.                           REGISTERING MXLIGHT
  810.                                Chapter 5
  811.  
  812.         To register MxLight, simply print the file REGISTER.TXT on your
  813.         printer, fill in the requested information and mail the form
  814.         along with your check or money order to:
  815.  
  816.                             James E. Fielden
  817.                           307 E. Oak Hill Ave.
  818.                           Knoxville, TN 37917
  819.                                   USA
  820.  
  821.         In order to print the form you can type the following at your
  822.         DOS prompt:
  823.  
  824.         copy register.txt prn
  825.  
  826.         If you don't have a printer then you can send a letter
  827.         containing your name, your address and a check or money order
  828.         for $10.00 to the above address.  If you want a disk mailed to
  829.         you, then include $5.00 for shipping.  After receiving your
  830.         money order or after your check clears the bank I'll send you
  831.         your serial number and information on how to apply it to
  832.         MxLight.  If you send the $5.00 shipping then I'll send you the
  833.         latest copy of MxLight with your serial number and whatever else
  834.         I can cram on to the disk.(Sharware, FreeWare).
  835.  
  836.  
  837.                                 WARRANTY
  838.  
  839.         MxLight is sold "as is" without warranty of any kind, express or
  840.         implied, including but not limited to, any warranties of
  841.         merchantability and/or fitness for a particular purpose.  MX
  842.         Communications and/or James E. Fielden shall not be liable for
  843.         any damages, whether direct, indirect, special or consequential
  844.         arising from a failure of MxLight to operate in the manner
  845.         desired by the user.
  846.  
  847.         IN NO EVENT WILL MX COMMUNICATIONS AND/OR JAMES E. FIELDEN BE
  848.         LIABLE FOR ANY DAMAGES TO DATA OR PROPERTY WHICH MAY BE CAUSE
  849.         DIRECTLY OR INDIRECTLY BY THE USE OF MXLIGHT.  MX COMMUNICATIONS
  850.         AND/OR JAMES E. FIELDEN SHALL NOT BE LIABLE TO YOU FOR ANY
  851.         DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER
  852.         INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR
  853.         INABILITY TO USE MXLIGHT, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  854.  
  855.  
  856.