home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / packet / mailbox6.arc / MAILBOX6.DOC < prev    next >
Text File  |  1988-08-18  |  7KB  |  183 lines
  1. MAILBOX.DOC  for WB6CGW  MAILBOX6.BAS
  2.  
  3. WRITTEN FOR:  Microsoft Quick Basic Version 4   / CLONE / TNC
  4.  
  5.  
  6. PURPOSE:  
  7. Mailbox  is  a communications program for Radio  Amateurs   using 
  8. packet  radio.  It can be used to communicate with  other  packet 
  9. stations  or  it  can be used in an unattended mode to  wait  for 
  10. a connecting station to leave mail. Transfer of binary files is
  11. possible between two stations using the program.
  12.  
  13. *****************************************************************
  14.  
  15. Mailbox6 is an enhanced version of Mailbox5, which was written
  16. for GWBASIC. MAILBOX6.ARC contains the Quick Basic source code
  17. and a stand alone EXE file.
  18.  
  19. Versions five and six are similar in operation with the following
  20. major differences:
  21.  
  22. 1. Faster operation - This program keeps up with the serial port
  23.    and it is unlikely that the receive buffer will overflow.
  24.  
  25. 2. MAIL6.DAT
  26.    To allow for ease of setting program parameters, such as call
  27.    signs and TNC setup strings, I have included a data file which
  28.    can be changed with a word processor to suit your needs.
  29.    (see MAIL6DAT.DOC)
  30.    MAILBOX6 looks for the data file, MAIL6.DAT, and uses it to preset
  31.    its' initial parameters. If the data file is not found it defaults
  32.    to its' internal parameters. If you are running basic you can, of
  33.    course, change the lines at the front of the program.
  34.  
  35. 3. Function Keys
  36.    Function keys can be preset in MAIL6.DAT and can be set on the fly.
  37.  
  38. 4. DOS SHELL
  39.    This is the Basic SHELL command which allows you to suspend the
  40.    program and return to the DOS command line. Type EXIT to return
  41.    to the mail box program. The communications program stops so it
  42.    is not possible to transfer files while at the DOS command line.
  43.  
  44. 5. When typing on line 25, received data will be displayed on the
  45.    monitor.  In version five, if data was received while  typing, 
  46.    the received data was saved in a buffer until carriage return
  47.    was struck.
  48.  
  49.  
  50. REGARDING HAND SHAKING BETWEEN THE CLONE AND THE PK-232
  51. The following pins are necessary:
  52.  
  53. CLONE END:                         PK-232  J2
  54. DB9 CONNECTOR   DB25 CONNECTOR
  55. 3          2          (transmit data)       -> 2
  56. 2          3          (receive data )       <- 3
  57. 7          4          (request to send)     -> 4
  58. 8          5          (clear to send)       <- 5 (toggles)
  59. 6          6          (data set ready)      <- 6 (always high)
  60. 5          7          (signal ground)           7
  61. 1          8          (data carrier detect) <- 8
  62. 4          20          (data terminal ready) -> 20
  63.  
  64.  
  65.  
  66. When  the program is run the following options are available from 
  67. the main menu.  Choose the mode you wish to operate in,  type the 
  68. number and hit return. (enter)
  69. Note: TNC must be connected or there will be a device time-out.
  70.  
  71.  
  72. 1. INITIALIZE TNC
  73.  
  74. The  program  attempts to initialize the TNC by  sending  TNC$(1) 
  75. through TNC$(9) to the TNC.  TNC$(1) is the TNC auto-baud  signal 
  76. and is sent three times, while TNC$(2) through nine are sent only 
  77. once. If you add more strings, be sure to change TNCN to indicate 
  78. the  total number. If your TNC is  like mine you won't have
  79. to change anything.
  80.  
  81.  
  82. 2.   WAIT FOR MAIL
  83.  
  84. The  program closes any open files,  lists the BBS stations  that 
  85. are  monitored  and  waits for mail or a connection.  Hit  ^Q  to 
  86. return to the menu.  If you have mail on a monitored BBS,  a file 
  87. containing  the  date and time is opened under the name  of  that 
  88. BBS. A connecting station can up-load a file or leave a  message. 
  89. After disconnect, the program returns to the check for mail mode.
  90. If  there  is  no activity for several minutes  the  screen  will 
  91. blank to protect the terminal.
  92.  
  93. NOTE: 
  94. The program waits to receive a match with the string contained
  95. in the array BBS$(x). When a match is detected it looks at the
  96. rest of the line to see if there is a match with MAILCALL$.
  97. Use a word processor to change these two strings in the data
  98. file, to match the strings of the Bulletin Board System that
  99. you are monitoring.
  100.  
  101.  
  102. 3.   COMMUNICATIONS
  103.  
  104. This mode operates as a terminal program,  allowing control
  105. of the TNC and contact with other stations.  Hit
  106. ALT  Q  to return the the main menu.  All  of  the  functions
  107. available   from  the  main  menu  are  available  while  in  the 
  108. communications  mode by hitting the ALT key along with one  other 
  109. key. (hit ALT H while in the com mode to see a list of choices.)
  110. If there  is  no activity for several minutes the screen will
  111. blank leaving only a blinking cursor.
  112.  
  113.  
  114. 4.   LOG FILE ON
  115.  
  116. Opens  log  file into which text sent and text received is saved
  117. to disk  under the  file name of your choice. The extension is
  118. provided  by  the program. When asked for a filename enter a name
  119. or hit return and the  program will provide the name PACKETLG.
  120. The first extension will  be .100 and will increment with each
  121. additional  PACKETLG. Files  can  be opened quickly with out giving
  122. any thought to  the actual name.  (a download file works the same
  123. way except that only received text is saved to disk )
  124.  
  125.  
  126. 5.   CLOSE LOG FILE
  127.  
  128. Closes any open log or download file.
  129.  
  130.  
  131.  
  132. 6.   TYPE FILE TO DISK
  133.  
  134. Allows creating a text file without leaving the program.  Editing 
  135. is only possible on the line being typed.  End with /ex on a line 
  136. by itself. 
  137.  
  138.  
  139. 7.   VIEW FILE
  140.  
  141. Allows viewing any ASCII file on disk.
  142.  
  143.  
  144. 8.   UPLOAD FILE
  145.  
  146. Up-load a binary or ASCII file while in this mode.
  147. (binary files require that both stations use this program)
  148.  
  149. NOTE:
  150. I have noticed that there are times when I receive ASCII packets
  151. that  have  obvious errors. It follows that if errors  can  creep 
  152. into the ASCII packets they can also disrupt packets while in the
  153. transparent mode. If an error were to creep into a binary file it
  154. would most likely render the file useless. I was hoping to rely on
  155. the TNC to  pass only valid packets but it looks like that isn't
  156. always the case. It might be necessary to incorporate some form of
  157. software error checking to make a reliable binary transfer.
  158.  
  159.  
  160. 9.   DISPLAY FILES
  161.  
  162. Display a directory of a disk drive.
  163.  
  164.  
  165. 0.  EXIT
  166.  
  167.  
  168.  
  169.     
  170. Final Note:
  171. While I use this program regularly, I have not been able to test
  172. it 100%. I have used a second computer to simulate transfer of
  173. binary files, but until I actually do it on the air I can't be sure
  174. how well it works. If you get the program running I'd like to set
  175. up a QSO and try to transfer binary files.
  176.  
  177. I am working on a "C" version of this program. If you have any
  178. comments or ideas for improvement, please leave a message @WB6ASR
  179. WB6CGW
  180.  
  181.  
  182. 
  183.