home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 038.lha / AMIC / AMIC.New < prev    next >
Text File  |  1987-05-16  |  22KB  |  469 lines
  1. =====================================================================
  2.               AMIC Development
  3.               AMIC PD Term
  4.  
  5.               By: David Salas
  6.                   Some optimization by Albert Kirk.
  7. =====================================================================
  8. Version: Release beta .40
  9. Date   : May 29, 1987
  10. Time   : 02:20:00
  11. Status : RELEASE GRANTED FOR ALL USERS, ALL BBS's
  12. =====================================================================
  13.                           *** NOTE ***
  14.  
  15. AMIC PD TERM was  originally made from Dan James (DJJ) source to COMM
  16. version 1.34, but has evolutionized im the last couple weeks into its
  17. very own environment. I was actually going to adopt the name of COMM
  18. version 2.0, but on requests of DJJ I have adopted this new name. But
  19. Dan sure deserves some credit on it, even if the program doesn't look
  20. too similar at all.  Most of the I/O  and Transfer  protocol routines
  21. are intact,  with few changes,  this will ultimately  change,  HAS to
  22. change to accomodate our MultiTalk protocol,  and it will improve I/O
  23. speed greately by using assembly made routines. Thanks and ENJOY this
  24. BETA version of AMIC PD TERM,  this BETA status implies that the pro-
  25. gram might have some bugs here and there,  and that some of the items
  26. available are  not actually implemented. Just be patient,  I DO *NOT*
  27. intent to release EVERY single update to the public domain, by perio-
  28. dically,  as I have been doing for about a month since I started with
  29. it.  There are about  40 testers of it,  so I think that is enough to
  30. get enough feedback on problems with the program.  I would appreciate
  31. your feedback,  but if I don't reply  at all is because that has been
  32. taken care already  on new releases to selected  testers (mostly from
  33. AMIC).
  34.  
  35. SYSOPS: Do *NOT* delete COMM 1.34 from your  libraries,  AMIC PD TERM
  36.         is NOT considered a newer  version of this program,  nor want
  37.         to takeover the great work that DJJ has put into the original
  38.         version of COMM.
  39. ---------------------------------------------------------------------
  40.                    ** DISTRIBUTION AND COPYRIGHT **
  41. ---------------------------------------------------------------------
  42. This program is placed in the public domain as SHAREWARE. If you find
  43. this program useful, a  $20.00 registration fee will be really appre-
  44. ciated, and will help us to keep mantaining and enhancing the program
  45. on a regular basis.  At this point of time I won't  release the souce
  46. code, in first place because  I don't feel confortable releasing code
  47. that is not being 100% debugged, secondly,  I would rather wait until
  48. the full implementation of the  program has been completed. By then I
  49. will make the source code available one way or another.
  50.  
  51. Send your registration fee to:
  52.  
  53. David Salas or Albert Kirk
  54. AMIC Development
  55. 2400 Mc Bride Lance, Suite 49
  56. Santa Rosa, CA 95401-2731
  57. ---------------------------------------------------------------------
  58.         System Requirements, suggestions
  59. ---------------------------------------------------------------------
  60. MINIMUM Configurations: - Amiga 1000/500/2000 w/512K of memory
  61.                         - One 3.5 floppy drive
  62.                         - Amiga Monitor
  63.                         - Kickstart/Workbench 1.2
  64.                           I HAVE *NOT* test it with Kickstart 1.1, so
  65.                           I don't have  any idea if it  works or not,
  66.                           but one thing is for sure, I AM NOT contem-
  67.                           plating such compatibility as an issue.
  68.  
  69. SUGGESTED Configuration:Extra 512K or more of memory.
  70.             Second Floppy Drive or Hard Disk
  71.             Printer
  72. =====================================================================
  73.                   Features of the NEW AMIC PD Term
  74. ---------------------------------------------------------------------
  75.                        BETA RELEASE .40 NEWS
  76.            *** FIRST RELEASE TO THE GENERAL PUBLIC ***
  77. ---------------------------------------------------------------------
  78. DIAL REQUESTER: Speed has been improved,  making it  about 30% faster
  79.           than on version .39.. Don't worry,  it will be very fast in
  80.           future versions. But it ain't THAT slow, is it?
  81.  
  82. MENU PROJECT:
  83.    o ABOUT does now call the STATUS window, which is also callable by
  84.      pressing the HELP key.
  85.  
  86. MENU SETUP:
  87.    o AUDIBLE BEEP: Allows you to select between and AUDIBLE  beep and
  88.      a screen beep (DisplayBeep()). If AUDIBLE the MenuItem is Check-
  89.      marked. This flag is configurable from the .Config file, see be-
  90.      low.
  91.    o AUDIBLE BELL: Allows you to set for Audible or Screen beep. Read
  92.      below for more information.
  93.  
  94.    o BORDER: It now works correctly on SPLIT WINDOWS.
  95.  
  96. CONFIG FILE: Two new command additions to it:
  97.  
  98.    o BELL [ON/OFF]: Select between  Bell being Audible or not.  ON is
  99.                     Audible, OFF is DisplayBeep();
  100.  
  101.    o BORDER [ON/OFF]: Allows you to  preselect the type of Window you
  102.                     want the program to come with.  ON means the win-
  103.                     dow has borders.  OFF means the window  does come
  104.                     without  any borders. This  is true  for the  I/O
  105.                     window only,  *NOT* for any other  windows in the
  106.                     system.
  107.  
  108. Minor  requesters have  been improved in the way they look, including
  109. the STATUS requester. No big deal.
  110. ---------------------------------------------------------------------
  111.                       BETA RELEASE .39 NEWS
  112. ---------------------------------------------------------------------
  113. MENU DIAL:
  114.    o DIAL: COMPLETELY different  from the  original  Comm or previous
  115.            versions of  AMIC PD Term.  It now has a window requester,
  116.            which  has a capacity  to hold upto  200 phone  entries at
  117.            the  same time.... From there you can also flag for REDIAL
  118.            and  ALTERNATE SERVICE.  At this  point you  can't  change
  119.            phone directory from the file string gadget,  use the  GET
  120.            PHONE (Amiga G) to load a new phone directory.
  121.            Plans are to support an unlimited amount of phone entries,
  122.            but I am not really sure if I want to implement it here on
  123.            AMIC PD Term.... I feel that 200 entries is enough for 99%
  124.            of the users!
  125.  
  126. GET FILE REQUESTER: Improved  and optimized  for faster speeds, it is
  127.            about 3 times  faster than it was before scrolling data on
  128.            on it.
  129.            This  requester also  has been adopted  for LOADING/SAVING
  130.            Phone Libraries and Macro Key files.
  131.  
  132. Some bugs are  fixed now,  and the program is faster than on beta .38
  133. in I/O. Here are some of those I remember beforehand! :-)
  134.  
  135.    o The  BORDERLESS window  now does not  overwrite the CLOSE WINDOW
  136.      gadget
  137.  
  138.    o AMIGA Y does now serve as a shortcut for SEND BREAK.
  139.  
  140. ---------------------------------------------------------------------
  141.                        ORIGINAL DOCUMENTATION
  142. ---------------------------------------------------------------------
  143.                             *** USAGE ***
  144.  
  145. AMIC {[Configfile]}
  146.  
  147. Configfile is OPTIONAL, is NONE is issued, the  program will look for
  148. AMIC.Condfig in the CURRENT directory, if no luck (can't find it), it
  149. will look in the S: directory,  if still no luck,  it will use a hard
  150. coded configuration.
  151. ---------------------------------------------------------------------
  152. I will go  directly into  explaining  the features of the  program by
  153. describing  the menus on  the program,  which reach about all the pos-
  154. sibilities of the program:
  155.  
  156. PROJECT MENU:
  157.    o ABOUT: NOT implemented right now.
  158.  
  159.    o SIDEBAR: Toggles the SideBar.  It actually is  moving it  to the
  160.               background if it is in the foreground, and viceversa.
  161.               This function is called when the BACK gadget is clicked
  162.               on the SideBar window.
  163.  
  164.    o START BUFFER: NOT Implemented: This feature will allow you to
  165.               open and close the program buffer. Different to CAPTURE
  166.               indeed, it will have an user definable buffer that resi-
  167.               des in the system at all time (when toggled), which the
  168.               user can review entirely with the VIEW Buffer function,
  169.               or scrolling back using the ARROW keys.
  170.  
  171.    o VIEW BUFFER: Allows  you to review the  buffer in an editor type
  172.               of environment. NOT IMPLEMENTED.
  173.  
  174.    o PRINT BUFFER: If the PRINTER  was NOT on, and you want to have a
  175.               hardcopy of the present  information in the buffer, se-
  176.               lect this item.. NOT IMPLEMENTED.
  177.  
  178.    o PRINTER ON: Toggles and  untoggles the printer.  If it is in the
  179.               ON (Checkmarked) it  will turn the printer  off and un-
  180.               check the item.. and viceversa.
  181.               NOTE: This process is  called when the  PRINT Gadget is
  182.               selected from the SideBar.
  183.  
  184.    o LOAD CONFIG: NOT IMPLEMENTED: Allows  you to load a  Config file
  185.               and  reconfigure the  terminal program  entirely.  NOTE
  186.               that you will need to be OFF line to  execute this pro-
  187.               gram, otherwise  you will loose the carrier in the pro-
  188.               cess (NOT FATAL ERROR).
  189.  
  190.    o EXEC SCRIPT: NOT IMPLEMENTED: Allows the  user to load a  script
  191.               file and start the execution of it. The SCRIPT language
  192.               hasn't been established entirely at this time, but will
  193.               have functions  for full remote  operation of BBS's and
  194.               Network systems for downloading of files, execution can
  195.               capture of text files, message bases, etc..... Also the
  196.               ability to put the system  to sleep  until a determined
  197.               time, on which it will start to execute the script file.
  198.  
  199.    o QUIT AMIC PD: Allows  you to quite  the program,  after  closing
  200.               buffers, capture files,  and all the ports & windows of
  201.               the system. It also makes the similar of the SWEEP pro-
  202.               gram to ensure that data is not layed around. That also
  203.               forces the serial.device to be unloaded of the system.
  204.               NOTE: This process is called when the QUIT gadget is se-
  205.               lected from the SideBar.
  206.  
  207. ---------------------------------------------------------------------
  208.  
  209. SETUP MENU:
  210.    o BAUD RATE: Simple enough. Allows the user to  set the Baud Rate.
  211.               The default  Baud rate can be defined  by the user from
  212.               the Config file,  if none is defined, it  will use 1200
  213.               Baud as the default.
  214.  
  215.    o PARITY:  Allows you to set the PARITY check of the communication
  216.               session to ODD, EVEN or NONE.
  217.  
  218.    o DATA LENGTH: Allows you to set the data length to 7 or 8 bits.
  219.  
  220.    o STOP BITS: Allows you to set the stop bits to  either 1 or 2, if
  221.               possible (ie: 2 stop bits are  not possible if the data
  222.               length is set to 8 bits.
  223.  
  224.    o DUPLEX:  Allows you to set the duplex to FULL or HALF duplex.
  225.  
  226.    o CR's, LF's: Allows you to Toggle or Untoggle Linefeeds for Inco-
  227.               mig or outcoming data.
  228.  
  229.    o XON/XOFF: Toggles Handshaking to none or automatic.
  230.  
  231.    o SEND BREAK: Sends a break to the host.
  232.  
  233.    o SPLIT WINDOW: Will split windows for CHAT mode, with one to show
  234.               the receiving data,and the other to contain your input.
  235.               VERY handy for network chatting.
  236.  
  237.    o BORDERS: Allows you to set or unset borders for the Input window
  238.  
  239.    o INTERLACE: NOT IMPLEMENTED:Allows you to change to INTERLACE and
  240.               NON INTERLACE screens on the fly.
  241.  
  242.    o COLUMNS: NOT IMPLEMENTED: Allows you  to change  fonts,  from 80
  243.               columns to 128 (upto over 132 in overscan mode) cols,or
  244.               viceversa.
  245.  
  246.    o COLORS:  Brings up the  COLOR requester, on which you can CHANGE
  247.               the current colors,  LOAD an already  saved color file,
  248.               or SAVE your current palette into a file for future use
  249.               The FILE requester *IS* case sensitve, and it'll search
  250.               for files with the extension "Color".
  251.               NOTE: This  process is called  when the COLOR gadget is
  252.                     selected from the SideBar.
  253. ---------------------------------------------------------------------
  254.  
  255. TRANSFER MENU:
  256.    o START ASCII CAPTURE: Allows you  to open a file on which to cap-
  257.               ture the  I/O  from the terminal  for later  review (or
  258.               whatever). Once on capture, this item  changes to CLOSE
  259.               CAPTURE file, which closes the file when selected.
  260.               NOTE: This process is called  from the SideBar when the
  261.                     CPTURE gadget is selected.
  262.  
  263.    o START ASCII SEND: Allows you to  send an ASCII  file to the host
  264.               system. It  will add the  Linefeeds to the file if it's
  265.               toggled in CR's/LF's (See Setup).
  266.               NOTE: This process is called if the ASEND gadget is se-
  267.                     lected from the SideBar.
  268.  
  269.    o BINARY RECEIVE: Allows you to start a Binary file Receive, which
  270.               will be  requested with  the protocol selected with the
  271.               SET PROTOCOL (see below).  If such protocol is not sup-
  272.               supported by the host, the terminal will drop to Xmodem
  273.               NOTE: This  process is called  if the  BDOWN gadget is
  274.                     selected from the SideBar.
  275.  
  276.    o BINARY SEND: Allows you to start a  Binary file Send, which will
  277.               be transfered using the selected protocol on SET PROTO-
  278.               COL (see below). If the host does not support such pro-
  279.               tocol, the program will drop down to Xmodem protocol.
  280.               NOTE: This process is called if the <BUP> gadget is se-
  281.                     lected from the SideBar.
  282.  
  283.    o SET PROTOCOL: Allows you to set the protocol of your preference,
  284.               note that Xmodem, Xmodem Ascii and WXmodem are the only
  285.               ones supported  at the present time.  MultiTalk  may or
  286.               may not be supported in  the future,  it all depends on
  287.               the progress of GraphTerm.  The default protocol can be
  288.               set from the AMIC.Config file(see below for more info),
  289.               if none is set, the terminal defaults to Xmodem.
  290.  
  291.    o PROTOCOL MODE: Allows you to select between Checksum or CRC cor-
  292.               rection mode.
  293.  
  294.    o AUTOCHOP: Checkmarked if toggled, unchecked if not... Also it is
  295.               ignored if the extension  given to the file to transfer
  296.               has the .ARC or .ZOO extension.
  297.  
  298.    o VIEW TRANSFERS: Use only to view transfers that contain readable
  299.               ASCII information, otherwise you'll get  unpredicatable
  300.               information on the window.
  301.  
  302. ---------------------------------------------------------------------
  303.  
  304. PHONE MENU:
  305.  
  306.    o DIAL:    Read UPDATED information for more.
  307.               NOTE: This  process is called  when the DIAL  gadget is
  308.                     selected from the SideBar.
  309.  
  310.    o HANGUP:  Sends a HANGUP command to your modem.
  311.  
  312.    o AUTOREDIAL: Toggles/Untoggles the Autodial flag.  If checkmarked
  313.               the program will redial the  selected phone entry until
  314.               connection is made, or until the user aborts the opera-
  315.               tion.  This are  the different things  you can do while
  316.               autodialing.. At this point the only GADGET you can se-
  317.               lect and make it to respond is the SCREEN Gadget in the
  318.               sidebar, which will bring the Back screen to the front,
  319.               placing the terminal screen in the background.
  320.               The following a KEY commands:
  321.               ESC Key: ABORTS the Autoredial process.
  322.               TAB Key: SKIPS the actual loop, forcing a new dial,this
  323.                        is VERY useful if  you are around and can hear
  324.                        the BUSY beep,  so  you are  sure it won't  go
  325.                        through, thus forcing a  new redial before the
  326.                        whole time loop is done.
  327.               UP ARROW: INCREASES the amount of time for each dial.
  328.               DOWN ARROW: DECREASE the time for each dial loop.
  329.  
  330.               NOTE: If you  are working on another screen at the time
  331.                     of the connection using  Autoredial, the Terminal
  332.                     screen will pop up automatically. Many  love this
  333.                     feature (per feedback),but others may not, let me
  334.                     know!
  335.  
  336.    o ALT SERVICE: Toggles or Untoggles the ALTERNATE SERVICE flag. If
  337.               set  the system  will add the  alternate number to your
  338.               entry everytime it dials.
  339.  
  340.    o LOAD PHONE: Allows you to load a new phonedirectory.
  341.  
  342.    o MACRO KEYS: Allows you to LOAD, SAVE or EDIT a macro keys file.
  343. ---------------------------------------------------------------------
  344.  
  345. UTILITIES MENU:
  346.    o NEWCLI: Allows you to open a NewCLI process in the WB window.
  347.  
  348.    o ARC FILES: NOT IMPLEMENTED: And perhaps it won't be.
  349.  
  350.    o UNARC FILES: NOT IMPEMENTED: Allows you to UnARC files online.
  351.  
  352.    o LOAD EDITOR: Loads AmigaDOS ED, on which you can edit files.
  353.  
  354. ---------------------------------------------------------------------
  355.                              Other commands
  356. ---------------------------------------------------------------------
  357. SHIFT HELP: Displays a list of the define macros.
  358.  
  359. HELP:       Opens a small window that gives some helpful information.
  360.  
  361. RIGHT AMIGA 0 through RIGHT AMIGA 9: Attached to the first 10 phone
  362.             entries on your directory.
  363.  
  364. F1 - F10:   Attached to the user definable macro keys.
  365.  
  366. ---------------------------------------------------------------------
  367.                                SideBar
  368. ---------------------------------------------------------------------
  369. SCREEN: Sends the terminal program to the back screen,bringing the WB
  370.         (most likey) as the front screen.
  371. BACK:   Sends the SideBar to the Back of the I/O window.
  372. COLOR:  Calls the SETUP/COLOR window requester function.
  373. DIAL:   Calls the PHONE/DIAL window requester function.
  374. HANGUP: Calls the PHONE/HANGUP function.
  375. SCRIPT: Calls the PROJECT/EXEC SCRIPT function.
  376. BDOWN:  Calls the TRANSFER/BINARY RECEIVE function.
  377. BUP:    Calls the TRANSFER/BINARY SEND function.
  378. CPTURE: Calls the TRANSFER/START(STOP) CAPTURE FILE function.
  379. ASEND:  Calls the TRANSFER/START(STOP) ASCII FILE SEND function.
  380. PRINT:  Calls the PROJECT/PRINTER ON function.
  381. UNARC:  Calls the UTILITIES/UNARC function.
  382. NEWCLI: Calls the UTILITIES/NEWCLI function.
  383. QUIT:   Calls the PROJECT/QUITE PD function.
  384.  
  385. ---------------------------------------------------------------------
  386.                           Config File
  387. ---------------------------------------------------------------------
  388. The following are the different commands supported by the Initializa-
  389. tion Configuration file.. This file must either reside on the CURRENT
  390. or S: directories, otherwise a set of pre-default settings are used.
  391.  
  392. PRIORITY:  The system priority you want to set to the terminal prog.
  393.  
  394. VERSION:   The string you want on the Title bar. DON'T CLAIM the pro-
  395.            gram is your own work!! :-)
  396.  
  397. INTERLACE: Allows the user to select  between INTERLACE/NON-INTERLACE
  398.            as the work screen.. It DOES support full overscan mode.
  399.  
  400. PLANES:    Allows the user to set the  number of bitplanes to be ope-
  401.            ned when the program is invoked... I DO support upto 3 bit
  402.            planes, but the program will allow you to set 4 and even 5
  403.            bit planes, but don't tell me if it does not work.
  404.  
  405. NUMBUFFS:  Allows you to set the  number of Xmodem buffers (128 bytes
  406.            long) you want to keep in buffer for file receptions.
  407.  
  408. BAUDRATE"  Allows you to  set the Baud Rate to be used as the default
  409.            when the program is invoked.
  410. PROTOCOL   Allows you to set the protocol of use for file transfer.
  411.               0 = Xmodem
  412.               1 = Xmodem Ascii
  413.               2 = WXmodem
  414.               3 = Zmodem        (NOT YET IMPLEMENTED)
  415.               4 = Kermit        (NOT YET IMPLEMENTED)
  416.               5 = Multitalk     (NOT YET IMPLEMENTED)
  417.  
  418. DIALTIME:  Time to be set as  call to call time between call attempts.
  419.            In seconds.
  420.  
  421. GETCOLOR:  If on, the system will load the defined .Color file and set
  422.            those colors to the terminal program. If OFF, the WB colors
  423.            are used for the first 4 colors,and other predefined colors
  424.            as colors 5 through 8.
  425.  
  426. LOOKDIR:   This is the Directory Path on  which the  program will look
  427.            for the PHONE, KEYS & COLOR files.  If the file isn't found
  428.            in LOOKDIR it will go and look in DEFDIR.
  429.  
  430. PHONE:     The filename of the file containing your phone directory.
  431.  
  432. KEYS:      The filename of the file containing your default KEYS.
  433.  
  434. COLOR:     The filename of the file containing your COLOR file.
  435.  
  436. FILEDIR:   The directory path on which file transfer will reside. This
  437.            is just a default, you  can change to a different path any-
  438.            time you want.
  439.  
  440. DEFDIR:    The path on which the terminal program will look  for files
  441.            if they are not found in the LOOKDIR path.
  442.  
  443. NOTE: LOOK Update notes for new commands.
  444.  
  445. ----------------------------------------------------------------------
  446.                            A NOTE ABOUT PATHS
  447. ----------------------------------------------------------------------
  448. I *HIGHLY*  recommend  users  to set 1 to 3 letter  paths for LOOKDIR,
  449. DEFDIR and FILEDIR, since they  will be attached to the FILE REQUESTER
  450. if Disk Icons are available..
  451.  
  452. ----------------------------------------------------------------------
  453.                          The Getfile requester
  454. ----------------------------------------------------------------------
  455. This requester is probably one of the best around for this, it is very
  456. smart, looking and assigning those devices YOUR system has to the disk
  457. icons, if you have less  than 6 devices,  it will assign some  of your
  458. PATH's (LOOKDIR, FILEDIR and DEFDIR) to  those remaining disk gadgets,
  459. making life much easier. It also has a  PARENT directory gadget, which
  460. will go one level down through the path, if selected.
  461. Also the filesize of each file is displayed, and better, you only need
  462. to click on it to get the aproximate time it will take for the file to
  463. be transfered to the host.
  464. ----------------------------------------------------------------------
  465. Boy, I am tired, so, that is it for now!
  466. ======================================================================
  467.  
  468.  
  469.