home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMMUNIC / C64TERMD.ZIP / C64TERM.DOC < prev    next >
Encoding:
Text File  |  1990-10-24  |  38.9 KB  |  1,477 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                            C64 Color Terminal Emulator
  23.  
  24.                                  by Greg Pfountz
  25.  
  26.                                        V.1D
  27.  
  28.                                  October 24, 1990
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.         
  58.         
  59.         C64 COLOR TERMINAL EMULATOR                                PAGE 1
  60.  
  61.                              * * * INTRODUCTION * * *
  62.  
  63.         Welcome to the wonderful world of Commodore's color/graphics
  64.         telecommunications!  C64 Color Terminal Emulator will allow many
  65.         IBM or compatible computer owners to join in on the fun that
  66.         Commodore users enjoy.
  67.  
  68.         The Commodore 64 family of computers does not use the standard
  69.         ASCII character set.  It uses a customized character set known as
  70.         CBM ASCII.  This alternate character set allows changing
  71.         character colors and cursor movements simply by displaying a
  72.         specific character code.  For example, when the Commodore 64
  73.         prints a chr$(5), the cursor becomes white and all remaining
  74.         characters printed to the screen will be displayed white.  And
  75.         when you print chr$(145), the cursor moves up one line and all
  76.         remaining text will print from this position.  This method of
  77.         cursor positioning and setting screen colors is similar in
  78.         abilities to what ANSI offers to an IBM or compatible only much
  79.         simpler to use.
  80.  
  81.         This program will allow users of IBM and compatible
  82.         personal computer systems to call any Commodore 64 or Commodore
  83.         128 color/graphics bulletin board system and view/send any of the
  84.         color and graphics.  I know that there are several other terminal
  85.         emulators that offer similar abilities; it is my goal to produce
  86.         a terminal program that has more features and is easier to use. I
  87.         want to offer to any IBM or compatible user a terminal program
  88.         that:
  89.  
  90.            1) works properly on their system
  91.            2) does the best job possible of CBM ASCII emulation
  92.            3) is easy for the end user to learn and operate
  93.            4) offers the features we have all come to expect
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.         
  117.         
  118.         C64 COLOR TERMINAL EMULATOR                                PAGE 2
  119.  
  120.                         * * * HARDWARE REQUIREMENTS * * *
  121.  
  122.         C64 Color Terminal Emulator was written with Microsoft's Quick-C
  123.         (v2.5) and should run satisfactorily at 2400 baud even while
  124.         processing a script and logging to disk even on the slowest of
  125.         systems.  On faster systems, the maximum baud rate is 110,000.
  126.         It is required that your system be using a CGA, Hercules, EGA or
  127.         VGA display type - although an MDA option (without color of
  128.         course) could be added later if enough demand warrants it.  A
  129.         color monitor is not required, but it definitely improves the
  130.         appearance of the display.  If you are a DESQview user, C64 Color
  131.         Terminal Emulator will automatically detect your DESQview
  132.         environment and write directly to DESQview screen memory.
  133.  
  134.         A Hayes compatible modem is required and can be connected to
  135.         COM1, COM2, COM3 or COM4 and must have DCD (data carrier detect)
  136.         working properly (eg. setup to be true only when the modem is
  137.         connected to a remote system).  Non-Hayes compatible modems may
  138.         be made to work, but no guarantees are made here.  Supported baud
  139.         rates are 300-110,000.
  140.  
  141.         Due to the differences in the character set of the Commodore 64s
  142.         and the IBMs, not all Commodore character codes have an exact IBM
  143.         character code replacement.  And only the EGA and VGA display
  144.         systems on the IBMs allow redefining the character sets to
  145.         emulate the unique Commodore character codes.  So CGA and
  146.         Hercules users will not see the graphic screens exactly as they
  147.         should - but they will be close.  EGA and VGA users will find the
  148.         display of graphic characters much better.
  149.  
  150.         Also, the IBMs and compatibles allow 16 foreground colors and 8
  151.         background colors while in text mode.  Any combination of
  152.         foreground and background colors are allowed.  The IBM systems do
  153.         not have a specific reverse video mode.  The Commodore 64 has 16
  154.         colors any of which can be normal or reverse video and only one
  155.         of the 16 available colors at a time can be the background color.
  156.         Both computer systems have very good text color abilities, but
  157.         each are different enough that an exact emulation is not
  158.         possible.  The PC can only display 8 background colors (used to
  159.         emulate the reverse video mode on the Commodore 64) so not all
  160.         colors will be exact.  For example, a line of yellow text on the
  161.         Commodore 64 will show as a yellow text on the IBMs and
  162.         compatibles, but when the yellow line is reverse video on the
  163.         Commodore 64, it will display as black characters on a red
  164.         background on the IBM (there is not a yellow background color
  165.         available on the IBM systems).  I am sure that overall you will
  166.         find the emulation very good.
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.         
  176.         
  177.         C64 COLOR TERMINAL EMULATOR                                PAGE 3
  178.                                 * * * FILES * * *
  179.  
  180.         The following files are contained in this archive:
  181.  
  182.          C64TERM.EXE  - C64 Color Terminal Emulator
  183.          C64TERM.DOC  - this file
  184.          C64TYPE.EXE  - displays Commodore files on screen
  185.                         uses the same output routines as C64TERM.EXE
  186.          CBM2ASCI.EXE - converts a CBM ASCII file to ASCII
  187.                         default output is STDOUT - can be redirected to
  188.                         a disk file or printer
  189.          LBR64.EXE    - dissolves Commodore .lbr files
  190.          AX.EXE       - dissolves Commodore .arc files (by Chris Smeets)
  191.          LISTCBM.EXE  - displays Commodore BASIC files (by Chris Smeets)
  192.  
  193.         The following file will be created automatically:
  194.          C64TERM.CFG  - config file for C64TERM.EXE
  195.                         contains your configuration, phone list, function
  196.                         keys, etc.
  197.  
  198.         The executable files should either be placed in a directory that
  199.         is in your path or a batch file should be created to make the
  200.         directory where these files are stored your default directory.
  201.  
  202.         The C64TERM.CFG needs to be either in the default directory when
  203.         C64 Color Terminal Emulator is started or you need to assign the
  204.         environment variable C64TERM to point to where your C64TERM.CFG
  205.         is stored.  For example
  206.          SET C64TERM=C:\TERMINAL\
  207.         will tell C64 Color Terminal Emulator to look for its
  208.         configuration file in the C:\TERMINAL\ directory even if
  209.         C64TERM.EXE is located in another diretory and/or your default
  210.         directory is not C:\TERMINAL\.
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.         
  235.         
  236.         C64 COLOR TERMINAL EMULATOR                                PAGE 4
  237.  
  238.                                * * * STARTUP * * *
  239.  
  240.         C64 Color Terminal Emulator was designed to be started in 1 of 2
  241.         ways.  First is for it to be started from the command prompt by
  242.         typing:
  243.          C64TERM [SCRIPT]
  244.         It will initialize the modem and if applicable, automatically
  245.         execute SCRIPT.  This is the way most term programs are started.
  246.  
  247.         Alternatively, (and I feel will be the most popular) is to call
  248.         C64 Color Terminal Emulator from within another terminal program
  249.         (such as Telix, Procomm or any of the other popular ANSI/ASCII
  250.         terminal emulators for the MS DOS family of computers).  With
  251.         this mode of startup, you might be using the autodialer of your
  252.         ASCII terminal program to dial a series of bulletin board numbers
  253.         waiting for a connection on any one of several systems.  If you
  254.         get a connection on a Commodore color/graphics system, a script
  255.         from within the ASCII terminal program would then execute through
  256.         its system/dos/run command C64TERM [SCRIPT] to start C64TERM and
  257.         if SCRIPT automatically execute SCRIPT.  C64 Color Terminal
  258.         Emulator will not send any modem initialize commands, nor will it
  259.         attempt to initialize the UART when started in this manner.
  260.         Instead it will query the UART to determine its current baud rate
  261.         and display that baud rate on its own status line.  And then
  262.         SCRIPT will take over and begin to log you into the Commodore
  263.         color/graphics system.
  264.  
  265.         The following script will load C64 Terminal Emulator from within
  266.         Telix and automatically start a script named DE.SCR:
  267.  
  268.             main() {
  269.                dos("c64term de",0);
  270.             }
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.         
  294.         
  295.         C64 COLOR TERMINAL EMULATOR                                PAGE 5
  296.  
  297.                                 * * * SETUP * * *
  298.  
  299.         Setup is performed via a series of pop-up menus.  Initially the
  300.         Alt-Key sequence for SETUP is Alt-S.  One of the options from
  301.         within SETUP allows you to redefine the Alt-Key sequences
  302.         themselves.  If you should ever forget what sequence you defined
  303.         for SETUP, refer to the Help Screen.  This help screen will
  304.         reflect the current Alt-Key assignments.  Even the Alt-Key
  305.         sequence to pull up the Help Screen can be redefined.  If
  306.         necessary, refer to the status line at the bottom of the screen
  307.         for the current Alt-Key sequence to call up the help screen.
  308.  
  309.         The menu below indicates the options available in SETUP.
  310.  
  311.             ┌───────────────┐
  312.             │ Screen Colors │
  313.             │ Files/Paths   │
  314.             │ Function Keys │
  315.             │ Alt Keys      │
  316.             │ ASCII Pacing  │
  317.             │ Modem Init    │
  318.             └───────────────┘
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.         
  353.         
  354.         C64 COLOR TERMINAL EMULATOR                                PAGE 6
  355.  
  356.                             * * * SCREEN COLORS * * *
  357.  
  358.         The first option (Screen Colors) allows you to redefine any of
  359.         the menu and status line colors.  By default, the color choices
  360.         are light grey on a black background.  Not the most interesting
  361.         color combination - but one that should be visible by all screen
  362.         types. This option allows each system to use whatever colors
  363.         that are best for your hardware and personal preferences.  When
  364.         selected, the following menu will appear.
  365.  
  366.             ┌───────────────────────────────────┐
  367.             │   F1 - Text Foreground Color      │
  368.             │   F2 - Text Background Color      │
  369.             │   F3 - Border Foreground Color    │
  370.             │   F4 - Border Background Color    │
  371.             │   F5 - Title Foreground Color     │
  372.             │   F6 - Title Background Color     │
  373.             │   F7 - Selected Foreground Color  │
  374.             │   F8 - Selected Background Color  │
  375.             │   F9 - Shadow Foreground Color    │
  376.             │  F10 - Shadow Background Color    │
  377.             │ SHF1 - Status Foreground Color    │
  378.             │ SHF2 - Status Background Color    │
  379.             │            Selected Text          │
  380.             └───────────────────────────────────┘
  381.  
  382.         Simply press the Function Key indicated to increment the desired
  383.         color.  The menu will immediately update to the new color.
  384.         Repeat selecting Function Key's until you find the combination
  385.         that best suits you and your hardware.  There are 16 possible
  386.         foreground colors and 8 possible background colors.  Press ESC
  387.         when you have selected the best possible color combination - the
  388.         new colors will begin being used immediately and automatically be
  389.         saved in the C64TERM.CFG file when you Exit C64 Terminal
  390.         Emulator.
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.         
  412.         
  413.         C64 COLOR TERMINAL EMULATOR                                PAGE 7
  414.  
  415.                              * * * FILES/PATHS * * *
  416.  
  417.         The second option on the SETUP menu (Files/Paths) allows you to
  418.         define where C64TERM will find its SCRIPT files as well as where
  419.         to upload files from and download files to on your system.  The
  420.         menu will look similar to the following.
  421.  
  422.             ┌──────────────────────┐
  423.             │  Download Path:A:\   │
  424.             │                      │
  425.             │  Upload Path:  A:\   │
  426.             │                      │
  427.             │  Script Path:  A:\   │
  428.             └──────────────────────┘
  429.  
  430.         Leave the field blank to use the current directory.
  431.  
  432.         In the case of the upload and download directories, the paths can
  433.         be overwritten during an upload or download simply by backspacing
  434.         over the path display and changing it as necessary.
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.         
  471.         
  472.         C64 COLOR TERMINAL EMULATOR                                PAGE 8
  473.  
  474.                             * * * FUNCTION KEYS * * *
  475.  
  476.         The third option on the SETUP menu (Function Keys) allows you to
  477.         pre-define up to 20 function keys. Each function key can contain
  478.         up to 70 characters and when pressed, will send its contents at a
  479.         pace that is suitable for a Commodore 64 BBS.  The exact pace is
  480.         defined in the ASCII SEND option (discussed later).  Simply use
  481.         the cursor arrow keys to select the desired function key and type
  482.         the text you want to send.  Use the ~ character to send a
  483.         carriage return and type \### to send any other non-ASCII
  484.         character codes.
  485.  
  486.             ┌───────────────────────────────────────┐
  487.             │     F1                                │
  488.             │     F2                                │
  489.             │     F3                                │
  490.             │     F4                                │
  491.             │     F5                                │
  492.             │     F6                                │
  493.             │     F7                                │
  494.             │     F8                                │
  495.             │     F9                                │
  496.             │     F10                               │
  497.             │  SH F1                                │
  498.             │  SH F2                                │
  499.             │  SH F3                                │
  500.             │  SH F4                                │
  501.             │  SH F5                                │
  502.             │  SH F6                                │
  503.             │  SH F7                                │
  504.             │  SH F8                                │
  505.             │  SH F9                                │
  506.             │  SH F10                               │
  507.             └───────────────────────────────────────┘
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.         
  530.         
  531.         C64 COLOR TERMINAL EMULATOR                                PAGE 9
  532.  
  533.                                * * * ALT KEYS * * *
  534.  
  535.         The next option in SETUP (Alt Keys) allows you to redefine the
  536.         Alt-Key sequences for C64TERM.  This is handy for those persons
  537.         who are used to using a specific ASCII terminal when calling
  538.         other BBS systems and allows modifying C64 Color Terminal
  539.         Emulator to use the same Alt-Key sequences.  For example, maybe
  540.         the terminal program you are used to using uses ALT-O for Setup
  541.         Options and Alt-J for DOS (such as Telix), this feature will
  542.         allow you to modify C64 Color Terminal Emulator to use the same
  543.         Alt-Key sequences.  So instead of your having to learn another
  544.         terminal program, C64 Color Terminal Emulator can be setup to
  545.         operate similar to the terminal programs you currently use.
  546.  
  547.         The following menu is what you will see when you select Alt Keys.
  548.         Be careful to not assign 2 functions to the same Alt-Key
  549.         sequence.
  550.  
  551.             ┌─────────────────────┐
  552.             │           Setup: O  │
  553.             │       Baud Rate: R  │
  554.             │    Clear Screen: C  │
  555.             │       Dos Shell: J  │
  556.             │  Execute Script: G  │
  557.             │      Log On/Off: L  │
  558.             │    Phone Dialer: D  │
  559.             │   Review Screen: B  │
  560.             │    Hangup Modem: H  │
  561.             │            Help: Z  │
  562.             │            Exit: X  │
  563.             └─────────────────────┘
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.         
  589.         
  590.         C64 COLOR TERMINAL EMULATOR                               PAGE 10
  591.  
  592.                               * * * ASCII SEND * * *
  593.  
  594.         The next option on the SETUP menu (ASCII Send) is where you will
  595.         define the character by character pacing as well as the line by
  596.         line pacing used by C64TERM when sending either an ASCII file, a
  597.         function key or text from within a script.  The default is a 30
  598.         millisecond delay per character with a 500 millisecond delay at
  599.         the end of each line.  These values should work good when
  600.         calling most Commodore systems.  Keep in mind that these values
  601.         have nothing what-so-ever to do with an Xmodem Upload or Download
  602.         which will always transfer at maximum speed.
  603.  
  604.             ┌───────────────────────────────────┐
  605.             │  Char Pacing (1/1000 secs):   30  │
  606.             │                                   │
  607.             │  Line Pacing (1/1000 secs):  500  │
  608.             └───────────────────────────────────┘
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.         
  648.         
  649.         C64 COLOR TERMINAL EMULATOR                               PAGE 11
  650.  
  651.                               * * * MODEM INIT * * *
  652.  
  653.         And lastly on the SETUP menu (Modem Init) is where you define an
  654.         initial string to send to your modem, an initial baud rate to use
  655.         and the desired COM port.  The modem init string and baud rate
  656.         will only be execute *IF* your system is not already detecting
  657.         carrier when C64 Color Terminal Emulator is started.  This allows
  658.         C64 Color Terminal Emulator to be easily called from within
  659.         another terminal program and instead of having to be concerned
  660.         with making sure the baud rate is correct and avoiding the
  661.         results of the sending the modem init string to the already
  662.         connected system, C64 Terminal Emulator just quietly starts up
  663.         and even 'learns' your current baud rate.  Below is the menu you
  664.         see when you select Modem Init.
  665.  
  666.             ┌──────────────────────────────┐
  667.             │     Modem init: ATS7=60S8=2~ │
  668.             │                              │
  669.             │      Baud rate: 2400         │
  670.             │                              │
  671.             │ COM port (1-4): 1            │
  672.             └──────────────────────────────┘
  673.  
  674.         Available COM ports are 1 - 4.  If you change the COM port
  675.         number, you will need to exit and restart C64 Color Terminal
  676.         Emulator before the new port number will be used.
  677.  
  678.         If there is a need for any other COM ports - send me the hardware
  679.         specifics and I will see if I can find a way to support them as
  680.         well.
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.         
  707.         
  708.         C64 COLOR TERMINAL EMULATOR                               PAGE 12
  709.  
  710.                                 * * * DIALER * * *
  711.  
  712.         C64 Color Terminal Emulator has a built in dialer capable of
  713.         storing and dialing up to 50 separate numbers.  I personally
  714.         feel 50 numbers is more than enough - but if anyone needs more
  715.         than 50 just let me know how many you want and I will make sure
  716.         our next version will accommodate your needs.
  717.  
  718.         The dialer system is very easy to use.  Pressing the Alt-Key
  719.         sequence to activate the dialer brings up the dialer screen.
  720.         From here you can press D to select a number or numbers for
  721.         dialing, M to enter a number to manually dial, E to select a
  722.         number to add/edit, C to edit the dialer configuration
  723.         information or Q to quit back to terminal mode.
  724.  
  725.  
  726.                                  * * * DIAL * * *
  727.  
  728.         If you press D for dial, press the space bar to mark numbers to
  729.         be dialed, and when you have selected all the numbers, press
  730.         RETURN.  The system will dial each marked number one by one until
  731.         a connection is made.  After a connection is made and that call
  732.         is complete, if you select Dial again the remaining selections
  733.         will still be marked for dial.
  734.  
  735.  
  736.                                 * * * MANUAL * * *
  737.  
  738.         If you press M for manual, you will need to enter a phone number
  739.         to dial and the baud rate.  The system will dial and redial that
  740.         one number until a connection is made.
  741.  
  742.  
  743.                                  * * * EDIT * * *
  744.  
  745.         If you press E for Edit, use the up and down arrows to highlight
  746.         the number to add/edit and press enter.  Then you will enter the
  747.         system name, phone number, baud rate and script name.
  748.  
  749.  
  750.                                 * * * CONFIG * * *
  751.  
  752.         If you press C for Configure, you will need to enter your modems
  753.         dial command (ATDT if your phone line has touch tone service or
  754.         ATDP if your have rotary service), dial command suffix (normally
  755.         ~ for a carriage return), seconds to wait for carrier (45 - 90
  756.         seconds is normal (the system will automatically redial earlier
  757.         if your modem detects a busy line and notifies C64 Color Terminal
  758.         Emulator with a BUSY message), delay between redials, and whether
  759.         you want the system to automatically adjust baud rate to match
  760.         the remote system.
  761.  
  762.         The dial command prefix and suffix are user definable to allow
  763.         support of different modem types as well as support of different
  764.         long distance services.  If your modem does not use AT command to
  765.         
  766.         
  767.         C64 COLOR TERMINAL EMULATOR                               PAGE 13
  768.         dial - you may be able to enter your modems dial commands here.
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.         
  825.         
  826.         C64 COLOR TERMINAL EMULATOR                               PAGE 14
  827.         But more important is if you are in an area where you need to
  828.         dial extra characters before your number (eg. dial 9 to get an
  829.         outside line), you could define your dial command prefix as
  830.         'ATDT9,' (for example).  And if you are dialing from an area
  831.         where you need to charge the call to your phone credit card, you
  832.         could put (for example) ',,,,,80055512121111~' as your modem
  833.         suffix (enough commas to delay until you hear the tone then your
  834.         credit card number followed by a ~ for the carriage return).
  835.  
  836.         The auto adjust baud rate feature allows C64 Color Terminal
  837.         Emulator to read the speed at which the modem is connected and
  838.         adjust itself to match.  When a Hayes 1200 compatible modem
  839.         connects to another modem, it can be programmed to respond with
  840.         CONNECT or CONNECT 1200.  If the modem is a Hayes 2400 compatible
  841.         modem, it can be programmed to respond with CONNECT,
  842.         CONNECT 1200, or CONNECT 2400, depending on the speed of the
  843.         modem on the other end.  This allows us to always dial our modems
  844.         at their highest baud rate and if the modem answering is a slower
  845.         type, C64 Color Terminal Emulator will read the modems response
  846.         and adjust itself accordingly.  For a Hayes 1200 compatible modem
  847.         to be able to respond with CONNECT 1200, you must first send it
  848.         an ATX1 command.  Some modems have a switch you can set to allow
  849.         it to default to this setting.  And for those that do not, you
  850.         can put an ATX1 in your modem init string in the Modem Init
  851.         section of SETUP in C64 Color Terminal Emulator.  For a Hayes
  852.         2400 compatible modem to be able to respond with CONNECT 2400,
  853.         you must first send an ATX2 command.  Actually if your modem
  854.         supports ATX4 (most newer modems now do), this will allow your
  855.         modem to respond with BUSY, VOICE, CONNECT, CONNECT 1200, CONNECT
  856.         2400, and NO CARRIER and is the recommended setting for all 2400
  857.         baud modems.  Most Hayes 2400 compatible modems allow you to
  858.         define your ATX? setting and store it in non-volatile memory
  859.         using an AT&W command.  If you have a modem that will not save
  860.         your ATX command in non-volatile memory, you can put it in your
  861.         Modem Init section of SETUP in C64 Color Terminal Emulator.
  862.  
  863.         If your modem does not support the ATX extended response codes,
  864.         make sure you put an N in the auto baud rate adjust field.
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.         
  884.         
  885.         C64 COLOR TERMINAL EMULATOR                               PAGE 15
  886.  
  887.                            * * * SCRIPT COMMANDS * * *
  888.  
  889.         C64 Color Terminal Emulator has a simple built in script
  890.         processor.  All script commands are case insensitive with one
  891.         command per line allowed and a maximum line length of 80
  892.         characters.  At any time you can abort an executing script by
  893.         press the ESC key or by pressing the Execute Script Alt-Key
  894.         sequence.
  895.  
  896.         Following is a list of all script commands:
  897.  
  898.  
  899.         DELAY VALUE
  900.  
  901.             Will delay the script processor (but not the terminal
  902.             emulator) for VALUE of 1/1000th's of a second.
  903.  
  904.             EXAMPLE:
  905.  
  906.                 delay 3000
  907.  
  908.             will force a delay of 3 seconds.
  909.  
  910.  
  911.         WAITFOR TEXT
  912.  
  913.             Will delay the script processor (but not the terminal
  914.             emulator) until TEXT is received.  TEXT may be multiple words
  915.             and the comparison text is case insensitive.  TEXT should
  916.             not be enclosed in quotes unless quotes will be received
  917.             from the remote system.  The maximum length of text is 72
  918.             chars.  Use the ~ to wait for a Carriage Return.
  919.  
  920.             EXAMPLE:
  921.  
  922.                 waitfor hit return
  923.  
  924.             will force a delay of the script processor until 'hit return'
  925.             is received from the remote system.
  926.  
  927.  
  928.         TIMEOUT VALUE
  929.  
  930.             This command will set the maximum amount of time that WAITFOR
  931.             will wait for a text match.  A separate TIMEOUT should be defined
  932.             immediately before each WAITFOR.  Failure to define a TIMEOUT
  933.             will cause WAITFOR to wait indefinitely.
  934.  
  935.             EXAMPLE:
  936.  
  937.                 timeout 5000
  938.                 waitfor hit return
  939.  
  940.             will force a delay of the script processor until 'hit return'
  941.             is received from the remote system or 5 seconds has passed.
  942.         
  943.         
  944.         C64 COLOR TERMINAL EMULATOR                               PAGE 16
  945.         IFTIMEOUT COMMAND
  946.  
  947.             If a TIMEOUT command has terminated the previous WAITFOR
  948.             command, the rest of the line behind IFTIMEOUT will be
  949.             processed by the script processor.  Otherwise the processor
  950.             will skip to the beginning of the next line.
  951.  
  952.             EXAMPLE:
  953.  
  954.                 :l1
  955.                 timeout 5000
  956.                 waitfor command
  957.                 iftimeout send \016
  958.                 iftimeout goto l1
  959.  
  960.             will wait for 'command' to be received from the remote system
  961.             or if 5 seconds has passed, will send a control p and loop
  962.             back to the :l1 label.
  963.  
  964.  
  965.         SEND TEXT
  966.  
  967.             Will send TEXT at the character and line pacing speed as defined
  968.             in ASCII Send.  Use the ~ to send a Carriage Return.
  969.  
  970.             EXAMPLE:
  971.  
  972.                 send 123~password~
  973.  
  974.             will send '123' followed by a new line and then 'password'
  975.             followed by another new line.
  976.  
  977.  
  978.         PRINT TEXT
  979.  
  980.             Will print TEXT to the screen followed by a Carriage Return.
  981.  
  982.             EXAMPLE:
  983.  
  984.                 print Sending MAIL.BBS
  985.  
  986.             Will display on your screen (not to the remote system)
  987.             'Sending MAIL.BBS' followed by a carriage return.
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.         
  1002.         
  1003.         C64 COLOR TERMINAL EMULATOR                               PAGE 17
  1004.         SENDFILE FILENAME.EXT
  1005.  
  1006.             Will send an ascii file at the character and line pacing speed as
  1007.             defined in ASCII Send.  The file is expected to be in ASCII
  1008.             format and will be converted to CBM ASCII as it is sent.
  1009.  
  1010.             EXAMPLE:
  1011.  
  1012.                 sendfile user.msg
  1013.  
  1014.             Will open the file 'USER.MSG' and will send it one character
  1015.             at a time at the pace defined in SETUP.
  1016.  
  1017.  
  1018.         UPLOAD FILENAME.EXT
  1019.  
  1020.             Will send a file using the Xmodem/CRC protocol.  If the file does
  1021.             not exist, an error will print and the script will continue.  To
  1022.             write reliable scripts, use the IFEXIST command to determine if a
  1023.             file exists before attempting to send it.
  1024.  
  1025.             EXAMPLE:
  1026.  
  1027.                 upload mail.bbs
  1028.  
  1029.             will begin an xmodem file upload of MAIL.BBS to the remote
  1030.             system.
  1031.  
  1032.  
  1033.         DOWNLOAD FILENAME.EXT
  1034.  
  1035.             Will receive a file using the Xmodem/CRC protocol.  If filename
  1036.             already exists, you will be prompted if you want to replace the
  1037.             file or not.
  1038.  
  1039.             EXAMPLE:
  1040.  
  1041.                 download members.lst
  1042.  
  1043.             will begin an xmodem file download from the remote system to
  1044.             the MEMBERS.LST file on your system.
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.         
  1061.         
  1062.         C64 COLOR TERMINAL EMULATOR                               PAGE 18
  1063.         LOGOPEN FILENAME.EXT
  1064.  
  1065.             Will open FILENAME.EXT as a capture file and all incoming data
  1066.             will be saved to this file.  All captured data will be converted
  1067.             to ASCII as it is saved to disk.  If the capture file already
  1068.             exists, new data will be appended to the end of the file.
  1069.  
  1070.             EXAMPLE:
  1071.  
  1072.                 logopen messages.log
  1073.  
  1074.             will open MESSAGES.LOG and store every character received
  1075.             from the remote system into it after first converting each
  1076.             character from CBM ASCII to ASCII.
  1077.  
  1078.  
  1079.         LOGCLOSE
  1080.  
  1081.             Will close an open capture file.
  1082.  
  1083.             EXAMPLE:
  1084.  
  1085.                 logclose
  1086.  
  1087.             closes an open capture file.
  1088.  
  1089.  
  1090.         SHELL COMMAND PARAMETERS
  1091.  
  1092.             Will shell out to DOS and pass COMMAND PARAMETERS to COMMAND.COM.
  1093.             This is a handy way to delete files, rename files, etc.
  1094.  
  1095.             EXAMPLE:
  1096.  
  1097.                 shell del c:\temp\*.*
  1098.  
  1099.             will shell out to dos and del all files in c:\temp
  1100.  
  1101.  
  1102.         BAUD VALUE
  1103.  
  1104.             Will change baud rate to the value indicated by VALUE.
  1105.  
  1106.             EXAMPLE:
  1107.  
  1108.                 baud 1200
  1109.  
  1110.             will set the current baud rate to 1200.
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.         
  1120.         
  1121.         C64 COLOR TERMINAL EMULATOR                               PAGE 19
  1122.         GOTO LABEL
  1123.  
  1124.             Allows jumping to another place in the script file indicated by
  1125.             :LABEL.  For a line to be considered a label, it must be begin
  1126.             with a : and contain any combination of characters and numbers.
  1127.             Goto's and labels are case insensitive.  Labels can also be used
  1128.             for comments since the script processor skips all lines that
  1129.             begin with a : for purposes other than as a target of GOTO.
  1130.  
  1131.             EXAMPLE:
  1132.  
  1133.                 ifexist mail.msg goto sendmail
  1134.                 goto logoff
  1135.                 :sendmail
  1136.                 send f
  1137.                 delay 3000
  1138.                 sendfile mail.msg
  1139.                 send /s
  1140.                 waitfor command
  1141.                 :logoff
  1142.                 send o
  1143.                 delay 1000
  1144.                 send y
  1145.  
  1146.             will check to see if MAIL.MSG exists and if so, will goto the
  1147.             routine that posts the message onto the bbs.  If the file
  1148.             does not exist, the script goes to the :logoff line.
  1149.  
  1150.  
  1151.         SCRIPT FILENAME
  1152.  
  1153.             Allows chaining one script to another.  The currently running
  1154.             script will be terminated and the called script will start at the
  1155.             beginning.
  1156.  
  1157.             EXAMPLE:
  1158.  
  1159.                 send 123~password~
  1160.                 script color64
  1161.  
  1162.             will send the id followed by a carriage return, then the
  1163.             password followed by another carriage return then loads and
  1164.             executes COLOR64.SCR from the directory defined in setup for
  1165.             script files.  This is handy when you have one script file
  1166.             for a certain kind of BBS, you could create several small
  1167.             script files to send the different logon data then they all
  1168.             chain to the same script to execute code that is common to
  1169.             all the BBSs of that type.
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.         
  1179.         
  1180.         C64 COLOR TERMINAL EMULATOR                               PAGE 20
  1181.         IFEXIST FILENAME.EXT
  1182.  
  1183.             If a line begins with IFEXIST FILENAME.EXT, the following part
  1184.             of the line will only be executed if FILENAME.EXT exists.
  1185.  
  1186.             EXAMPLE:
  1187.  
  1188.                 ifexist mail.msg goto sendmail
  1189.  
  1190.             would only execute the 'goto sendmail' if the file MAIL.MSG
  1191.             exists in the current directory.
  1192.  
  1193.  
  1194.         Example Script
  1195.  
  1196.         An example of a script that will automatically log you onto a
  1197.         Color 64 BBS:
  1198.  
  1199.             timeout 5000
  1200.             waitfor hit return
  1201.             send ~
  1202.  
  1203.             timeout 5000
  1204.             waitfor (y/n)
  1205.             send Y
  1206.  
  1207.             timeout 10000
  1208.             waitfor ~>
  1209.             send ###~ (put your user number here)
  1210.  
  1211.             timeout 10000
  1212.             waitfor ~>
  1213.             send ********~ (put your password here)
  1214.  
  1215.         This script can be started in one of 3 ways.  If you are using
  1216.         the built in dialer, put the script name in the dialer
  1217.         configuration.  If you are using a dialer in another term program
  1218.         and running C64TERM as a script or in a shell, start C64TERM with
  1219.         the script name as the command parameter (ex. C64TERM BBSNAME).
  1220.         And finally you can start the script by pressing your Execute
  1221.         Script Alt-Key combination.
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.         
  1238.         
  1239.         C64 COLOR TERMINAL EMULATOR                               PAGE 21
  1240.  
  1241.                      * * * Commodore 64 Character Codes * * *
  1242.  
  1243.         The following are a few of the more popular Commodore character
  1244.         codes.  These codes can be used when programming function keys
  1245.         and scripts.
  1246.  
  1247.         CHR$    Result On Screen
  1248.  
  1249.            5    White
  1250.           17    Crsr Down
  1251.           18    Rvs On
  1252.           19    Home Crsr
  1253.           28    Red
  1254.           29    Crsr Right
  1255.           30    Green
  1256.           31    Blue
  1257.          129    Orange
  1258.          145    Crsr Up
  1259.          146    Rvs Off
  1260.          147    Clr Scrn
  1261.          148    Insert Space
  1262.          149    Brown
  1263.          150    Lt Red
  1264.          151    Dark Grey
  1265.          152    Med Grey
  1266.          153    Lt Green
  1267.          154    Lt Blue
  1268.          155    Lt Grey
  1269.          156    Purple
  1270.          157    Crsr Left
  1271.          158    Yellow
  1272.          159    Cyan
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.         
  1297.         
  1298.         C64 COLOR TERMINAL EMULATOR                               PAGE 22
  1299.  
  1300.                               * * * Shareware * * *
  1301.  
  1302.         C64 Color Terminal Emulator is being released as shareware.  This
  1303.         does not mean that this is free software.  What it does mean
  1304.         that you have the opportunity to try this software before you
  1305.         spend any of your hard earned money.  I spent many months
  1306.         developing and debugging C64 Color Terminal Emulator and will
  1307.         probably spend many more months improving it.  This shareware
  1308.         copy is not crippled or limited in operation in any way.  If you
  1309.         find that this software does meet your needs, $20 is all that is
  1310.         required to register your copy.  In return, you will get the
  1311.         latest version and documentation on disk along with notification
  1312.         when major updates are released.
  1313.  
  1314.         Updates will always be free if you send in a blank disk in a pre-
  1315.         addressed pre-stamped mailer.  Or if you prefer, I will supply
  1316.         the disk, postage and mailer for $5.
  1317.  
  1318.         Please register your copy!
  1319.  
  1320.            Mail to:                        For more information:
  1321.                Greg Pfountz                     BBS# - 703 466 2120
  1322.                14 Longdale Rd                   GEnie - COLOR64BBS
  1323.                Bristol, VA  24201
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.         
  1356.         
  1357.         C64 COLOR TERMINAL EMULATOR                               PAGE 23
  1358.  
  1359.                            C64 Color Terminal Emulator
  1360.  
  1361.  
  1362.                                 Registration Form
  1363.  
  1364.  
  1365.  
  1366.            Name: ________________________________________________________
  1367.  
  1368.  
  1369.         Address: ________________________________________________________
  1370.  
  1371.  
  1372.            City: ___________________________  State: _____  Zip: ________
  1373.  
  1374.  
  1375.  
  1376.  
  1377.                                                                  Total
  1378.                                               QTY               Enclosed
  1379.  
  1380.  
  1381.         C64 Color Terminal Emulator         _______  x $20.00 = ________
  1382.  
  1383.  
  1384.                        Desired Disk Size (circle one):    5 1/4    3 1/2
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.         
  1415.         
  1416.         C64 COLOR TERMINAL EMULATOR                               PAGE 24
  1417.  
  1418.                               * * * Update History * * *
  1419.  
  1420.         09/23/90 V.1
  1421.  
  1422.         Beta Test Release
  1423.  
  1424.  
  1425.         10/01/90 V.1A
  1426.  
  1427.         Fixed COM4 incorrect base address problem
  1428.  
  1429.  
  1430.         10/02/90 V.1B
  1431.  
  1432.         Dos shell did not work on all systems.  Instead of shelling out
  1433.         with the contents of COMSPEC to execute, now I shell out with
  1434.         COMMAND as the program to execute.
  1435.  
  1436.  
  1437.         10/08/90 V.1C
  1438.  
  1439.         First public release
  1440.  
  1441.  
  1442.         10/24/90 V.1D
  1443.  
  1444.         Fixed 'Auto adjust baud rate' to work properly at 1200 baud.  On
  1445.         faster CPU's, the system was picking up NULLs between the
  1446.         characters of the connect message and confusing the program
  1447.         logic.  The system now strips out all but alpha/numeric
  1448.         characters when looking for the connect messages.
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.         
  1474.         
  1475.         C64 COLOR TERMINAL EMULATOR                               PAGE 25
  1476.  
  1477.