home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / finance / futst110.zip / FUT-SORT.DOC next >
Text File  |  1993-08-16  |  10KB  |  184 lines
  1.                    FuturesDataSort v1.10 (08-16-93)
  2.                         by Alexander Morris
  3.                 BBS (DataCom SoftWare): (212) 496-7946
  4.  
  5. This program was written in order to take advantage of the Daily Futures
  6. Data (FREE????.ZIP in the FREEDATA lib) available on the FinComm Financial
  7. BBS system at (212) 752-8660.  As of version 1.10, it also supports the
  8. INDX????.PRT index data files.  It will also remove the 0's from index data.
  9. ie.  !TRIN,0,0,0.78,0 becomes DATE,0.78  Also supported now is the PREMIUM
  10. futures data files (F930816.ZIP).  These are all in comma delimited format.
  11. Note that some of these above formats do not contain date information, and
  12. therefore the computer's clock is used.  BE SURE that the computer's date
  13. and time are correctly set!  Note that beginning with version 1.10, the
  14. output files are named differently as well (old formats will automatically
  15. be renamed).  For example, old form HUX.PRN was Nov Gasoline.  Now it would
  16. be HU-X3.PRN (for Nov '93 Gasoline).
  17.  
  18. NOTE!  Do not try to mix INDEX and FUTURES files in the same pass.  The
  19. program will probably let you do it, but with unpredictable results,
  20. since the programs decides whether it is dealing with INDEX or FUTURES
  21. files based on the first file it encounters.
  22.  
  23.  
  24. It accepts data in the form of:
  25.  
  26. (FREEDATA: FREE0816.PRT)
  27. SPH  01/29/93  439.700  439.700  436.800  438.200      45355        162000
  28. SPM  01/29/93  440.000  440.000  437.400  438.500       1148          5805
  29. SPU  01/29/93  440.500  440.500  438.200  439.000         64          1169
  30. SPZ  01/29/93  441.000  441.200  439.400  439.800         61           143
  31.  
  32. (PREMIUM DATA: F930816.PRN)
  33. SP_U93,449.6,451.35,448,448.85,36947,173403 (***date from filename)
  34.  
  35. (INDEX DATA: INDX0816.PRN)
  36. !DJ,3556.52,3534.16,3555.4,0 (***index, date from filename!)
  37.  
  38.  
  39. For an example of the program's use, you could put the .PRT/.PRN files (with
  40. complete daily Futures quotes) in the \DATA\ dir, and your .PRN histories
  41. in the \DATA\FUT\ directory.  Indices could go into \DATA\IDX.
  42.  
  43. Now, you call Fut-Sort with:
  44.  
  45. fut-sort c:\data\data*.prt \data\fut\ -a
  46.  
  47. This will perform the following:
  48.  
  49. Read all data*.prt daily quote files.  Put histories in the \data\fut\ dir.
  50. -a: Let's say that SP-H3.PRN, SP-M3.PRN exists but not SP-U3.PRN, SP-U3.PRN
  51. will be created.
  52.  
  53. -o: overwrite duplicate data (rarely used -- maybe a faulty quote file?)
  54.  
  55. -n: if a data file does not exist (ie. no SP-U3.PRN) it will ask to create it
  56.  
  57. -N: if a data file does not exist (ie. no SP-U3.PRN) then it will
  58. automatically create it without asking (usually used for first run) --
  59. then delete the ones you don't want to follow.
  60.  
  61. -c: go back to beginning of all data files and adjust formats
  62. -cYYMMDD: Clean data, kill one day of data in all files
  63. -cYYMMDD-YYMMDD: Clean data, kill all data from first date to second date
  64.  
  65. That's about it!  Also, a Symbols.Lst file is created in the histories
  66. directory that lists all of the symbols found in the dir and what they
  67. are (if known).  If you know what a symbol is, and symbols.lst says it's
  68. unknown, then please let me know and I'll update it!  I can be contacted
  69. on FinComm under the account Alexander Morris, or DataCom SoftWare as
  70. sysop.
  71.  
  72. Given the nature of this program, and the way it makes sure that the data
  73. files are sorted without duplicate data, it is evident that the program
  74. will probably be relatively slow.  The procedures have been optimized so
  75. that the basic insertion of quotes files will be slow only for the last
  76. daily quotes file in a wildcard (no effect if you're at a point of only
  77. accepting one day at a time -- ie. no wildcard).  That is because the
  78. program only sorts and rewrites the last file processed.  It is for this
  79. reason that it is not recommended that you escape out of processing,
  80. because it may leave some files unsorted.
  81.  
  82. I've also done a pretty fine job of weeding out the bugs, and of describing
  83. to you all of the features of the program.  If you have any problems with
  84. the program, be sure to let me know, so that I can correct them.  But I
  85. have already been using it for a few weeks and it seems to be running
  86. pretty smoothly.  If you enjoy using this program, well then all I can
  87. say is to please consider a small contribution to either FinComm or to
  88. my BBS, DataCom SoftWare.
  89.  
  90. Besides that, Enjoy!   I hope this program can prove helpful to you!  And
  91. feel free to recommend any other new features to the program!
  92.  
  93. Distribution note:  This program may be freely distributed to anyone as
  94. long as it is not distributed for profit.  That means you can upload it
  95. to BBSes, give it to your friends, to your pets, whatever, as long as you
  96. keep the files within the archive intact.  Please do not modify any of
  97. the included files!  That's all that I ask!
  98.  
  99. Donations:  I will accept donations for use of the software if you enjoy
  100. the program and to persuade me to continue developing it.  Please contact
  101. my BBS (# above) for donation address.  I would recommend a donation of
  102. about $25.  I will also give you special access on my BBS for such a
  103. donation!
  104.  
  105. Errors/Questions/Suggestions:  These can all be reported to me on my
  106. BBS (number given above).  Let me know if you have any compliments or
  107. insults that you would like to leave me about the program.
  108.  
  109.  
  110. Revision Information
  111. --------------------
  112.  
  113. v1.00 (02-01-93):  Initial Release
  114.  
  115. v1.01 (02-16-93):  This version is pretty similar, except some optimization
  116.      was done to make the processing a little faster.  Also, a few more
  117.      commodity definitions were adding, and now the first line of all data
  118.      files will contain a format header such as: "Date","O","H",... for
  119.      programs that use it.  Let me know if this is a good feature; if it
  120.      causes any problems (let me know on FinComm or on my BBS (# above))
  121.      then I'll remove it!  Enjoy!
  122.  
  123. v1.02 (03-01-93):  Never released, adds some more Futures Symbol Descriptions
  124.  
  125. v1.03 (04-03-93):  Added better memory checking.  Now will abort with an
  126.      error if there is not enough free memory to fulfill an operation.  Also,
  127.      someone had mentioned this to me, but I could not do anything until I
  128.      could see the bug happen myself.  I finally did!  Under certain
  129.      circumstances, the QuickSort routine would cause corruption of the data
  130.      files, cause some days to be lost, and the file rendered basically
  131.      useless (until the crap lines are manually removed).  It seems as if
  132.      it may actually be a bug with Turbo Pascal, since the bug had to do
  133.      with assigning a longint to an integer (both which should always be
  134.      small enough anyway).  So I changed it all to integer and it seems
  135.      to work now!  Stupid bug.  Oh well.  Hope no one lost anything because
  136.      of this bug.  Let me know if you find anything else wrong, or would
  137.      like any other additions!  And remember, if you enjoy this program,
  138.      you can always make a nice voluntary contribution to my BBS.  Thanks!
  139.  
  140. v1.04 (04-25-93):  Fixed a few more bugs that I found, not really bugs that
  141.      could affect the data at all, just bugs having to do with the Symbols
  142.      list file.  And while I did that, I decided to make the Symbols list
  143.      nicer too, with what I think to be a better sort.  Now it properly
  144.      sorts the Commodity Month, and also displays the month first.  The
  145.      key sort field is still the commodity description.  I like this format
  146.      better (at least for now!)  Let me know if you like it too!  I also
  147.      changed the exchange information a bit, and now it basically matches
  148.      Omega's Supercharts symbol exchange information.  Well, good luck
  149.      trading, and see you around the phone lines!
  150.  
  151. v1.10 (08-16-93):  Added new formats supported (premium futures data, index
  152.      file data).  I would recommend using Premium Futures data if you have
  153.      a premium account, because it is usually always up to date and contains
  154.      more contracts.  Note that you can use FREEDATA one day and PREMIUM data
  155.      the next, but be aware that not all the same contracts may exist in both.
  156.      Silver (SL) was renamed to SI.  Added data cleaning option (-c) and option
  157.      to remove old data.  There are new provisions now to force certain data to
  158.      be formatted a certain way.  For example, currencies are hard-coded now
  159.      to be in the format of 94.23 instead of .9423 .  Cleaning will go back
  160.      through your old data and correct it from the beginning of the file as
  161.      well as adjust decimal places, etc.  If there is no hard coded setting for
  162.      your commodity, Fut-Sort will clean based on the first line's format
  163.      in your output file.  If a date is given (-c930120), then all occurrences
  164.      of that date will be removed.  An input file is always necessary, even
  165.      for cleaning.  A date range may be given to erase by placing
  166.      -c930120-930225.
  167.      New commodity naming format (will automatically rename old form files).
  168.      For example, old form HUX.PRN was Nov Gasoline.  Now it would be
  169.      HU-X3.PRN (for Nov '93 Gasoline)
  170.      This is a much better format, and besides allowing SuperCharts to
  171.      correctly pick the commodity, it doesn't cause problems when switching
  172.      over to next year's contract.  Nov '94 Gasoline would be HU-X4.PRN.
  173.      Remember to make sure the computer's date is okay at all times when
  174.      running Fut-Sort!  I believe that all bugs have been squashed.  I
  175.      think I squashed a final bug that crashed the program and possibly
  176.      caused data loss on super-large data files.  It had to do with memory
  177.      allocation.  All I can say is that I got it to keep crashing
  178.      consistantly and made changes that no longer cause it to crash!
  179.      If you find any other problems are have any questions, you may direct
  180.      them to my BBS.  Remember to give a donation if you find this program
  181.      useful!  Something in the range of $25 sounds acceptable.  And I'll
  182.      also give you special access on my BBS.  (Call my BBS, # above, for
  183.      where to send donations)
  184.