home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / satinita.zip / SATINIT.DOC < prev    next >
Text File  |  1994-05-26  |  14KB  |  337 lines
  1.                                    SATinit 2.1
  2.  
  3.                                Satellite Interrogator
  4.  
  5.                                    USER MANUAL
  6.  
  7.  
  8.           Software and documentation written by Thom LaCosta and
  9.                                                 Charles Davis
  10.                     Copyright (C) 1994 UBD, Inc.
  11.                                All rights reserved
  12.  
  13.      1.1  What is The Satellite Interrogator < SATINIT > ?
  14.  
  15.      SATinit is designed to help you locate information on objects launched    
  16.      into Space.  They may either have Decayed from orbit or still be in       
  17.      orbit. A complete database is maintained and updated in March of each     
  18.      year.
  19.  
  20.      SATinit, will allow the user to create full reports on an object(s)       
  21.      containing useful information for the satellite enthusiast. 
  22.  
  23.      The following list represents items which may be searched, browsed and      
  24.      reports generated.
  25.  
  26.                     a. Catalog Number
  27.                     b. International Designator
  28.                     c. Launch Site
  29.                     d. Launch Date
  30.                     e. Perigee
  31.                     f. Period
  32.                     h. Country of Origin
  33.                     i. Inclination
  34.                     j. Satellite Name
  35.                     k. Apogee
  36.                     l. Decay
  37.      
  38.      
  39.      1.2  Features:
  40.                     a. Full Database Reports #
  41.                     b. Selective Searches
  42.                     c. Criteria Matching and Searching
  43.                     d. Database Browsing
  44.                     e. Labels
  45.                     f. Editing of each field
  46.                     g. Record Deletion
  47.                                    
  48.      *: Future editions will include the ability to select current Keplerian  
  49.          element groups from standard .TLE files for a give satellite.
  50.      
  51.      #: The BBS version will not allow reports to be generated, appended or
  52.         printed to a printer or file. Users of the BBS version must be        
  53.         Doorway Aware.
  54.                     
  55.  
  56.      1.3  System Hardware and Software Requirements
  57.  
  58.          *  An IBM PC, XT, AT or 100% compatible with hard disk.
  59.  
  60.          *  Microsoft MS-DOS or IBM PC-DOS version 3.00 or later. Version
  61.             3.30 or later is preferred.
  62.  
  63.             SATinit was successfully tested with DOS 3.2, 3.3, 4.0 and 5.0,
  64.             DR DOS 5.0 and 6.0 ,Windows 3.0 and 3.1, QEMM 5 and 6.0,
  65.             Novell NetWare, Novell Lite, LANtastic on systems equipped with
  66.             NEC V20, V30, V40, Intel 8086, 8088, 80186, 80286, 80386 and i486
  67.             CPUs.
  68.  
  69.          *  At least "FILES=30" in your CONFIG.SYS.
  70.  
  71.             SATinit can optionally use more than 30 file handles, which
  72.             requires a higher FILES value.
  73.  
  74.             A disk cache (especially one that can buffer disk writes, such
  75.             as Norton Cache or HyperDisk) can improve performance, but of
  76.             course it is not required. If you are not using a disk cache,
  77.             make sure that CONFIG.SYS contains "BUFFERS=30" (or higher) to
  78.             improve performance and consider enabling SATinit's internal disk
  79.             buffer for writing to the Hudson message base in the BBS version.
  80.  
  81.          *  At least 450 KB of RAM available.
  82.  
  83.             The amount of RAM needed by SATinit depends on the configur-  
  84.             ation of your system.  If you operate a BBS please refer to    
  85.             your BBS documentation concerning swapping the BBS to XMS, EMS
  86.             or disk.
  87.  
  88.      1.4  License and Disclaimer
  89.  
  90.      "SATinit" refers to all executables and documentation as distributed in
  91.      the compressed file in which the package was released.
  92.  
  93.          *  SATinit is copyrighted material by UBD. It may only be used
  94.             in agreement with the conditions set out in this license
  95.             agreement.
  96.  
  97.          *  This version of SATinit is released as shareware.
  98.  
  99.             -  The following applies to all users who can afford to
  100.                register SATinit: you may use the unregistered version of
  101.                SATinit for an evaluation period of one month. After this
  102.                period you MUST either register SATinit or stop using it.
  103.  
  104.             -  Registration is REQUIRED for commercial usage (in a
  105.                commercial environment, such as business, governmental
  106.                organization, association, school, foundation, or any other
  107.                form of juridical person, or any system where SATinit is
  108.                directly or indirectly used to make profit).
  109.  
  110.             -  Unregistered evaluation versions of SATinit may be distributed
  111.                freely provided no money or any other compensation is asked
  112.                or accepted without prior written permission from the
  113.                author. Registered versions may only be distributed to
  114.                registered users.
  115.  
  116.          *  Although care has been taken to write and test a program that
  117.             does what this document states, SATinit is provided as is,
  118.             without warranty or guarantee of any kind, either expressed or
  119.             implied, as to the fitness for a particular purpose or quality
  120.             or performance of this program, except that SATinit will occupy
  121.             disk space.
  122.  
  123.          *  In no event shall UBD be liable to you or anyone else for any
  124.             damages or cost, including, but not limited to, any lost profits,
  125.             lost savings or lost income which may result from the use or
  126.             inability to use SATinit.
  127.  
  128.          *  In no way is UBD obligated to you or anyone else to provide
  129.             future versions of, or support for SATinit.
  130.  
  131.          *  UBD reserves the right not to release future share ware
  132.             versions of SATinit, but switch to a commercial "buy
  133.             before you try" marketing concept instead.
  134.  
  135.          *  Your use of SATinit constitutes your agreement to this license
  136.             and disclaimer and your release of the author from any form of
  137.             liability or litigation. 
  138.  
  139.      2.0 Operation
  140.      
  141.           Operation is very simple and straight forward, along with generous
  142.           help menus guiding the user through each step as either an online or
  143.           a stand alone program. SatInit is a pleasure to use.
  144.  
  145.      3.0  Credits
  146.  
  147.           Many thanks to all the registered users and beta testers for their
  148.           contributions.
  149.  
  150.      4.0  Installation
  151.  
  152.           A. Create a subdirectory named SATINIT.  Unzip the contents of
  153.              SATINITA.ZIP into the subdirectory.  If you have received a
  154.              registration key, copy the key into the subdirectory and copy
  155.              it to      
  156.    
  157.           B. Before you run SATINIT for the first time, you MUST copy the
  158.              file LOCAL.CFG to SATSET.CFG.  Next, run SEUP.BAT. Thereafter,
  159.              you can execute SATLOCAL.BAT  for local operations. You MUST run
  160.              SATBBS.BAT before calling the program from your BBS.
  161.    
  162.           C. SAT_COND.DBF
  163.    
  164.              This database is created and/or modified anytime (L)ocate
  165.              in the edit screen or Use a Condition in the report module
  166.              is selected.  Due to the complex nature of the search, the
  167.              batch file SATLOCAL.BAT copies your SAT_COND.DBF to SAT_LOC.DBF
  168.              in order to preserve the contents.  The BBS version of SATINIT,
  169.              called by SATBBS.BAT creates a SAT_COND.DBF that is NOT saved at
  170.              program termination.  SAT_COND.DBF is not saved in the BBS
  171.              version to insure that any online user errors in search logic
  172.              are not maintained in the master database.
  173.    
  174.           D. The major differences between the LOCAL and BBS configurations
  175.              are as Follows:
  176.    
  177.              LOCAL                                BBS
  178.              APPEND-Records can be appended       APPEND-Users can NOT append
  179.              BROWSE-Records may be edited         BROWSE-Users can NOT edit
  180.              REPORT-Either Screen or Print        REPORT-Screen Only
  181.   
  182.          CONDITONS DATA BASE (Used by Locate and Report Conditions)
  183.          
  184.              Entries are saved on SAT_COND.DBF    NO SAT_COND.DBF saved
  185.     
  186.           E. BBS Operations
  187.      
  188.              You may run SATINIT on your BBS, AFTER running SATBBS.BAT.  
  189.              SATINIT requires that your users use a DOORWAY compatible
  190.              terminal program to make use of cursor keys and other control
  191.              and ANSI functions.
  192.          
  193.              Please consult your BBS and/or DOORWAY documentation for the
  194.              proper method of calling SATINIT.  The sample below operates
  195.              correctly with Remote Access 2.01, using a TYPE 7 Menu.
  196.  
  197.  
  198.     RemoteAccess Menu Manager v2.01         Copyright (c) 1993, The Thabes Co.  
  199. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  200.                   1         2         3         4         5         6         7 
  201.          1234567890123456789012345678901234567890123456789012345678901234567890 
  202. DISPLAY :                                                                      
  203.  ACTION  Run external in shell (Type 7)                                         
  204.  OPTION  c:\dos\command.com /c c:\ra\makesat.bat *M                             
  205.  HOT-KEY S                                                                      
  206.  AUTORUN off                                                                    
  207.  COLOR    SAMPLE                                                                
  208.                                                                                 
  209.  MIN SEC: 10            TIME USED: 0                                            
  210.  MAX SEC: 0             TIME LEFT: 0                                            
  211.  A FLAGS: --X-----      MIN SPEED: 0                                            
  212.  B FLAGS: --------      MAX SPEED: 0                                            
  213.  C FLAGS: --------      FLAT COST: 0                                            
  214.  D FLAGS: --------      TIME COST: 0                                            
  215.                                                                                 
  216. echo off
  217. cls
  218. rem makesat.bat
  219. cd\ra
  220. rem note the use of /CD to tell doorway  the program uses datafiles in a sub
  221. rem where the called program resides
  222. rem note the use of the path to the program after the P: command
  223. rem the O:T kills the time left display
  224. doorway.exe SYSF /G:on /B:MS /O:T /L /V:D^U /CD /P:c:\ra\satinit\satinit.exe
  225. cd\ra
  226.      5.0   Database Information
  227.  
  228. SOURCE
  229.      This is the source of the payload.  Usually, the source of the payload is
  230. the same as the source of the launch, but not always.  For instance, the US
  231. launches payloads for many other countries and organizations (e.g., NATO or
  232. ESA).
  233.  
  234.      ARGENT        Argentina
  235.      AUSTRL        Australia
  236.      BRAZIL        Brazil
  237.      CANADA        Canada
  238.      CZECH         Czechoslovakia
  239.      ESA           European Space Agency
  240.      ESRO          European Space Research Organization
  241.      FRANCE        France
  242.      FR/FRG        France/Federal Republic of Germany
  243.      FRG           Federal Republic of Germany
  244.      IMSO          International Maritime Satellite Organization
  245.      INDIA         India
  246.      INDNSA        Indonesia
  247.      ISRAEL        Israel
  248.      ITSO          International Telecommunications Satellite Organization
  249.      ITALY         Italy
  250.      JAPAN         Japan
  251.      KOREA         Korea
  252.      LUXEMB        Luxemburg
  253.      MEXICO        Mexico
  254.      NATO          North Atlantic Treaty Organization
  255.      NETH          Netherlands
  256.      PAKIST        Pakistan
  257.      PORTUG        Portugal
  258.      PRC           People's Republic of China
  259.      SAUDI         Saudi Arabia
  260.      SPAIN         Spain
  261.      SWEDEN        Sweden
  262.      THAI          Thailand
  263.      UK            United Kingdom
  264.      US            United States of America
  265.      USSR          Union of Soviet Socialist Republics
  266.  
  267. LSITE
  268.      This refers to the launch site from which the object was launched.  As of
  269. today, there are currently 18 launch sites around the world.  The codes
  270. and their meanings are:
  271.  
  272.      AFETR         Air Force Eastern Test Range, Florida, USA
  273.                    (Cape Canavrial)
  274.  
  275.      AFWTR         Air Force Western Test Range, California, USA
  276.                    (Edwards Air Force Base)
  277.  
  278.      CHINA         Chinese Launch Complex, PRC, China
  279.                    (Xchang)
  280.  
  281.      FRGUI         French Guiana
  282.                    (French Guiana)
  283.  
  284.      HGSTR         Hammaguira Space Track Range
  285.  
  286.      KSCUT         Kagoshima Space Center - University of Tokyo
  287.                    (Japan)
  288.  
  289.      KYMSC         Kapustin Yar Missile and Space Complex
  290.                    (Russia)
  291.  
  292.      PLMSC         Plesetsk Missile and Space Complex
  293.                    (Russia)
  294.  
  295.      SCMTR         Shangchengtze Missile Test Range, PRC
  296.                    (China)
  297.  
  298.      SRILR         Sriharikota Launching Range
  299.                    (India)
  300.  
  301.      SNMLP         San Marco Launch Platform, Indian Ocean
  302.                    (Kenya)
  303.  
  304.      TANSC         Tanegashima Space Center
  305.                    (Japan)
  306.  
  307.      TYMSC         Tyuratam Missile and Space Center, Kazakhstan
  308.                    (Russia)
  309.  
  310.      WLPIS         Wallops Island
  311.                    (Virginia, USA)
  312.  
  313.      WOMRA         Woomera
  314.                    (Australia)
  315.  
  316.      WUZLF         Wuzhai Launch Facility, PRC
  317.                    (China)
  318.  
  319.      XICLF         Xi Chang Launch Facility, PRC
  320.                    (China)
  321.  
  322.      YAVNE         Yavne Launch Facility
  323.                    (Israel)
  324.  
  325. ORBIT(s)
  326.  
  327.             EARTH ORB             Earth Orbit (Geocentric)
  328.             SOLAR ORB             Solar Orbit (Heliocentric)
  329.             LUNAR ORB             Lunar Orbit (Selenocentric)
  330.             MARS ORBT             Mars Orbit  (Areocentric)
  331.             VENUS ORB             Venus Orbit
  332.             BARYCNTRC             Barycentric Orbit
  333.             SS ESCAPE or SSET     Solar System Escape Trajectory
  334.             CENM                  Current Elements Not Maintained
  335.             ELNA                  Elements Not Available
  336.  
  337.