home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / dos / util / plethora / bbs.doc < prev    next >
Text File  |  1994-09-29  |  18KB  |  481 lines
  1.  
  2.                                 LaunchComm (tm)
  3.                       
  4.                       Copyright 1994  Brandyware Software
  5.  
  6.                          Documentation for LaunchComm
  7.                          ────────────────────────────
  8.  
  9.                                    CONTENTS
  10.  
  11.  
  12.              Setup.......................................Section 1
  13.  
  14.              Main Menu/Protocols.........................Section 2
  15.  
  16.              Dialing Directory...........................Section 3
  17.  
  18.              Script Language.............................Section 4
  19.  
  20.              Compuserve ID#: 73741,745  
  21.  
  22. Section 1                          
  23.                                    Setup
  24.                                    ~~~~~
  25.  
  26.  The very first thing you want to do is, SET your COMMunications Port,
  27.  BAUD rate, Parity, Stop Bit, and Word Length.
  28.                                                    _____
  29.  To do this, from the main terminal screen - press Alt-I - and enter in
  30.  this information (you will be prompted one at a time).
  31.    _______________________
  32. 1. The Communications Port - As a rule, if you have your MOUSE already
  33.    on COM1: then your MODEM should be on COM2:  Enter the number 2 here.
  34.    If you're not sure which COMM port your modem is connected to, select
  35.    COM2: first, and type AT to see if you get the OK response from your
  36.    modem. If not, select COM1: and then type the AT command again,
  37.    you should receive the OK response this time. (ONLY COM1: and COM2:
  38.    are supported in LaunchComm).
  39.    
  40.    _____________
  41. 2. The BAUD rate - This is the speed that your modem is capable of reaching.
  42.    They range from 300 BAUD to 57600 BAUD. Most modems today run 
  43.    from 1200 BAUD to 14400 BAUD.
  44.    
  45.    (2400 BAUD is the default setting)
  46.    
  47.    Note: For 14400 BAUD modems, the best setting is 19200 BAUD.
  48.  
  49.    ________
  50. 3. Stop Bit - Set to 1 or 0  (default = 0)
  51.    
  52.    ______
  53. 4. Parity -  The parity may be EVEN, ODD, or NONE (E, O, or N).
  54.              
  55.        Note: You must use a parity of NONE (N) when
  56.              using a word length of 8!  (default = N)
  57.    
  58.    ___________
  59. 5. Word Length - The Word Length must be 7 or 8. (default = 8)
  60.    
  61.    __________
  62. 6. Phone Type  - The phone type would be <T>one or <P>ulse.
  63.    Tone types are push button. Pulse types are rotary.
  64.    
  65.    ______________________
  66. 7. Initialization String - This is the initialization command sent to the
  67.    modem on start-up.
  68.  
  69.    It MUST always start with the AT command.
  70.    
  71.    Example: AT&H1&C1X4
  72.  
  73.    A default string has been added, you may change this string anytime
  74.    you wish by editing the string here.
  75.    
  76.    _________________
  77. 8. External Protocol - Here is where you can enter an external protocol
  78.    driver. Enter the name of the protocol, and make sure it is either
  79.    in the PLETHORA directory or in a directory on your PATH command.
  80.    
  81.    Note: Use the SUP.BAT & SDOWN.BAT files for this protocol!
  82.          See - Protocols!
  83.  
  84.    There, setup is complete! and you may never have to do this again, 
  85.    unless you need to upgrade.
  86.  
  87.    The next step is, to go and add some numbers to the Dialing directory
  88.    (see - Dialing Directory) and start calling some electronic services!
  89.    
  90.    Press Alt-D from the terminal screen to see the dialing directory.
  91.    
  92.    Pressing ESC from the Dialing Directory, or any menu, will always bring 
  93.    you back to the terminal screen.
  94.  
  95.  
  96. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  97. Section 2                        
  98.                                  Main Menu
  99.                                  ~~~~~~~~~
  100.  
  101.  By pressing Alt-F10 from the terminal screen, you can display 
  102.  the Main Menu!
  103.  
  104.  Note: The terminal screen is the first screen you see before you are
  105.        automatically brought to the dialing directory. This screen is
  106.        used to display the BBS (services) screens.
  107.        Press ESC from the dialing directory screen to return to the 
  108.        terminal screen.
  109.  
  110.  
  111. What the options do!
  112. ~~~~~~~~~~~~~~~~~~~~
  113.     _________________________
  114. 1.  Alt-B - Backscroll Screen - The Backscroll Screen will keep track of 
  115.     the last 600 lines that have scrolled by while connected to a service.
  116.     This comes in handy in case something goes by too fast for you to read,
  117.     or you just need to reread it again. The buffer holding this information
  118.     must be deleted every 600 lines, so keep this in mind when using this
  119.     feature (don't wait too long, or it will be deleted).
  120.     
  121.     _____________
  122. 2.  Alt-C - Clear - Clears the terminal screen.
  123.     
  124.     _________________________
  125. 3.  Alt-D - Dialing Directory - See Dialing Directory (section 3).
  126.     List of names & phone numbers to call.
  127.  
  128.     ____________
  129. 4.  Alt-E - Echo - Turns local echo on or off.
  130.  
  131.     __________________
  132. 5.  Alt-F - List Files - This will invoke the File Viewer to display ALL 
  133.     the files in the current directory. see #12.
  134.     
  135.     _______________
  136. 6.  Alt-H - Hang-Up - Hangs up the modem - Breaks connection.
  137.  
  138.     ______________________
  139. 7.  Alt-I - Initialization - See Setup (section 1)
  140.     Set BAUD, Port, Init. string, protocol, etc..
  141.  
  142.     ______________
  143. 8.  Alt-M - Macros - Macros let you instantly have pretyped text go to the 
  144.     COMM port. Good examples are, your Name, Phone number & Address.
  145.  
  146.     To do this, press Alt-M. A macro editing screen will pop-up for
  147.     you to enter or edit your Macros in.
  148.  
  149.     They will be assigned to your FUNCTION keys (1-10).
  150.  
  151.     Examples:
  152.  
  153.     F1 =  "John Smith"
  154.     F2 =  "602-555-1212"
  155.     F3 =  "2509 Main Street"
  156.    
  157.     Note: Don't type in the quotation marks!
  158.  
  159.     The next time you press F1, the name John Smith will be typed out
  160.     to the COMM port for you. To place an ENTER (carriage return) at the
  161.     end of the Macro, type  ^M.  
  162.    
  163.     Example: John Smith^M
  164.    
  165.     This will type out John Smith, and then simulate a carriage return.
  166.     You have up to 10 Macros at your disposal!
  167.  
  168.     ______________________
  169. 9.  Alt-P - Set Parameters - Set Parameters allows you to set or reset the 
  170.     communications parameters, On Line or Off Line.
  171.     BAUD rate, Parity and Word Length.  See Setup (section 1).
  172.  
  173.     ______________________
  174. 10. Alt-S - Screen Capture - This feature will capture the current screen 
  175.     and send it to a text file called SCRCAP.BBS for later reviewing. 
  176.     If you press Alt-C more then once, the current screen will be appended 
  177.     to the bottom of the SCRCAP.BBS file.
  178.     
  179.     _____________________
  180. 11. Alt-T - Terminal Type - Terminal Type will let you setup the type of
  181.     terminal needed for each call to an electronic service.
  182.     
  183.  a. Filtered ANSI - This filters the ANSI codes for monochrome
  184.     adapters (use only if you're having problems with a service
  185.     displaying characters).
  186.     
  187.  b. BBS ANSI - Some services allow ANSI colored graphics. 
  188.     A good example is a local BBS (Bulletin Board Service) which most 
  189.     of the time are in ANSI color and display simple animation.
  190.     
  191.  c. DUMB - If you don't want anything fancy! 
  192.     
  193.  d. VT52 - This will emulate the VT52 <mainframe> terminal.
  194.     
  195.     _________________
  196. 12. Alt-V - View File - The File Viewer is selected in the <File Manager> 
  197.     under the SET command (see REFERENCE - File Manager).
  198.     You will be prompted on the file's name, then the File Viewer will be
  199.     invoked on the entered file.
  200.     
  201.     ____________________
  202. 13. Alt-F4 - Drop To DOS - Drop to DOS and issue a DOS command(s), then type 
  203.     the EXIT command to return to LaunchComm.
  204.         ~~~~
  205.     Note: If you change directories or drives, don't forget to return to
  206.           the PLETHORA directory.
  207.     
  208.     __________________________
  209. 14. Alt-F5 - Run a Script file. (see Script language - section 4)
  210.     Enter the script file name to RUN.
  211.  
  212.     ___
  213. 15. Esc  - Exits LaunchComm and returns you to Plethora.
  214.     
  215.     ____
  216. 16. PgUp - Send a file.     - See Protocols #18
  217.     
  218.     ____
  219. 17. PgDn - Receive a file.  - See Protocols #18
  220.     
  221.     _________
  222. 18. Protocols - protocols are the method in which you transfer files
  223.                 over your modem.
  224.                            
  225.                 You have 4 built-in protocols, they are:
  226.                 
  227.                 Xmodem, Modem7 (batch Xmodem), Ymodem (1k
  228.                 Xmodem), and batch Ymodem.
  229.                 
  230.                 Batch Xmodem & Ymodem allow you to send or
  231.                 receive more then one file at a time.
  232.     
  233.     __________________
  234.     External Protocols
  235.  
  236.                 External protocols can be added as needed.
  237.                 
  238.                 The first two external protocols are Zmodem and
  239.                 HS/Link - Built-in setup..  protocol NOT included!
  240.                 
  241.                 These two protocols are much faster than Xmodem or
  242.                 Ymodem! You MUST purchase them yourself.
  243.                 You can find the shareware versions for a FREE trial 
  244.                 run on most BBS's.
  245.  
  246.                 The BATCH files for these two external protocols are
  247.                 included and pre-setup for you. 
  248.                 
  249.                 The file names are:
  250.                 
  251.              1. ZUP.BAT for Zmodem uploading, and ZDOWN.BAT for Zmodem
  252.                 downloading. This is setup for the graphical Zmodem
  253.                 called GSZ.
  254.                 
  255.              2. HUP.BAT for HS/Link uploading, and HDOWN.BAT for HS/Link
  256.                 downloading.
  257.  
  258.                 These BATCH files MUST remain in the PLETHORA directory 
  259.                 for them to operate correctly!
  260.  
  261.                 Once you have a copy of the above mentioned protocols,
  262.                 place them somewhere on your PATH, or in the PLETHORA
  263.                 directory. 
  264.                 
  265.                 When you download a file (receive a file) the file will 
  266.                 be placed in the PLETHORA\DL directory.
  267.  
  268.                 To upload a file (send a file) place the file in the
  269.                 PLETHORA directory.
  270.  
  271.                 The third external protocol is left blank so you may
  272.                 enter any kind of protocol you wish. To enter the
  273.                 protocol name, press Alt-I - the last entry in the
  274.                 setup window is set aside for this third protocol.
  275.                 
  276.                 You MUST use the batch files:
  277.  
  278.              3. SUP.BAT and SDOWN.BAT for this third external protocol.
  279.  
  280.                 See the ZUP.BAT & ZDOWN.BAT files for an example on how
  281.                 to setup the SUP.BAT & SDOWN.BAT files.
  282.  
  283.  
  284.     Note: You may change the first two protocols by changing the BATCH
  285.           files.. BUT you can't change their names inside of LaunchComm,
  286.           only the third protocols name can be changed!  (see above)
  287.  
  288. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  289. Section 3
  290.                               
  291.                               Dialing Directory
  292.                               ~~~~~~~~~~~~~~~~~
  293.  
  294.  
  295.  The dialing directory is the list of all your names and phone numbers 
  296.  of the services you call.
  297.  
  298.  The most popular services to call are BBS's (Bulletin Board Service).
  299.  On a BBS you can chat with other users about a wide range of topics, or
  300.  seek help with a computer problem you're having. Most allow you to
  301.  download files (transmit them over your modem from the BBS to your
  302.  system) at no cost to you (public domain or shareware files).
  303.  
  304.  Other services include national services you can connect to for a fee.
  305.  
  306.   
  307.  The dialing directory has three fields.
  308.   
  309.   1. The Name/Comment field.
  310.   2. The Phone number field.
  311.   3. The BAUD rate field, set for each phone number.
  312.  
  313.  
  314.   The menu for the dialing directory consists of:
  315.      
  316.      __
  317.   1. F1 - This help file is loaded.
  318.      
  319.      ________________________
  320.   2. The Up & Down Arrow keys. They will move the hi-light bar over the
  321.      name & number you want to call.
  322.      
  323.      ____
  324.   3. EDIT - Edit allows you to ADD, EDIT or DELETE a record from the 
  325.      directory.
  326.      
  327.      When adding a record, just type in the Name, Number & BAUD rate.
  328.      You can press ENTER to accept the default settings for the BAUD 
  329.      rate, Parity, & Word Length. See Setup - section 1.
  330.      
  331.      The defaults are:      │    Options are:
  332.                             │             
  333.      BAUD         =  2400   │    300 to 57600
  334.      Parity       =  N      │    N, E, or O
  335.      Word Length  =  8      │    7 or 8
  336.      
  337.      ____
  338.   4. DIAL - Press D or ENTER to dial the hi-lighted record.
  339.      
  340.      ______
  341.   5. MANUAL - Manual allows you to enter a phone number manually without
  342.      saving it to the dialing directory.
  343.      
  344.      ___
  345.   6. ESC - Returns you to the terminal screen.
  346.      
  347.      _____
  348.   7. Alt-X - Quick exit from LaunchComm, returning you to Plethora.
  349.  
  350. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  351. Section 4
  352.  
  353.                                Script Language
  354.                                ~~~~~~~~~~~~~~~
  355.  
  356.  The Script Language is used for automated log-ons to services.
  357.  You can run partial scripts that will end after your name &
  358.  password have been entered. Or.. you can have it run the full 
  359.  length of the session!
  360.  
  361.  You may also use a script to initialize the setup of LaunchComm and
  362.  have it enter an initialization string, set the BAUD and Parity and
  363.  so forth.
  364.                              
  365.                               * * * *
  366.  
  367.  The initialization script file MUST be called <INIT.SCP> for
  368.  LaunchComm to find it. Create this file using LetterWrite!
  369.  
  370.                               * * * *
  371.  
  372.  The file name for the BBS (services) script can be any name you like, 
  373.  and is RUN by pressing <Alt-F5> and entering the script file's name.
  374.  
  375.  Note: ALL script files MUST be located in the PLETHORA directory.
  376.  
  377.  Script File Commands
  378.  ~~~~~~~~~~~~~~~~~~~~
  379.  
  380.  BAUD      - baudrate                
  381.              Example:  
  382.              BAUD 9600
  383.  
  384.  CLS       - clears the screen
  385.  
  386.  DIAL      - dials a phone number    
  387.              Examples: 
  388.              DIAL 4                           or.. 
  389.              DIAL `John Smith'                or.. 
  390.              DIAL 555-1212                    or..
  391.              DIAL 555-1212 <Scriptfile name>
  392.  
  393.              The number may be either the phone number, or the entry
  394.              number in the dialing directory.
  395.              You can also specify a string delimited by single quotes,
  396.              in which case the first entry in the dialing directory
  397.              that contains the string will be dialed.
  398.  
  399.  ECHO      - on/off
  400.  
  401.  EMULATE   - emulate a certain terminal       
  402.              Examples: 
  403.              EMULATE DUMB   or.. NOANSI, BBSANSI or VT52
  404.  
  405.  END       - exits LaunchComm
  406.  
  407.  EXIT      - exits the current script file and returns to the terminal 
  408.  
  409.  HANGUP    - hangs up the modem
  410.  
  411.  PARITY    - enter the parity & word length   
  412.              Example: 
  413.              PARITY N 8
  414.  
  415.  PHONETYPE - enter phone type - tone or pulse 
  416.              Example: 
  417.              PHONETYPE TONE
  418.  
  419.  PORT      - COMM port 1 or 2                  
  420.              Example: 
  421.              PORT 2
  422.  
  423.  PRINT     - sends a string to the screen - This string MUST be delimited
  424.              with single quotes. You can include control codes by
  425.              specifying them outside the quotes, in either of two ways.
  426.              You can use the pound sign "#", followed by the ASCII code
  427.              of the character to send. Or.. you can also use a caret "^"
  428.              followed by the letter for the control code.
  429.  
  430.              This example sends a BEEP (control-G), followed by the
  431.              message "LaunchComm", followed by a carriage return.
  432.  
  433.              PRINT ^G`LaunchComm'#13
  434.  
  435.  SHELL     - drops to DOS, optionally executing a file name that you specify.
  436.              Example: 
  437.              SHELL TYPE READ.ME
  438.  
  439.  RUN       - exits an existing script file, runs a script file specified by
  440.              file name. If no file name is specified, the current script is
  441.              restarted from the top.
  442.  
  443.  WAIT      - waits for a given condition to be met - this may be either,
  444.              ANY, which waits for ANY response from the comm port, or a
  445.              number, which is a time delay in eighteenths of seconds.
  446.              Example: 
  447.              WAIT ANY  or  WAIT 18
  448.  
  449.  TIMEOUT   - Sets the timeout delay for the INPUT command. - TIMEOUT 18
  450.  
  451.  RECEIVE   - receives a file - RECEIVE YMODEM TEST.ZIP - RECEIVE YMODEM
  452.  
  453.  SEND      - sends a file    - SEND YMODEM TEST.ZIP
  454.  
  455.  INPUT     - waits for a specified string to be received from the comm port.
  456.              On TIMEOUT, control passes to the next script command by default.
  457.              Example: 
  458.              INPUT `Message'    or...
  459.              INPUT `Enter First Name:'
  460.              
  461.              The string MUST be delimited with single quotes. You may
  462.              include control codes by specifying them outside the quotes.
  463.              You can use a "#" sign followed by the ASCII code of the
  464.              character to send, or you can use a caret "^" followed by
  465.              the letter for the control code you wish to generate.
  466.  
  467.  
  468.  OUTPUT    - sends a string out to the comm port - This is similar to
  469.              the PRINT command. Except it sends the string to the port and 
  470.              not the screen.
  471.              
  472.              Example: 
  473.              OUTPUT `LaunchComm'#7^M
  474.  
  475.              This will send the word LaunchComm, followed by a beep, and a 
  476.              carriage return.  #7 = BEEP  ^M = ENTER    (see PRINT)
  477.  
  478. -------------------------------End of File------------------------------------
  479.  
  480.  
  481.