home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / MXLITE19.ZIP / MXLIGHT.DOC < prev    next >
Text File  |  1993-09-01  |  41KB  |  849 lines

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