home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / am_radio / comlink350 / Manual / Script_Man / part1 next >
Encoding:
Text File  |  1991-12-15  |  4.1 KB  |  134 lines
  1.  
  2.                       ComLink Information (Version 3)
  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 inceasing
  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. ComLink has been designed with the "Keep it simple" philosophy in mind.
  27.  
  28. INSTALLATION AND OPERATION
  29. ==========================
  30.  
  31. ComLink is installed on the icon bar by the usual method of double clicking
  32. on the ComLink icon.
  33.  
  34. Setting the baud rate and word format
  35. -------------------------------------
  36. Before you can use ComLink you will have to alter the "Config" file. This is
  37. a normal text type file and can be viewed and altered by using !Edit or by
  38. selecting "Config" from the ComLink menu.
  39.  
  40. The Config file sets up the transmit/receive baud rates and the word format.
  41.  
  42. Allowable baud rates are:- 75,150,300,1200,2400,4800,9600 and 19200
  43.  
  44. To set the transmit baud rate use the line:
  45.  
  46. TX:baud
  47.  
  48. Where "baud" is a number from the above. Similarly to set the receive baud
  49. rate, use the line:
  50.  
  51. RX:baud
  52.  
  53. Example:-
  54.  
  55. TX:9600
  56. RX:9600
  57.  
  58. The word format must also be defined. An example is:-
  59.  
  60. FORMAT:8N1
  61.  
  62. The 8 specifies the number of bits in the word, any value in the range 5 to
  63. 8 can be used.
  64.  
  65. The N specifies No parity, other options are E for even and O for odd parity.
  66.  
  67. The last number, in this case 1, specifies the number of stop bits. The
  68. value can be 1 or 2 only.
  69.  
  70.  
  71. TNC settings
  72. ------------
  73.  
  74. Recommended settings for the TNC when running scripts are:-
  75.  
  76. AUTOLF OFF
  77. ECHO OFF
  78. MCON OFF
  79.  
  80. These can be switched ON or OFF in the script if you wish.
  81.  
  82.  
  83. Menu
  84. ----
  85.  
  86. When the centre button on the mouse is pressed with the pointer over the
  87. ComLink icon. A menu will pop up with the following options:-
  88.  
  89. Info  =>
  90. Terminal
  91. Fn keys
  92. Status
  93. Run
  94. Stop
  95. Config
  96. Quit
  97.  
  98. Follow the arrow to the right of the "Info" option, the usual "About this
  99. program" window will pop up.
  100.  
  101. "Terminal" pops up a terminal program window, click the select button in the
  102. bottom seven lines so the window gets the input focus. You can now
  103. communicate with the TNC. See the seperate instructions for using the
  104. terminal mode.
  105.  
  106. The "Status" option, pops up a status window giving information about the
  107. script program running (if any).
  108.  
  109. Selecting "Run" will cause a script file named "SCRIPT" to run, this can be
  110. found in the application directory.
  111.  
  112. "Stop", when selected will stop any script currently running. Open files
  113. will be closed.
  114.  
  115. "Config" allows serial and program parameters to be changed, see the terminal
  116. instructions for further information.
  117.  
  118. "Quit" will close the application.
  119.  
  120. Running a script
  121. ----------------
  122.  
  123. Scripts can be run by double clicking them or dragging them and dropping on
  124. the ComLink icon (when installed on the bar). If a script is already running
  125. then double clicking on a new one will NOT cause the new one run, you must
  126. use the "Stop" menu option first or allow the other script to finish.
  127.  
  128. Clicking once on the ComLink icon when installed on the icon bar causes the
  129. terminal program to run. The terminal mode will not operate if a script is
  130. running even though the terminal window may be visible. When the script
  131. finishes, control will be handed back to the terminal program. Running a
  132. script will likewise suspend operation of the terminal mode. Do not type
  133. in the terminal window when a script is running.
  134.