home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / c / comlink / Manual / Script_Man / 1_Intro next >
Encoding:
Text File  |  1993-11-22  |  3.7 KB  |  112 lines
  1.  
  2.                           ComLink Information
  3.                           ===================
  4.  
  5. INTRODUCTION
  6. ============
  7.  
  8. ComLink is a multitasking application program for the Archimedes computer.
  9. It is intended for use with a TNC for packet radio operations and can run
  10. script programs written by the user. A typical use would be to provide
  11. automatic connection to a BBS and then upload/download messages. Downloaded
  12. messages are saved to files and may be read later using !Edit.
  13.  
  14. The program was written to free the Archimedes user from the tedious task of
  15. linking to a BBS, listing messages and reading selected ones. The increasing
  16. congestion for local packet communication makes this a time consuming
  17. operation but an ideal task for the Archimedes to perform in the background.
  18.  
  19. When running, the user can use other multitasking applications, eg write
  20. messages with !Edit, read old ones etc.
  21.  
  22. This manual may look rather daunting at first sight, but after a little
  23. effort you will find creating script programs or hacking the ones I have
  24. supplied with this program quite easy.......
  25.  
  26. An example script is provided in the "Script_Ex" directory.
  27.  
  28. ComLink has been designed with the "Keep it simple" philosophy in mind.
  29.  
  30. INSTALLATION AND OPERATION
  31. ==========================
  32.  
  33. ComLink is installed on the icon bar by the usual method of double clicking
  34. on the ComLink icon.
  35.  
  36. Setting the baud rate and word format
  37. -------------------------------------
  38. Before you can use ComLink you will have to alter the "Config" file. This is
  39. a normal text type file and can be viewed and altered by using !Edit or,
  40. more easily by selecting the "Config" from the ComLink menu and saving the
  41. options.
  42.  
  43. TNC settings
  44. ------------
  45.  
  46. Recommended settings for the TNC when running scripts are:-
  47.  
  48. AUTOLF OFF
  49. ECHO OFF
  50. MCON OFF
  51.  
  52. These can be switched ON or OFF in the script if you wish.
  53.  
  54. The terminal window
  55. -------------------
  56. Install !ComLink on the icon bar. Click the left (select) mouse button over
  57. the icon on the bar to pop up the terminal program window. Click the select
  58. button in the bottom seven lines so the window gets the input focus. You can
  59. now communicate with the TNC, though you may need to change the serial
  60. parameters. See the seperate file "TermInstr" for further instructions on
  61. using the terminal mode.
  62.  
  63. Menu
  64. ----
  65.  
  66. When the centre button on the mouse is pressed with the pointer over the
  67. ComLink icon. A menu will pop up with the following options:-
  68.  
  69. Info     =>
  70. WimpKeys =>
  71. Fn Keys  =>
  72. Script   =>
  73. Config
  74. Quit
  75.  
  76. All the available options are described in file "TermInstr". Only the
  77. 'Script' options are discussed here:
  78.  
  79. Script
  80. ------
  81.  
  82.     Following this menu option leads to a sub-menu containing:
  83.  
  84.       Status
  85.       Run
  86.       Stop
  87.  
  88. The "Status" option, pops up a status window giving information about the
  89. script program running (if any).
  90.  
  91. Selecting "Run" will cause a script file named "SCRIPT" to run, this can be
  92. found in the !ComLink application directory.
  93.  
  94. "Stop", when selected will stop any script currently running. Open files
  95. will be closed.
  96.  
  97.  
  98. Running a script
  99. ----------------
  100.  
  101. Scripts can be run by double clicking them or dragging them and dropping on
  102. the ComLink icon (when installed on the bar). If a script is already running
  103. then double clicking on a new one will NOT cause the new one to run, you
  104. must use the "Stop" menu option first or allow the other script to finish.
  105.  
  106. Clicking once on the ComLink icon when installed on the icon bar causes the
  107. terminal program to run. The terminal mode will not operate if a script is
  108. running even though the terminal window may be visible. When the script
  109. finishes, control will be handed back to the terminal program. Running a
  110. script will likewise suspend operation of the terminal mode. Do not type
  111. in the terminal window when a script is running.
  112.