home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1997 / WOHR97_AmSoft_(1997-02-01).iso / sat / sat_16 / amsoft.iii next >
Text File  |  1997-02-01  |  4KB  |  95 lines
  1. ┌────────────────────────────────────────────┐
  2. │ SORTNENG - NASA 2-Lines filtering/checking │     IT9XXS Giovanni Mazzola
  3. └────────────────────────────────────────────┘
  4. ──────────────────────────────────────────────────────────────────────────
  5.  
  6.  FREEWARE: You are free to copy and pass this program to a friend.
  7.  
  8.  This is the SEVENTH release of SORTNENG, dated 8 November 1995.
  9.  
  10.  Please upgrade to this new one because it introduces a big change.
  11.  
  12.  ─────────────────────────────────────────────────────────────────────────
  13.  
  14.  !! Notice to previous users !!
  15.  
  16.  This edition was re-written using TurboPascal 6.0.
  17.  If you find any bug, please let me know.
  18.  
  19.  The limit of maximum-256-satellites is now removed.
  20.  
  21.  Please note that, now on, you don't need to redirect the output
  22.  to a log-file to have a list of the NASA keps found: such file,
  23.  SN.LOG, is automatically generated. See below.
  24.  
  25.  ─────────────────────────────────────────────────────────────────────────
  26.  
  27.  I've written this program to automatically extract all or part of the
  28.  NASA keps coming weekly from Internet or other sources.
  29.  
  30.  More, this program checks the integrity of the keps calculating their
  31.  line-checksum and comparing it against the last number reported in each
  32.  line of data, after checking that the first and the second data-line
  33.  are part of the same satellite. Any unuseful data or corrupted element
  34.  will be discarded.
  35.  
  36.  Fatal file-i/o errors will stop the program and return ErrorLevel 1,
  37.  otherwise 0, so you can use SORTNENG with your batch files.
  38.  
  39.  You can invoke the program in two different ways:
  40.  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  41. ┌─ extracting, checking and sorting (by Object Number) *all* elements ─┐
  42. │  syntax: SORTNENG input_file output_file                             │
  43. └──────────────────────────────────────────────────────────────────────┘
  44.  or
  45. ┌─ extracting and checking only selected satellite elements ──┐
  46. │  syntax: SORTNENG input_file output_file wanted_sat_names   │  Same
  47. └─────────────────────────────────────────────────────────────┘  order
  48.                                    ^           ^                  │
  49.  where:                            └───────────┴──────────────────┘
  50.  
  51.  input_file  is a text file where the keps are mixed with lots of messages,
  52.              and even AMSAT element sets (IGNORED);
  53.  
  54.  output_file is a text file, generated by this program, which will contain
  55.              the elements extracted from the "input_file".
  56.              Be careful: if existing, this file will be re-written without
  57.              asking !
  58.  
  59.  wanted_sat_ is the name of an optional text file which holds the satellite
  60.              CATALOG NUMBERS of the keps to be extracted from the "input_file".
  61.              In this case the program does NOT sort the elements, but just
  62.              writes them in the same order as the catalog numbers are written
  63.              inside the "wanted_sat_names" file.
  64.              This is useful if you need only certain satellites and want them
  65.              to be written in a precise order (e.g. by number, like UO-22,
  66.              KO-23, KO-25, and so on).
  67.              A log-file, SN.LOG, is automatically generated by the program:
  68.              it holds all the Object Numbers of the valid satellites found.
  69.              After using Sortneng the very first time, you could edit SN.LOG,
  70.              keep the satellite catalog numbers you need, discard the rest
  71.              and rename the file as you want (because next time SN.LOG will
  72.              be rewritten !).
  73.  
  74.  Input, output and reference filenames must be different, or the program will
  75.  halt and warn you.
  76.  
  77.  I hope you'll find this program useful.
  78.  
  79.  Please send me a message with your suggestions to my Internet address:
  80.                            ┌───────────────────┐
  81.                            │ mc3626@mclink.it  │
  82.                            └───────────────────┘
  83.  This program is FREEWARE. No money is needed.
  84.  
  85.  I'll feel not responsible for any loss of data due to my program.
  86.  Please take care of your valuable programs and data.
  87.  
  88.  Release: 8/XI/95.
  89.  
  90. ------------------------------------------------------------------------------
  91.                  /       it9xxs - giovanni mazzola             amsat-uk 5502
  92.    /. ///.//////./       internet mc3626@mclink.it
  93.    /      //             tcp-ip 44.134.112.62
  94. ------------------------------------------------------------------------------
  95.