home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / HAM / SATUPD18.ZIP / SATUPDOC.DOC < prev   
Text File  |  1993-12-28  |  6KB  |  150 lines
  1.  
  2.             Documentation for SATUPDAT
  3.                 by F6BVP
  4.             version 1.80e November 1993
  5.  
  6.  
  7. SATUPDAT program will read messages from AMSAT copied via packet radio. 
  8. It extracts keplerian elements both in NASA and AMSAT formats and updates
  9. the data into the satellites data base of the F6FBB's BBS file that should 
  10. be in the directory \fbb\system\sat\SATEL.DAT 
  11.  
  12. Running SATUPDAT without arguments will print the following message on 
  13. your screen (between lines -----): 
  14.  
  15. -----------------------------------------------------------------------
  16. Automatic update of satellites orbital parameters for F6FBB's bbs
  17. Version 1.80e - November 1993 - Bernard Pidoux, F6BVP
  18. Usage: SATUPDAT [file name<.txt>] </option> </option> </option>
  19.  
  20. Reading option:       /a AMSAT format (default)
  21.                       /n NASA format
  22. Update option:        /f merging new and old data (default)
  23.                       /u update only satellites being in the data base
  24.                       /s keep only satellites being in the input file
  25. Delete option:        /dxxx delete data older than xxx days
  26.                               (default xxx=100 days)
  27.  
  28. <<512 satellites maximum>>
  29. -----------------------------------------------------------------------
  30.  
  31. Version 1.80 November 1993
  32. ==========================
  33. This new version incorporates a new feature that deletes automatiquely from
  34. the satellites data base, keplerian parameters older than a specified number
  35. of days. Default is 100 days. This cleans the data base, removing decayed
  36. satellites without sysop intervention. 
  37.  
  38. Both AMSAT and NASA format checksum are verified, providing uncorrupted data
  39. feeding of the BBS data base.
  40.  
  41. SYSOP information:
  42. For automatic update of keplerian elements into F6FBB's bbs just create
  43. a virtual BBS into BBS.SYS file. Its name could be AMSAT for example. 
  44. Then declare the following forward in the file FORWARD.SYS :
  45.  
  46. ------
  47. *
  48. A AMSAT
  49. *
  50.    G AMSAT
  51.    P @
  52.    C C:\FBB\SYSTEM\SAT\amsat.txt
  53. *
  54. ------
  55.  
  56. CAUTION: The name of the disk unit and the path name should be the exact  
  57. one of your configuration.
  58.  
  59. In order to run automatically SATUPDAT when your computer boots, you must 
  60. modify the batch file like the following example:
  61.  
  62. :direct
  63. rem     horl /s
  64.     if not exist c:\fbb\system\sat\amsat.txt goto appel
  65.     cd c:\fbb\system\sat
  66.     satupdat amsat /n > satupdat.res
  67.     satupdat amsat   >> satupdat.res
  68.     del amsat.txt
  69.     cd \fbb
  70. :appel
  71.     echo Running the BBS ^C for stopping
  72.     sleep 3
  73.     serv -t
  74.     if errorlevel 2 goto direct
  75.     if errorlevel 1 goto suite
  76. :suite
  77.  
  78. (Once again be carefull with the disk name and directories !)
  79.  
  80. SATUPDAT OPTIONS
  81. ================
  82.  
  83. The default extention for input file is .TXT, however you can specify 
  84. another extention.
  85.  
  86. Both arguments after the filename in the command line are optional:
  87. the first one indicates the reading format, either the AMSAT format
  88. or the NASA "2-line" format. The first one is selected by default.
  89.  
  90. The second option is for the choice of update mode.
  91.  
  92. By default the program will merge the old list with the new one (same
  93. if you select option /f). Old data of satellites which are not present in
  94. the input file are kept as is and the other one are updated.
  95.  
  96. Option /u can be selected if you dont want to add new satellites to the one
  97. already present. Only keplerian elements from known satellites are updated.
  98. This prevents the list to grow with incoming satellites that you are not
  99. eventually interested in.
  100.  
  101. Option /s, on the contrary, gives you the possibility to keep only in the 
  102. data base the data from the satellites whose name is in the input file.
  103. This can help you to suppress old satellites from the data base.
  104.  
  105. Option /d is optionnal. Default is 100 days. This means that the program
  106. will remove data older than 100 days from the satellite data base, and
  107. will not take into account keplerian elements older than 100 days from
  108. the input file.
  109.  
  110. In all cases the program takes care of the permanent data of satellites
  111. such as the frequency (for doppler) and the step for computing the 
  112. tracking (you must provide both manually only the first time). 
  113.  
  114. If the keplerian elements of the input file are older than the one already
  115. present in the BBS data base, the old one are kept.
  116.  
  117. The list is sorted by name in order to help finding of the satellite
  118. name when someone is connected to the BBS.
  119.  
  120. If elements for one satellite are duplicated in the input file, the program
  121. will look again for the newest data.
  122.  
  123. Of course, if CRC computed by the program is not the same as the one in the
  124. input file, the program informs you that the CRC is BAD and it does not take
  125. the keplerian elements. 
  126.  
  127. In the batch file example given above you have certainly noticed that I call
  128. twice the program SATUPDAT with two different format arguments. The first
  129. time I ask the program to read the NASA format and the second time to read
  130. the default format AMSAT. The reason is that the probability for an error
  131. to occure in both formats for the same satellite is very small. Thus if an
  132. error occurs in one format the program will complete the update when it founds
  133. uncorrupted keplerian elements in the other format. Thanks to the checksum 
  134. adopted by AMSAT! The results of the update operation is written into the 
  135. SATUPDAT.RES file.  
  136.  
  137. IMPORTANT NOTICE 
  138.  
  139. A bug was found in the 5.13 FBB's BBS program which erases the catalog
  140. number of the satellite when edited manually. This bug creates a problem
  141. with the automatic access to satellite caracteristics documentation. This
  142. is because the caracteristic file name is the catalog number of the satellite
  143. plus the .SAT extension. To avoid this problem I provide a program called 
  144. EDISAT.EXE which allows editing the SATEL.DAT data base, until the bug is 
  145. fixed. 
  146.  
  147. All remarks and suggestions will be appreciated by F6BVP.
  148.  
  149. 73's de Bernard, F6BVP @F6BVP.FRPA.FRA.EU
  150.