home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 3 / af003.adf / Access! / Access!.DOC < prev    next >
Text File  |  1989-04-24  |  45KB  |  1,019 lines
  1.   __________________________________________________________________________
  2.  |                                                                          |
  3.  |                 Access!  (C) 1987/88 by Keith Young                      |
  4.  |__________________________________________________________________________|
  5.  |                                                                          |
  6.  |   Author:  Keith Young                                                   |
  7.  |  Version:  1.4                                                           |
  8.  |     Date:  08/14/88                                                      |
  9.  |   Status:  ShareWare (registration: $25.00) (please read "Future.txt")   |
  10.  |     Size:  137652                                                        |
  11.  |__________________________________________________________________________|
  12.  
  13. Copyright and Distribution notice:
  14. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15.     Access! is being distributed as  SHAREWARE  and may be posted at will,
  16.    provided the following files (listed below) remain  UNCHANGED  and  AS
  17.    A WHOLE in ARCHIVE FORM along with this notice. (files may be "un-arced"
  18.    in a directory together on pd disks)
  19.     
  20.     ALL rights to the program and graphic images within it remain with the
  21.    author: Keith Young
  22.  
  23.     Please  NOTE  that this program IS being distributed as "ShareWare",
  24.    which means that it is  "User Supported Software".  Your support is
  25.    appreciated.
  26.  
  27.     I have spent ( and do spend ) many hours (and more than a few bucks)
  28.    every week designing, programming and debugging  "Access!"  and will
  29.    continue to do so as long as there is enough interest and support to
  30.    warrant doing so.
  31.  
  32.  
  33. ---------------------------------------------------------------------------
  34.  
  35.  Credits:    ( Although most of the programming and implementation of code
  36.  ~~~~~~~~      in this program is a sole effort on my part, I believe in
  37.                giving credit where credit is due...)
  38.  
  39.          DJ.James  -> for the origianal source to "Comm1.34" (thanx Dan, I
  40.                       couldn't have made this mess without it! (grin))
  41.          C.Heath   -> for the origianal source to the "File Requester" and
  42.                       "Color Palette".
  43.         D.Greenwald-> For his Fast Font routines...
  44.          J.Nangano -> For sample source to and help with CIS-QB protocol and
  45.                       review buffer routines.
  46.          M.Fahrion -> For the NICE Icon!
  47.  
  48.   And everyone else who's answered my programming questions, made suggestions
  49.  or reported problems.
  50.  
  51. (and of course)
  52.     Commodore-Amiga-> For the BEST damn personal computer money can buy!
  53.  
  54.  AND ANYONE ELSE I FORGOT TO MENTION, THANX!
  55.  
  56.  AND EVERYONE WHO'S SENT IN THEIR SHAREWARE REGISTRATIONS, THANX! THANX!
  57.  
  58. ---------------------------------------------------------------------------
  59.  
  60.                         Files in this archive
  61.                         ~~~~~~~~~~~~~~~~~~~~~
  62.      Name                                Function
  63.      ~~~~                                ~~~~~~~~
  64.    Access!                      This is the Terminal program: "Access!"
  65.    Access!.info                 Icon for...
  66.    Acc!.phone                   Sample phone-lib file for...
  67.    Acc!.color                   Sample color file for...
  68.    Acc!.def                     Sample define file for...
  69.    Acc!.keys                    Sample macro-key file for...
  70.    Access!me                    A doc file of questionable content and
  71.                                 quality. ( the file you are reading now )
  72.    Update.doc                   Information on the latest update
  73.    Script.doc                   Ducumentation on the new script language
  74.    Future.txt                   Ramblings about the future of Access!
  75.    rd                           Stand-alone file-reader called by Access!
  76.                                 (should go in your c: dir )
  77.  
  78. Disclaimer!:
  79. ~~~~~~~~~~~~
  80.       Please note that this program is still under developement and
  81.      therefore....
  82.  
  83.       This program comes with NO WARRANTY either expressed or implied and
  84.      I assume NO responsibility for any damage whatsoever, caused by the
  85.      use of it.
  86.  
  87.       Nuff Said, Now on to bussiness....
  88.  
  89. ---------------------------------------------------------------------------
  90.  
  91.                                 Access!
  92.                                 ~~~~~~~
  93.               A General Purpose, ANSI Telecommunications Program.  
  94.  
  95.   Feature Over-View:    ( '*' = new or modified this release )
  96.   ~~~~~~~~~~~~~~~~~~
  97. *  o Xmodem-CRC and Xmodem-Checksum protocols.
  98.    o Fast WXmodem transfer protocol.
  99. *  o Compuserve "Quick B" protocol. (a new, faster implementation of
  100.      CIS-B protocol) 
  101.    o Auto-Chop mode to strip xmodem padding from in-comming files (auto-
  102.      disabled for ".arc/.zoo/.pak" extended files)
  103.    o ASCII send and receive mode with user-selectable char. send delay and
  104.      next-line delay.
  105. *  o "Review Buffer" allows reviewing/saving a user-definable number of lines
  106.       that have already scrolled off the screen.
  107.    o "Capture Buffer" for saving in-comming text to file.
  108.    o "Print" feature for printing in-comming text.
  109.    o "Strip" feature for stripping in-comming blank lines.
  110. *  o "Loadable Fonts" seporate fonts for Transmit and Receive windows
  111. *  o "Read" feature for reading text files.
  112.    o "Chat Mode" with buffered input and line editing for tele-conferencing
  113.       and term-to-term use.
  114.    o "Split Screen" mode (half screen) for easy access to Amiga's multi-
  115.      tasking capabilities.
  116. *  o Flexable, informative "File Requester" for all file IO.
  117. *  o User-selectable 4, 8 or 16 color screen/windows.
  118.    o ANSI terminal emulation with full 8 color text support.
  119.    o "Color Palette" for user-selectable color maps with load and save
  120.      capabilities.
  121.    o "Macro Window" for the editing/loading/saving of 20 macro-keys.   
  122. *  o "Scripting" new to version 1.4 (see Script.doc for details)
  123. *  o "Phone Book" window for editing/adding/loading/saving phone books with
  124.      up to 60 numbers. (alternate service numbers available)
  125.    o "Auto-Dialer" to dial a number until connection is made.
  126. *  o "Multi-Dialing" round-robin dialing of selected numbers.
  127. *  o Serial parameters, color file and keymacro file loaded at dial-time for
  128.      each number. (new to version 1.4: Script execution on connect )
  129. *  o "Define Window" for editing/loading/saving default fileing and modem
  130.      preferences and other term defaults.
  131.    o Run-time "Interlace" ON/OFF toggle.
  132. *  o On-screen "Fast-Menus" for easy "access" (pun intended) to most
  133.      features.
  134.    o Two built-in Clocks for your time-keeping needs.
  135.    o And a Partri--dge in a pear treeeee...
  136.    o And anything else I can work in... stay tuned.....
  137.  
  138. ---------------------------------------------------------------------------
  139.  
  140. Minimum System Requirements:
  141. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  142.    Amiga: 500/1000/2000/3000  (3000?) with a MINIMUM of 512K.
  143.    Modem: 300/1200/2400/9600  (well, only if you want to call somewhere :-)
  144.  
  145. Suggested Configuration:
  146. ~~~~~~~~~~~~~~~~~~~~~~~~
  147.    Amiga (any of the above will do) with 1MEG. or more.
  148.    VD0:  (or similar recoverable ram disk) for fast downloading/uploading.
  149.    Hard Disk, 20meg or more is nice...
  150.  
  151.     Make a directory on your disk and put the term support files (.key/.phone/
  152.    .color/Access!) in it and cd to that directory before booting the term. 
  153.    (this will be your "System Directory", see "Usage" below)
  154.  
  155. ---------------------------------------------------------------------------
  156.  
  157.                                 Usage
  158.                                 ~~~~~
  159.       from the cli promt:
  160.  
  161.         1> access! [drive:path/myfile.def]
  162.  
  163.             where: "access!" is the name of the term.
  164.      and optional: "myfile.def" is the name of a configuration file.
  165.  
  166.    If no configuration file is given, it will look for "Acc!.def" in 
  167.   the current directory, if it's not found there, it will look in  your
  168.   "S:" directory. If THAT is not found, it will use built-in defaults.
  169.  
  170.       from the Worbench:
  171.  
  172.         Just click on the Icon!
  173.  
  174.    To set the ".def" file from WorkBench, type: DEFILE=myfile.def
  175.   (or a full path/filename of a valid configuration file) into the
  176.   'ToolTypes' string in the Icon (using the 'Info' command of WorkBench)
  177.  
  178.   Once the term is loaded, open the "Define" window and tell it where your
  179.   "System Directory" is and any other files you would like loaded at boot-
  180.   time, Fill in the "Modem Strings" with the proper settings for YOUR modem,
  181.   and then "Save" the information for future use. (you can choose which .def
  182.   file to load at run-time on the command-line or in the Icon, see above)
  183.  
  184. ---------------------------------------------------------------------------
  185.  
  186.                          Historically Speaking  
  187.                          ~~~~~~~~~~~~~~~~~~~~~
  188.  
  189.     Listed below are the relevant changes in this release ( 1.4 ) over the 
  190.    previous one ( 1.3a ).
  191.  
  192.  
  193. ( NOTE: due to the clutteredness (is that a word?) of this file and the 
  194.     amount of changes (and the amount of text describing said changes)
  195.     this portion of the documentation has been moved to a seporate file
  196.     "Update.doc". If you have been using Access! and are familier with
  197.     it's features, you may want to stop right here and go read _that_
  198.     file.
  199.      On a somewhat related note, I have _not_ taken the time to try and
  200.     patch this file ( "Access!me" ) back together to bring it up to date.
  201.      If you are trying Access! for the first time, I'll apologize right
  202.     here and now for the quality (and/or lack of information) in this
  203.     file. Hopefully you will be able to dig around in it and find answers
  204.     to most of your questions.
  205.      Completely re-writen documentation is in the works and I will post
  206.     it seporately as soon as it's finished. )
  207.  
  208.  
  209. ---------------------------------------------------------------------------
  210.  
  211.                      Individual Features Listed Below
  212.                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  213. ---------------------------------------------------------------------------
  214.  
  215. Review Buffer Operation:
  216. ~~~~~~~~~~~~~~~~~~~~~~~~
  217.  
  218.  o To open the review buffer, just press the <SHIFT> <HELP> keys.
  219.  
  220.  o To scroll-backwards, use the UP-Arrow key OR click anywhere on the top
  221.    half of the screen.
  222.  
  223.  o To scroll-forwards, (you guessed it) use the DOWN-Arrow key OR click 
  224.    anywhere on the bottom half of the screen.
  225.  
  226.  o To scroll-backwards 8 lines at a time, use the LEFT-Arrow key.
  227.  
  228.  o To scroll-forwards  8 lines at a time, use the RIGHT-Arrow key.
  229.  
  230.  o To close the review buffer window, use the <ESC> key, hit the 'close'
  231.    gadget or press the <HELP> key again.
  232.  
  233.  o To SAVE the review buffer to a named file, use L-Amiga 'w' (YES, I SAID
  234.    LEFT-AMIGA) from the main term window. (this may change when I decide
  235.    where to add a gadget/menu-item)
  236.  
  237.  o  You can select the number of lines saved (size of buffer) by an item in 
  238.    the DEFINE window labeled: "RBufLines:" (or something like that). Each line
  239.    takes up 24 bytes + 1 byte per char in that line, so assuming a 76 char 
  240.    line: 24 + 76 = 100 * number_of_lines = total_memory_cumsumed (of course a
  241.    line CAN be anywhere from 25 bytes to 104 bytes.)
  242.     If you change the number to LESS than you already had set, it will 'chop'
  243.    lines off of the top until it gets down to your specified size (this
  244.    is checked EVERY time a char is buffered) and frees up the memory that
  245.    was being used.
  246.     Making the buffer BIGGER than it is currently set, does just that and
  247.    does not effect any currently buffered text.   
  248.  
  249. ---------------------------------------------------------------------------
  250.  
  251. Chat Mode:
  252. ~~~~~~~~~~
  253.  o the lower window ( where you do all your typing) is now a FULL FLEDGED 
  254.    EDITOR ( well, a simple one anyway <grin> ).
  255.  
  256.  o also a "history" of the last 16 lines typed is available by using the 
  257.    up/down cursor keys.
  258.  
  259.  o you can cursor left/right, insert/delete and backspace to edit your text
  260.    (up to 127 (128?) chars) before sending it. ( this makes the "history"
  261.    mentioned above almost seem useful ).
  262.  
  263.  o <CTRL> <X> in chat mode will "kill" the current line.
  264.  
  265.  o <CTRL> <V> will "un-kill" the last line "killed" (it's kept in a buffer)
  266.    ( ctrl chars. other than these, are send directly to the modem and are
  267.      not buffered )
  268.  
  269.  o <SHIFT> <U/D-CURSOR> will now clear current line but not 'clip' it to the
  270.    kill buffer.
  271.  
  272.  o <ALT> <L/R-CURSOR> == back/forward one word.
  273.  
  274.  o <SHIFT> <L/R-CURSOR> == beginning/end of line.
  275.  
  276.  o Function keys are "sent right out" and the line you are working on will
  277.    be "refreshed". 
  278.  
  279.  o The "/Sen xx" gadget is for use in conference mode to "Send" private
  280.    messages to job # xx (can currently be used on GEnie and CIS).  Basically,
  281.    if it is enabled (click on "/Sen"), it will prefix your message with "/Sen"
  282.    and the job # that you provide in the string gadget so that you can carry
  283.    on a short private conversation without having to type it yourself every
  284.    time (click again to de-select it).
  285.  
  286. ---------------------------------------------------------------------------
  287.  
  288. Notes On CIS Quick-B Protocol:
  289. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  290. (NOTE: please see "Update.doc" for further details )
  291.  
  292.   o Access! supports "CIS Quick B" protocol. This is an improvement on the
  293.     earlier protocol in that it uses 1024 byte blocks (vs. 512) and has a
  294.     "send ahead" feature (it will send a second block without first waiting
  295.     for an ACK for the first one, overcoming some of the time delay involved
  296.     when using "packet switched" networks). This protocol does not show up
  297.     anywhere within the menus in the term because everything happens auto-
  298.     maticaly. 
  299.  
  300. NOTE: since Access! relies on certain "control chars" being sent to initiate
  301.       a "Compuserve Quick B" protocol transfer and since these chars can 
  302.       appear inadvertantly as "line noise" while on other systems and since
  303.       trying to download a file using "B" protocol on a system other than
  304.       Compuserve has only "ill" effects... I have implemented a "toggle" to
  305.       enable/disable "B" protocol. The default mode is: "enaabled".
  306.       You may toggle it on or off by holding down the <Left-Amiga> key and
  307.       hitting the <b> key. (a message will be printed to the screen)
  308.  
  309.       If the protocol is enabled, here is how to use it...
  310.  
  311.     1) Select "Compuserve B" when prompted for a protocol by CIS. (CIS will
  312.        know whether to use "Quick B" or regular "B" )
  313.  
  314.     2) When prompted for a file name for YOUR computer, type in the FULL path
  315.        name and file name for the file ( drive:dir/filename ).
  316.  
  317.     3) Sit back and wait for the transfer to finish.
  318.  
  319. ---------------------------------------------------------------------------
  320.  
  321. Notes On The File Reader:
  322. ~~~~~~~~~~~~~~~~~~~~~~~~~
  323. ( please see "Update.doc" for imformation on the file-reader )
  324.  
  325. ---------------------------------------------------------------------------
  326.  
  327. "Color" menu item:
  328. ~~~~~~~~~~~~~~~~~~
  329.  
  330.   o "Reset Text Colors"->
  331.  
  332.       Selecting this will reset both the foreground and background colors
  333.      (colors 1,0 respectively). This is usefull if you make a selection on
  334.      a "Color" BBS in the middle of a color change and you get a "bad" color
  335.      combination. (this ever happen to you?)
  336.        
  337.   o "ForeGround Text Color" -> 
  338.  
  339.      Here you can select the color for text in the "receive" window. This
  340.     color will stay the same until...
  341.     1:You select another color.
  342.     2:A BBS (or other terminal) sends an ANSI code that changes it.
  343.     (NOTE: in CHAT mode, the TOP (receive) window will use this color,but
  344.            the BOTTOM (transfer) window will be color #1.)
  345.           
  346.   o "BackGround Text Color" ->
  347.  
  348.      Same as above but for the text background color.
  349.     (NOTE: see note above) 
  350.  
  351.   o "Sample Text Colors" ->
  352.  
  353.      This option lets you test your foreground/background color selections
  354.     to see what works best...
  355.  
  356.     EXAMPLE: Select a foreground color, go to "Sample Text Colors", select
  357.             "Background Colors" and your selected foreground color will be
  358.             displayed on 8 different background colors. Now try the opposite
  359.             for background. (confused yet?)  
  360.  
  361.   o "Modify Palette" ->
  362.  
  363.      Yep, you guessed it, this will bring up a color palette for you to set
  364.     the colors YOU like. (the colors I like are already there).   
  365.            
  366.             1a) "OKAY"-> Selecting this gadget tells the system that the
  367.                 current/modified (or not modified) colors are the ones
  368.                 you would like to use.
  369.               
  370.             1b) "RESET"-> This gadget brings back the original "system" 
  371.                  colors (the ones I like :-). If you get things all messed
  372.                  up, you can always get back to where you started.
  373.  
  374.             1c) "CANCEL"-> This gadget tells the system that you changed 
  375.                 your mind and it will return you to the last colors that
  376.                 were "OKAYed". 
  377.                
  378.                 EXAMPLE: If you have modified the colors (and hit OKAY) 
  379.                          and then want the "default/system colors",
  380.                         1. Open the Palette.
  381.                         2. select "RESET"
  382.                         3. select "OKAY" (if you select "CANCEL" instead,
  383.                                           it will return to the last colors)
  384.         IMPORTANT!     
  385.         ~~~~~~~~~~
  386.               ONLY AFTER selecting your colors and CLOSING the palette, open 
  387.              up the file-requester and/or menus and check out the colors. 
  388.                 
  389.               Many of the colors are dependent on each other for the gadgets
  390.              and menus to look "esthetically" pleasing.(in my humble opinion
  391.              anyway :-) But if you find a combination that works well, SAVE
  392.              THEM for later use. 
  393.  
  394.             1d) "LOAD"-> 
  395.  
  396.                  This will load the colors in the given file name. (provided
  397.                 they were "saved" by "Access!")
  398.  
  399.             1e) "SAVE"-> 
  400.  
  401.                   The "save" option will save the currently selected color
  402.                  values to a text file with the given name. 
  403.  
  404. ---------------------------------------------------------------------------
  405.  
  406.  Macro Window: 
  407.  ~~~~~~~~~~~~~
  408. (NOTE: please see "Update.doc" for further details )
  409.  
  410.        Selecting this option (from the "Fast-Menu" or the regular menu) will
  411.       open up a "Macro Window" that will let you see/edit/load/save all
  412.       currently defined macro keys (F1-F10,<shift>F1-F10).
  413.  
  414. usage: When the window opens, you will see 10 funtion key definitions.
  415.       Hit the "arrow" gadget to toggle between shifted/non-shifted keys.
  416.  
  417.        To edit one, simply point to it and "click". It will then move down
  418.       to the editing line where you can make your changes. When your through,
  419.       be sure to hit <return> before moving on or your changes will be lost! 
  420.  
  421.        The new definitions will be in effect until you either quit the
  422.       program, change them again, load in new ones, or (heaven forbid) crash.
  423.       Select "Save" to save them to disk for future use.
  424.  
  425.        a) "OKAY"  -> when your done editing/loading/saving ect.. this will
  426.                      close the window.
  427.  
  428.        b) "SAVE"  -> brings up the "File Requester" window and saves macros
  429.                      to the name you supply.
  430.  
  431.        c) "LOAD"  -> opposite of "SAVE" (above)
  432.  
  433.        d) "CANCEL"-> currently acts the same as "OKAY" above (selceting this
  434.                      gadget COULD be used for "undoing" any current changes,
  435.                      but this would take a little more "overhead" and I left
  436.                      that option out for now...)
  437.  
  438.        e) " ^ "   -> (arrow) click on this to toggle between "shifted" and
  439.                      "non-shifted" funtion key definitions.
  440.  
  441.     There is a limited 'pseudo-script' type language accessable through the
  442.    macro-keys that will let you create simple auto-login proceedures and a 
  443.    few other things... 
  444.     The following commands are available, ALL of which use the '\' char. to 
  445.    tell Access! to treat the next x number of chars (depending on the command)
  446.    as either cntrl chars. or a command sequence...
  447.  
  448. NOTE: parameters surrounded by <> are _required_ , parameters surrounded 
  449.       by [] are _optional_ .
  450.  
  451.  \r
  452.     RETURN   
  453.  \n
  454.     RETURN
  455.  \t
  456.     TAB
  457.  \f
  458.     Form-Feed
  459.  \b
  460.     Back-Space
  461.  \B
  462.     Beep()
  463.  \D<x>
  464.     auto-D[ial] where 'x' is a number from 1-60 that corresponds to the
  465.     phone-book entries.
  466.  \d<x>
  467.     same as above, but without setting the auto-dial feature.
  468.  
  469.  \h   ( No Longer implemented )    
  470.  
  471.  \l
  472.     line break
  473.  
  474.  \L<p,c,k>["string"]
  475.     L[oad] the currently defined support file (phone, color, key) 
  476.     from the current "System Dir:". Or optionally load the specified
  477.     support file (p,c or k) with the name of "string" (use quotes) 
  478.     Examples:
  479.       \Lp                
  480.         loads the currently defined .phone file using the
  481.         currently defined "System Dir:"
  482.  
  483.       \Lc"df0:terms/my.colors"
  484.         loads the .color file-> df0:terms/my.colors 
  485.  
  486.  \m<x>
  487.   call another macro, where 'x' is the number of the macro from 1-20
  488.   Examples:
  489.     \m6
  490.       calls macro 'F6'
  491.     \m20
  492.       calls macro 'S10' (shifted F10)
  493.  
  494.  \P<"string">   ( No Longer implemented )
  495.  
  496.  \p<c>          ( No Longer implemented )
  497.  
  498. \V<d,p,w><x>
  499.   used to set 'delay' V[alues] (ranging from 0-255) for...
  500.   Eamples:
  501.     \Vd50
  502.       sets dial_delay value (time between dial attempts for auto-
  503.       dialing) to 50 'ticks' ( 1 second ).
  504.     \Vp20
  505.       sets pause_delay value (the time Access! will "pause for 
  506.       string" or "pause for char." ) to 20 _seconds_.
  507.     \Vw100
  508.       sets wait_delay value (the time to pause when using the \w
  509.       command listed below) to 100 'ticks' ( 2 seconds )
  510.     \Vt100
  511.       activates... nah... (sorry, just a bad joke :-)
  512.  
  513.  \w
  514.   wait for x amount of time in 'ticks' (time set by \V command above)
  515.  
  516.  \$<u,d,s>"dir"
  517.   change specified directory ( upload, download, system ) to "dir".
  518.   Examples:
  519.     \$u"vd0:"
  520.       changes the "Upload Dir:" to "vd0:"
  521.     \$s"df1:supportfiles"
  522.       changes the "System Dir:" to "df1:supportfiles"
  523.  
  524.  \\
  525.   just sends a '\' char.
  526.  
  527.  
  528. ---------------------------------------------------------------------------
  529.  
  530. Phone Book:
  531. ~~~~~~~~~~~
  532.   Although not yet in "finished" form, There is a "Phone Book" window. 
  533.   Usage is fairly straight-foward but I'll expand a little anyway... 
  534.  
  535.   When the "Phone Book" opens, you'll see 30 phone numbers list along with
  536.   some other gadgets/info...
  537.  
  538.      When you select a phone nuber entry, it stays highlighted. If you
  539.    click on a highlighted entry, the number will be immediately dialed. 
  540.    (this acts the *same* as clicking on a number, then clicking "OKAY!"
  541.     This makes it possible to "double-click" a number to dial it (although
  542.    the delay between clicks is not checked ).
  543.  
  544.  
  545.       1) "ADD"   -> Will allow you to add numbers (up to 60 total) to the
  546.                    "Phone Book".(see "NOTE" below for further info)
  547.  
  548.       2) "DELETE"-> Opposite of "ADD" (above). When you select this gadget,
  549.                     you will be prompted for an entry to DELETE. 
  550.  
  551.       3) "EDIT"  -> Will allow editing individual phone numbers without
  552.                    leaving the "Phone Book". (see "NOTE" below for further
  553.                    info)                       
  554.  
  555. (NOTE: While in the "Phone Book", if you select "ADD" or "EDIT", the gadget
  556.       will remain selected to remind you of what the "current" action is...
  557.       when you hit <return> on the string gadget (which you must do for the
  558.       change to take effect) the "current" action will be taken. (ie: if
  559.       "ADD" is selected, the number will be ADDed to the end of the list
  560.       (provided there is room) If "EDIT" is selected, the number will be
  561.       changed to the one in the string gadget.) If you change your mind,
  562.       selecting "ADD" or "EDIT" again will toggle them back off. (so does
  563.       "CANCEL")
  564.  
  565.    4) "LOAD"  -> Brings up the file requester for loading in new 
  566.                  "Phone Books" (up to 60 numbers and TWO alternate
  567.                  service numbers, if you have more than 60 numbers, use
  568.                  an editor to break them up into 60 number chunks)                    
  569.  
  570.    5) "SAVE"  -> When your through "editing/adding" phone numbers, SAVE
  571.                  them!
  572.  
  573.    6) " ^ "   -> (up arrow) This will shift the display between numbers
  574.                  1-30 and 31-60. (this variable is stored so that the next
  575.                  time you open the window, you will see the previously
  576.                  selected set of numbers)
  577.  
  578.    7) "CANCEL"-> This will close the window without dialing any number
  579.                  (possibly numberS in the future)
  580.  
  581.    8) "OKAY!" -> Dials Currently selected number(if any)(possibly numbers
  582.                  in the future) And begins the  "Auto-Redial"  process if
  583.                  selected. (see below for details) BTW, to select a number, 
  584.                  just click on it.
  585.  
  586.    9) "Alt-Serv #1" -> 
  587.                  Selecting this gadget will dial the specified alternate
  588.                  service number (in the string gadget to the right) and
  589.                  then dial the selected phone number.(if you don't know
  590.                  what this would be used for, then you probably don't
  591.                  need it :-)
  592.  
  593.    10) "Alt-Serv #2" -> 
  594.                  This is a SECOND alternate service number you may define.
  595.                  (works the same as above)
  596.  
  597. (NOTE: Currently EITHER or BOTH of the "Alt-Serv's" may be used with a
  598. number... in other words, if both are selected, "Alt-Serv #1" will be
  599. dialed FIRST then the "Alt-Serv #2" will be dialed, then (finally) the
  600. number. The alt-serv's can be up to 18 numbers each and the phone
  601. number can be up to 18 numbers... for a total of 54 numbers!
  602.  
  603.        This SHOULD be enough to reach any number you wish to dial. (along
  604.       with your account number if needed) (although there may be a 30-40
  605.       number limit on your modem...)
  606.  
  607.        These numbers are definable in the "string" gadget where they live,
  608.       and are saved/loaded along with the "Phone Book". (these are "toggle"
  609.       gadgets so you have to de-select them if your not using them.)  
  610.  
  611.    11) "Get Keys"-> 
  612.                   Selecting this (toggle) gadget tells the system to load
  613.                   the "keymacro" file with the same name as the currently
  614.                   selected phone number. The term will take the name of the
  615.                   selected phone number up until the first "space" in the
  616.                   name, then append ".keys" to it, the attempt to find/load
  617.                   a file of that name in the current "System" directory
  618.                   (the one that you keep all your "support" files in)
  619.  
  620.         EXAMPLE: If this gadget is selected and you select: 
  621.  
  622.                        Good BBS in Ca.   1-(123)-456-7890 
  623.                        |------Name------|-----Number-----...... 
  624.  
  625.                        to call...
  626.  
  627.                    Then it will take the name until it reaches a "space"
  628.                    i.e. "Good" then add ".keys" (Good.keys) and look for
  629.                    that file in the current "System" directory. 
  630.                    (selecting "Genie" would look for "Genie.keys" etc..)
  631.                      
  632.    12) "Get Colors"->
  633.                  As you might have guessed, this operates exactly as the
  634.                  above function does, but it looks for a ".color" file...
  635.  
  636.                         Using the same examples above, it would look for:
  637.                        "Good.color"
  638.                   and  "Genie.color"
  639.  
  640.  (NOTE!: You may edit the .key/.color file to be loaded by altering it in
  641.          the string gadget to the right before dialing.
  642.  
  643.    13) "Auto-Redial"->
  644.                  Selecting this gadget will cause the selected number to
  645.                  be dialed (and then re-dialed) until a connection is made.
  646.                  This process depends on and uses the  "result codes"  
  647.                  returned by your modem which you define in the "Define"
  648.                  window (part of the .def file loaded at boot time).
  649.                  If the result matches what you have defined as the "Busy"
  650.                  string or the "No Carrier" string, it will immediatly re-
  651.                  dial the number. If it matches the "Voice" result string,
  652.                  it will abort the process. If/when it finally matches one
  653.                  of the "Connect" strings, it will first reset the "Timer
  654.                  Clock" (in the Fast-Menu) to 00:00 and then BEEP and close
  655.                  the "Speed-Dialer" window. 
  656.                  There is (currently) no timer or limit on the number of
  657.                  "tries" that it will dial. It will dial indefinately until
  658.                  it either connects or you abort the process yourself.
  659.  
  660.  
  661.  Format for "Acc!.phone" files:
  662.  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  663.                                            Duplex      (F or H)
  664.                                           | Linelength (8 or 7) 
  665.                                           || Parity    (None,Even,Odd)
  666.                                           ||| StopBits (1 or 2)
  667.                                           ||||
  668.                                           |||| 
  669. |       17       |      17         |  5  |  4 |          26             |
  670. |--System Name---|--Phone Number---|-Baud|-Set|--------comment----------|
  671. AMIC          CA. 1-(707)-579-0523  2400  F8N1 F1,F2 any comment you want 
  672. Deep Thought  NC  1-(919)-471-6436  2400  F8N1 (S'ware Distillery) F1,F2 
  673. GENIE             1-      774-2427  1200  H8N1 F6   
  674. CAUG          OH  1-(216)-581-2284  2400  F8N1 nice board        F3,F4,F2
  675. Example of 18 numb123456789012345678
  676.                   |                 |
  677. Number starts HERE^                 Baud starts here!
  678.  
  679.  If needed you may actually use 18 chars. for the "phone number", and the
  680. '-', '('and ')' are optional. (to use 18 numbers they must be as shown in
  681. the last example shown above (spacing wise). 
  682.  
  683.  Duplex, Linelength, Parity, StopBits and Baud rate (format shown above) are
  684. automatically set when a number is dialed! (unless the "Set" field is empty)
  685. (also, use CAPITAL letters in the "Set" field ) 
  686.  
  687. ---------------------------------------------------------------------------
  688.  
  689.  "DEFINE" Window:
  690.  ~~~~~~~~~~~~~~~~ 
  691. (NOTE: please see "Update.doc" for further details )
  692.  
  693.    This window is used to set up, load and save ".def" files (configuration
  694.    files) used by Access! 
  695.  
  696.    You can specify the ".def" file to be loaded at boot-up via the Icon or
  697.    the command-line (see Usage and Suggested configuration above). 
  698.  
  699.    There is a sample definition file "Acc!.def" included in the arc, it
  700.    will get you loaded and running the first time then you should open the
  701.    "Define Access!..." window, fix it the way you want it, then SAVE it for
  702.    future use. (you might set up different ones with different color files,
  703.    .key files, phone books, etc... and then just specify the setup you want
  704.    when you run the program ie. 1> Access! grey.def    might load in a 
  705.    configuration setup to be used in interlace...)
  706.  
  707.    o Priority: This one is of (very) limited use but it IS set when "OKAY" 
  708.      is selected so if you do not know why you would use it, please just 
  709.      leave it set to "0". (ok?) You may set it from -1 to 4.
  710.    o Interlace: Sets interlace on/off. (See: NOTE BELOW!)
  711.    o Borders: Sets borders on/off.      
  712.    o TitleBar: Sets titlebar on/off.
  713.    o # Of Colors: Sets between 4/8/16 colors. (See: NOTE BELOW!)
  714.    o Shadow Pen: The pen number (0-15) used for text "shadows" in the 
  715.      support windows.(this is set/changed every time you click on it.)
  716.    o RBufLines: This value will increment by 50 each time you click on it
  717.      and is used to define the number of lines the "Review Buffer" will
  718.      save/store
  719.      ( and thus how much memory you allow it to use ).
  720.  
  721. (NOTE BELOW!: If you make any changes that require more memory than you 
  722.               have available (in particular INTERLACE) the program may 
  723.               "exit" when it can't re-open the screen/windows. (rude,
  724.               I know, I'll work on a freindlier handler of such cases...)
  725.  
  726.  The following items are also saved/loaded in the .def file allow they are
  727.  not listed anywhere on this window. ( ie. the "current" state of each at
  728.  the time that you save a .def file. )
  729.  
  730.    o CHAT mode on/off.
  731.    o SPLIT screen mode on/off.
  732.    o STRIP mode on/off. (stripping in-comming blank lines)
  733.    o Currently selected Foreground pen number.
  734.    o Currently selected Background pen number.
  735.    o Current positions of each of the "Fast-Menu" bars.
  736.  
  737. ---
  738. THE first three items listed in the bottom part of this section are NOT set 
  739. when OKAY is selected. ( ie. if you type "fred.colors" in the "Color File"
  740. string, it will NOT load that color file in when you hit OKAY to close this
  741. window, you would need to do that from the Color Palette window.)
  742. --- 
  743.  
  744.  Filing Preferences:
  745.  
  746.    o "Phone Book"-> defines the "phone.file" to be loaded. (name only, no
  747.                     dir/path)
  748.    o "Key File"  -> defines the "key.file"...
  749.    o "Color File"-> defines the "color.file"...
  750.    o "Upload Dir"-> defines default dir/path for uploads. 
  751.    o "Dnload Dir"-> defines default dir/path for downloads. 
  752.    o "System Dir"-> defines dir/path to search for support files.(.phone,
  753.                      .key, .color etc...)
  754.    o "Def.Capture"-> defines drive:path/name used for "captured" file when
  755.                       L-amiga 'c' is pressed.
  756.    o "User Dir #1"-> defines dir/path used in the first user-selectable
  757.                      string gadget in the file requester.
  758.    o "User Dir #2"-> defines dir/path used in the second...
  759.  
  760.  Modem Defaults:
  761.  
  762.     o "Set-up String"-> defines the string sent out to initialize the modem. 
  763.     o "Dial Prefix"  -> defines string sent to modem prior to dialing.
  764.                          (ATDT for hayes compatibles)
  765.     o "Dial Suffix"  -> defines string sent to modem after dialing.
  766.                          ( <return>... ^M )
  767.     o "Hangup String"-> string sent to modem to hang-up. (this one may be
  768.                          deleted in a future version when I'll just drop
  769.                          carrier to hang-up)
  770.  
  771. (NOTE: the strings below MUST be set properly for YOUR modem for the "Auto-
  772.        dial" feature to work correctly)
  773.  
  774.     o "1200 Connect"->  string RETURNED by modem when you get connected at
  775.                          1200 BAUD. 
  776.     o "2400 Connect"->  string RETURNED by modem for 2400 BAUD.
  777.     o "No Connect #1"-> string returned by modem when... "NO CARRIER"
  778.     o "No Connect #2"-> string returned by modem when... "BUSY" 
  779.     o "No Connect #3"-> string returned by modem when... "VOICE"
  780.  
  781. ---------------------------------------------------------------------------
  782.  
  783.  Notes on File Requester:
  784.  ~~~~~~~~~~~~~~~~~~~~~~~~
  785.  
  786.      You might notice that two of the "disk" gadgets in the "File Requester"
  787.     look a little odd... 
  788.        
  789.      While contemplating how to make the "File Requester" fit YOUR set-up,
  790.     I came accross this idea. 
  791.  
  792.      I assume EVERYONE has "RAM:" (at least SOME ram)
  793.      MOST people have      "VD0:" (if you don't, you should.)
  794.      EVERYONE has          "DF0:" (it's the one connected to your AMY!)
  795.      ALOT of people have   "DF1:" (ok, so SOME people don't...)
  796.  
  797.      And that takes care of 4 out of 6 "disk gadgets" so the other two are
  798.     free for you to specify as you please. (drive, path, ect... up to 50
  799.     chars. (I think it's 50)) This way you don't have to do alot of
  800.     "assigning" if you use deeply inbedded "paths" for dl/ul's!
  801.  
  802.     These are two of the defaults that are defined in the "Acc!.def" file
  803.    that is loaded in at boot-up.
  804.             
  805.    "Bytes Free" displays the totals available bytes free on the currently
  806.     selected drive.
  807.  
  808.    Up/Down arrows on this window/requester/whatever allow you to scroll 
  809.    forward/backward/sideways (sideways?) through the file listing. 
  810.  
  811.    If you are running low on mem and the regular File-Requester window can 
  812.    not open, then a small "Input Window" will open (with just one string 
  813.    gadget) to accept the drive:path/filename you provide.
  814.  
  815. ---------------------------------------------------------------------------
  816.  
  817. "Clocks":
  818. ~~~~~~~~~
  819.   There are two clocks in the term... (batteries not included)
  820.  
  821.   One of them lives in one of the "Fast-Menus" (gadget bars) and is a simple
  822.  "counter/timer" for keeping track of online/session time. This timer starts
  823.  up when the term boots and is reset when a connection to a BBS is made 
  824.  using the "Auto-Dialer" or at any time by clicking on it.
  825.  
  826.   It is updated once a minute and is fairly accurate although (depending on
  827.  when it gets reset) it may display negative numbers (grin). This has to do 
  828.  with crossing a 12 hr. "time-zone" so if it does, just reset the thing.
  829.  ( I've got a watchsmith coming by to look at it, so maybe it'll be fixed by 
  830.  the next version :-)
  831.  
  832.   The other (simple) clock lives in the "INFO" window (accessed through the 
  833.  normal menus or by hitting the <help> key). This clock just displays the 
  834.  current "system time" in hrs./mins. and is also updated once a  minute (the
  835.  most this one SHOULD be off is one minute (depending on how close to the 
  836.  minute it is when you reset the "counter" clock mentioned above)). There
  837.  is currntly no way to set the system time from within the term so you must
  838.  do that by some other means if you want this clock to be correct.
  839.  
  840. ---------------------------------------------------------------------------
  841.  
  842.  FAST MENUS:
  843.  ~~~~~~~~~~~
  844. (NOTE: please see "Update.doc" for further details )
  845.  
  846.    Most of these are self explanitory(sp) and are just short-cuts to the
  847.   "normal" menu-items. There are a few that need further explanation...
  848.  
  849. (NOTE:these may change from time to time and all of them may not be listed 
  850.   below...)
  851.  
  852.  (not neccessarily in any particular order )
  853.  
  854.   o "QUIT"  ->  hmmmmmm.....
  855.   o "READ"  ->  To read a disk (or ram:) based ASCII text file.
  856.   o "CAPT"  ->  Starts ASCII Capture (with file name)
  857.   o "XUP"   ->    "    XModem (or WXModem) send
  858.   o "XDOWN" ->    "    XModem download
  859.   o "WXDOWN"->    "   WXModem download  
  860.   o "CHAT"  ->  Chat Mode 
  861.   o "COLOR" ->  Brings up the Color Palette
  862.   o "NEWCLI"->  Starts a NewCli (flip back to WBench to find it)
  863.   o "MACROS"->  Opens "Macro Window" 
  864.   o " ^ "   ->
  865.  
  866.      (Up Arrow) This gadget will send the "FAST MENU" to the top of the
  867.     screen (and back again)(NOTE: if your cursor is at the top of the screen
  868.     when you send the menu bar up there, it will "hide" the cursor. (if for
  869.     some reason you can't find the cursor, move the fast menu and it will
  870.     probably be there.) If you select "CHAT" AFTER the menu is at the top,
  871.     the cursor will move down for you. (NOTE:  this gadget works the same
  872.     for both "FAST MENUS") 
  873.  
  874.        //  
  875.   o "\X/ "  ->
  876.  
  877.      (check mark) This gadget is essentually a "Back Gadget". Use it to
  878.     reposition the "Fast-Menus" and the "Status Line" to your preferences.
  879.  
  880.   o "ASEND"  -> Starts ASCII "Send" mode (same as normal menu selection).
  881.                 (see: "Other" below)     
  882.   o "HANGUP" -> Sends out "hang-up" string to modem. 
  883.   o "DIAL"   -> Opens "Phone Book" window.                        
  884.   o "REDIAL" -> Simply "re-dials" last number dialed...
  885.                         (NOTE:  if the "auto-redial" feature is currently
  886.                                 selected, then this gadget will restart the
  887.                                 "auto-redial" process, otherwise the current
  888.                                 number is simply redialed.)
  889.  
  890.   o "00:00"  -> (or "01:30","12:00","04:15"... you get the picture) It's a 
  891.                 Clock. (see: "Clocks" above for details)
  892.  
  893.   o "BORDRS" -> (short for "BORDERS")
  894.  
  895.      This option will enable/disable the main window borders to give you a
  896.     full 80 col. screen vs a 79 col. screen. This will also give you a extra
  897.     line of text in the "transmit" (bottom) window in "CHAT" mode. (3 lines
  898.     vs. 2.5 with the borders on)
  899.                     
  900.   o "SPLIT"  ->  ( activated ONLY in interlace mode )                  
  901.  
  902.      Selecting "SPLIT" (currently not a normal menu item) will give you a
  903.     TRUE split screen!, which means no more swapping back and forth to the
  904.     WorkBench screen to see how your "unarcing" is coming along (know of a
  905.     good, small "DirUtil"? like one that takes up half of a screen... ? )
  906.   
  907.      What it actually does is shrink the term down to normal, non-interlaced
  908.     size (640*200) and moves the screen half-way down. Thus giving you a 23
  909.     line (interlaced) terminal on the bottom of the screen w/out losing any
  910.     of the normal terminal display area ( of course you dont get as many
  911.     lines as a "full/sized/interlace/display" but you can swap back and
  912.     forth as you like!)
  913.                    
  914.      Seleting "SPLIT" again returns you to a Full/Sized/Interlace screen
  915.     again (it's a toggle switch).
  916.                        
  917. (NOTE: this option works very well when used with the "NEWCLI" option above
  918.       or with a "half-screen DirUtil" if there's one around or better yet,
  919.       with WBench set to interlace also.
  920.  
  921.   o "LACE" ->  
  922.      
  923.      This option will toggle you between "Interlace" and  "Non-Interlace"
  924.     modes. (or cause the program to exit if you don't have enough memory
  925.     for interlace)
  926.  
  927.      I have played with this EXTENSIVELY and it seems to work fine. (let me
  928.     know if it doesn't for you, along with what you system set-up is, BUT
  929.     BEFORE YOU DO THAT, see the paragraph below about memory)                  
  930.  
  931.   AGAIN, if you don't have enough memory for "INTERLACE" in the first place,
  932.          chances are the program will EXIT!
  933.  
  934.   You might also avoid clicking on this (or ANY other) gadget while either
  935.  the "File Requester", "File Reader Window" or "Palette Window" is open. 
  936.  (all other windows should be ok)
  937.  
  938. ---------------------------------------------------------------------------
  939.  
  940. Other:
  941. ~~~~~~
  942.   o Checks for ".arc/.ARC/.zoo/.ZOO/.pak/.PAK" extensions and disables
  943.     "auto-chop" feature for these files.    
  944.    
  945. ---------------------------------------------------------------------------
  946.  
  947. Known Bugs:
  948. ~~~~~~~~~~~
  949.   o You CAN open every window/requester at the same time...
  950.     This is NOT good and SHOULD be AVOIDED! (or you might see a number to 
  951.     meditate over :-)(although if you close them back down in the right
  952.     order, it should be OK, as long as you don't fiddle with a bunch of
  953.     gadgets while they're open)
  954.  
  955.   o  This program is being developed on an "Amiga 1000" w/68010,a "Starboard
  956.     II" 2 meg. expansion, "Signalman Lightning 2400 Baud Modem" among other 
  957.     things... I try to test it with various configurations before releasing
  958.     a version (Amiga 1000 w/512K, and Amiga 500 w/1meg.) but am not always
  959.     able to do so.
  960.  
  961. ---------------------------------------------------------------------------
  962.  
  963.  So far, things seem to be going pretty well (knock on wood). 
  964.  
  965.  The main problem USUALLY ALWAYS has to do with a lack of memory...
  966.  
  967.  Using an 8/16 color CUSTOM screen with a dozen or so support windows, 
  968. thirty or so multi-color gagdets, two fully functional console.devices
  969. along with the code to implement all this and multiple protocols 
  970. ( with more on the way :-), makes this a fairly ambitious program
  971.  memory-wise so.....
  972.  
  973. If a window "just doesn't open" when you expect it to, CHANCES ARE, 
  974. you do not have enough memory for the window to open!
  975.  
  976. i.e. If you see a message in the main terminal window the says something 
  977.     like... "Can't open such-in-such Window" then it's a MEMORY (or lack
  978.     there of) problem!
  979.  
  980.  The term SHOULD still work on a 512K machine, but you may have to make some 
  981. sacrafices to do so (like multi-tasking). 
  982.  
  983.  If you do have other problems to report, PLEASE list the VERSION NUMBER
  984. along with the report! This will help me track down the problem or let me
  985. know if it's already been fixed. 
  986.  
  987.  I try to respond to most/all reports/suggestions/comments but am not always
  988. able to do so.  
  989.  
  990. -Keith-
  991.  
  992. ----------------------------------------------------------------------------
  993.  
  994. The Plea: 
  995. ~~~~~~~~~
  996.   Again, Access! IS being distributed as ShareWare so if you continue to use
  997.  it after some trial period, please help in the fight against high-priced
  998.  software and support ShareWare authors by sending in your registration.
  999.  
  1000.  Suggested contribution is $25.00 (please read "Future.txt" for futher
  1001.  details)
  1002.  
  1003.  
  1004. (note new address)
  1005.  
  1006. Snail Mail: Keith Young 
  1007.             RT. 2  BOX 261
  1008.             Goodview, VA.
  1009.                    24095
  1010.  
  1011.  Please send all BUG REPORTS, KUDOS, HELP, SUGGESTIONS, INSULTS to...
  1012.  
  1013.      GEnie:  K.Young  (special support section available for registered 
  1014.                       users)
  1015.        or
  1016. Compuserve: 73170,307 (stop by the AmigaTECH conference most nights)
  1017.  
  1018. __________________________________EOF________________________________________
  1019.