home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / INFO / FORTRAN / SUPERT87.ZIP / READ.ME < prev    next >
Encoding:
Text File  |  1986-12-15  |  14.5 KB  |  322 lines
  1.                         12/05/84
  2.  
  3. Dear Hank
  4.  
  5. Here is the Material You Requested.  Forgive the verbosity.  
  6. To Paraphrase Voltaire, Had I More time, I would have been Briefer. 
  7.  
  8.  
  9.                 Joe DiMeo
  10.  
  11. ______________________________________________________________________________
  12.  
  13.         Supertrek 1979
  14.  
  15.  
  16.     This Version of the Popular Star Trek Program was Written
  17. in  IBM's  dialect of FORTRAN 66 to run under the TSO enviornment
  18. on an IBM mainframe. It seems to be a Fairly comprehensive and
  19. challenging version of the Game.
  20.  
  21.   It  was  converted  to Fortran 77 and compiled with a beta test
  22. version of The IBM Professional Fortran Compilier as  a  'torture
  23. test'  of  that  compiler  for  an  article  for  the now defunct
  24. Personal Computer Age magazine.  The purpose of  this article was
  25. not only to see if the Product in question could compile  a  very
  26. large  Program  (5500+  lines  of code!)  but whether it would be
  27. possible to move an application of  this  size  onto  a  personal
  28. computer.   The  experiment  was  a  qualified  success  and I am
  29. releasing the results into the public domain.
  30.  
  31.   There  is no free lunch, however.  Supertrek requires a minimum
  32. of 384k of  memory and an 8087 NDP in order to run.  In addition,
  33. all of the COMMxxx and  GENxx files,  and  the  KEYFILE.TRK  file
  34. must  reside  on  the  logged drive.  Note that all of these file
  35. will reside on a single  362k  NON  BOOTABLE  floppy. Would  be  
  36. modifiers of the program will find that they need at least two 
  37. megabytes of free working storage to make any modifications to 
  38. Supertrek.   I  have  found,  however,  that  is  its possible to
  39. compile the program on a floppy based system with 640k of  memory
  40. -  by  converting at least 384k of that memory into a ramdisk and
  41. doing a lot of floppy disk shuffling.
  42.  
  43.     There  is  much  more that could be done to adapt Suprtrek to
  44. the personal computer enviornment.  This includes getting rid  of
  45. some  annoying  vestiges  of its mainframe heritage (for instance
  46. the program will refuse to run during certain  hours-  presumably
  47. the  times  of peak word load on the mainframe it originated on).
  48. and correcting a few bugs that were either introduced in the P.C.
  49. conversion or were present in the original.  It  should  also  be
  50. Possible  to  adapt  the  code to compile under Microsoft Fortran
  51. Vresion 3.2 or Later.  The benefit of such an adaptation would be
  52. in the removal of the requirement for an 8087  and  would  remove
  53. the  need  for  the use of the "/r 2400" command line option each
  54. time the program is run.  The Fortran source  should  require  no
  55. modifications.   The  assembly  language modules to get the date,
  56. get the time, clear the screen and home the cursor will  have  to
  57. be  converted  to  the  format  needed  to  successfully  link to
  58. Microsoft Fortran. I  Include  the source files modules MSTIME.ASM 
  59. and MSDATE.ASM on the second disk to give those who might attempt
  60. the project a head start.
  61.  
  62.   Most of these changes require more time than I have available. 
  63. Hopefully someone else will pick up where I have left off.
  64.  
  65.             Enjoy.
  66.  
  67.                 Joseph V. DiMeo
  68.  
  69.  
  70.  
  71. Contents of disk 1 - this is the star trek source code
  72.  
  73.      EFPHSR   FOR       2473   9-01-84   1:14p    m
  74.      EFTSUB   FOR       4031   9-01-84   1:15p    m
  75.      EPHIT    FOR       4109   9-01-84   1:15p    m
  76.      EPMOVE   FOR      14951   9-01-84   1:18p    m
  77.      TCOMMON  FOR       2937   8-03-84  10:54p    m
  78.      EPULSE   FOR       6137   9-01-84   1:22p    m
  79.      TRPMV    FOR       1147   9-01-84   1:22p    m
  80.      TRY1     FOR      42876   9-01-84   1:08p    m
  81.      FIGHT    FOR       6139   9-01-84   1:23p    m
  82.      GETBRG   FOR        640   8-04-84  12:30p    m
  83.      TSHUTL   FOR      20099   9-01-84   1:23p    m
  84.      SCAN     FOR      21263   9-01-84   5:49p    m
  85.      SIND     FOR        512   8-04-84   9:23a    m
  86.      STAR79   FOR      11189   9-02-84   5:55p    m
  87.      STORM    FOR       7853   9-01-84   1:24p    m
  88.      SYSROUT  FOR        742   8-17-84  10:13p    m
  89.      RAN      FOR        346   8-14-84  11:44a    m
  90.      RAND     FOR       1074   8-12-84   2:08p    m
  91.      RANGE    FOR        512   8-04-84   9:24a    m
  92.      RATING   FOR       6171   9-02-84   5:28p    m
  93.      REPAIR   FOR       8905   9-01-84   1:47p    m
  94.      ROMLN    FOR      18463   9-01-84   1:53p    m
  95.      SUPRTREK FOR        525   8-30-84   4:39p    m
  96.      RSTART   FOR       3245   9-02-84   5:31p    m
  97.      MASKEF   FOR      10039   9-01-84   1:54p    m
  98.      OMOVE    FOR       1408   8-04-84  11:58a    m
  99.      PLIN     FOR        982   9-01-84   1:56p    m
  100.      PROCM    FOR      25369   9-01-84   1:56p    m
  101.      PUTIN    FOR       1167   9-01-84   3:55p    m
  102.      QQMOVE   FOR       4499   9-01-84   3:54p    m
  103.      ACTION   FOR       5983   9-01-84   3:55p    m
  104.      BEAM     FOR       7387   9-01-84   3:56p    m
  105.      BHOLE    FOR       5905   9-01-84   3:56p    m
  106.      CHEKDG   FOR       1645   9-01-84   3:56p    m
  107.      COLLIS   FOR      28674   9-01-84   3:57p    m
  108.      COSD     FOR        512   8-04-84  12:01p    m
  109.      DAMAGE   FOR       5201   9-01-84   3:57p    m
  110.      DLETE    FOR      10741   9-01-84   3:57p    m
  111.      DOCK     FOR       7563   9-01-84   3:58p    m
  112.      IBLOCK   FOR       2680   9-01-84   5:13p    m
  113.      GHACTV   FOR       3518   9-02-84   6:06p    m
  114.      HITONE   FOR       1847   9-01-84   3:58p    m
  115.      KLNGN    FOR      19746   9-01-84   4:00p    m
  116.      KLQ      FOR       3485   9-01-84   4:00p    m
  117.      HELP     FOR       1521   9-01-84   1:13p    m
  118.  
  119. 45 "*.*" files found in the directory.
  120.    Total: 336,211   Free: 4,096
  121. ______________________________________________________________________________
  122.  
  123. Contents of Disk 2
  124.  
  125. remainder of star trek source code
  126.  
  127.  
  128.      ST79INIT UTF        989   8-19-84  7:39p keyword file setup utility
  129.                                 this functions
  130.  
  131.     The following two programs are undebugged as of this time.
  132.  
  133.      RANKING  UTF       2406   8-23-84  7:15p shows player ranks
  134.      DEDUCT   UTF        642   8-23-84  7:36p  ?????????
  135.  
  136.      COMMONS  DOC      41728   5-12-83  3:17p documents program variables
  137.      ROUTINES DOC       3840   5-12-83  3:41p documents program modules
  138.      ST79INST DOC       1536   5-12-83  4:25p original installation doc
  139.      INDEX    DOC       1152  12-05-84  6:27p disk index 
  140.  
  141.      COMM1              2638   8-16-84  7:36p on line help files
  142.      COMM02              937   8-16-84  7:44p    "
  143.      COMM01             2642   8-16-84  7:43p    "
  144.      COMM03              679   8-16-84  7:44p    "
  145.      COMM04              513   8-16-84  7:45p    "
  146.      COMM05             1043   8-16-84  7:45p    "
  147.      COMM06              639   8-16-84  7:45p    "
  148.      COMM07              348   8-16-84  7:46p    "
  149.      COMM08              237   8-16-84  7:46p    "
  150.      COMM10              494   8-16-84  7:46p    "
  151.      COMM11              494   8-16-84  7:47p    "
  152.      COMM12              386   8-16-84  7:48p    "
  153.      COMM13              495   8-16-84  7:48p    "
  154.      COMM14              584   8-16-84  7:49p    "
  155.      COMM15              480   8-16-84  7:49p    "
  156.      COMM16              568   8-16-84  7:49p    "
  157.      COMM17              482   8-16-84  7:49p    "
  158.      COMM18              235   8-16-84  7:50p    "
  159.      COMM19              511   8-16-84  7:50p    "
  160.      COMM20              403   8-16-84  7:51p    "
  161.      COMM21              642   8-16-84  7:51p    "
  162.      COMM22              424   8-16-84  7:52p    "
  163.      COMM23              115   8-16-84  7:52p    "
  164.      COMM24              115   8-16-84  7:52p    "
  165.      COMM011             553   8-16-84  7:53p    "
  166.      COMM012             687   8-16-84  7:57p    "
  167.      COMM041             437   8-16-84  7:58p    "
  168.      COMM042             791   8-16-84  7:58p    "
  169.      COMM051             463   8-16-84  7:59p    "
  170.      COMM052             402   8-16-84  7:59p    "
  171.      COMM061             905   8-16-84  7:59p    "
  172.      COMM062             289   8-16-84  7:59p    "
  173.      COMM063             433   8-16-84  8:00p    "
  174.      COMM071             387   8-16-84  8:01p    "
  175.      COMM091             178   8-16-84  8:01p    "
  176.      COMM092            1189   8-16-84  8:01p    "
  177.      COMM093             321   8-16-84  8:02p    "
  178.      COMM0101            577   8-16-84  8:03p    "
  179.      COMM0111            577   8-16-84  8:03p    "
  180.      COMM0121            397   8-16-84  8:03p    "
  181.      COMM0181            237   8-16-84  8:04p    "
  182.      COMM0191            775   8-16-84  8:05p    "
  183.      COMM0192            585   8-16-84  8:05p    "
  184.      COMM0193            405   8-16-84  8:06p    "
  185.      COMM0194            377   8-16-84  8:07p    "
  186.      COMM0201            424   8-16-84  8:07p    "
  187.      COMM0202           1659   8-16-84  8:08p    "
  188.      COMM0203            280   8-16-84  8:08p    "
  189.      COMM0204            381   8-16-84  8:09p    "
  190.      COMM0205            383   8-16-84  8:09p    "
  191.      COMM0206            280   8-16-84  8:10p    "
  192.      COMM0211            144   8-16-84  8:11p    "
  193.      COMM0212            931   8-16-84  8:11p    "
  194.      COMM0221            563   8-16-84  8:11p    "
  195.      COMM0222            327   8-16-84  8:12p    "
  196.      GEN01              2262   8-16-84  8:14p    "
  197.      GEN02               203   8-16-84  8:15p    "
  198.      GEN03               379   8-16-84  8:15p    "
  199.      GEN04              4309   8-16-84  8:16p    "
  200.  
  201.  
  202.      TREK     MAK       2670   8-14-84 11:38a   Polymake file for trek
  203.      LTRK                312   8-14-84  7:23p  linker RSP file
  204.      RMHOME   ASM       1285   8-17-84  7:07a  Assembly routines...
  205.      RMDATE   ASM       1445   8-17-84  7:24a  needed...
  206.      RMTIME   ASM       1519   8-17-84  7:31a  by...
  207.      RMCLS    ASM       1584   8-17-84  8:52p  startrek.
  208.  
  209.      TREKINIT EXE      32695   8-31-84   7:02a keyword file
  210.                         initalization program
  211.                         executable version
  212.  
  213.       NOTE: that TREKINIT must be evoked as follows:
  214.     
  215.     TREKINIT /R 2400
  216.  
  217.       Otherwise, the program will fail with an error 3086
  218.     This is caused by a quirk in the IBM Professional Fortran
  219.     Compiler run time support.
  220.  
  221.      READ     ME       10952  12-05-84   this file
  222.      HELP     370      36608  12-05-84   6:28p    m
  223.      BPAGE    370       3328   5-12-83  4:41p IBM 370 version..
  224.      CPAGE    370       3072   5-12-83  4:47p of assembly....
  225.      QDATE    370       3840   5-12-83  4:55p routines needed...
  226.      QTIME    370       3584   5-12-83  5:00p by trek
  227.      DEDUCT   370       1792  12-05-84   6:27p originals...
  228.      RANKING  370       2560  12-05-84   6:27p of...
  229.      ST79INIT 370        768  12-05-84   6:27p support programs.
  230.  
  231. 83 "*.*" files found in the directory.
  232.    Total: 205,680   Free: 112,640
  233.  
  234. ______________________________________________________________________________
  235.  
  236. Contents of disk 3
  237.  
  238.       The contents of this disk constitute all the files needed for the
  239.     complete working startrek program
  240.  
  241.      KEYFILE  TRK       4800  12-05-84  6:06p user keyword file 2 players
  242.      DTREK    EXE     250004   8-31-84  7:14a startrek - latest version
  243.  
  244.  
  245.       Because of a quirk in the implementation of IBM Professional Fortran 
  246.     runtime routines, DTREK must be invoked woth the command:
  247.  
  248.     DTREK /R 24000
  249.  
  250.       Otherwise the program will refuse to do anything beyond the
  251.     password prompt.  This line is contained in the file STARTREK.BAT.
  252.  
  253.       Enter your last name as master and your password as shazam
  254.     in order to begin the game.
  255.  
  256.       Answer N to the "Do you want to change your Password?"  Prompt.
  257.     a Y answer to this prompt does into an undebugged section of the code
  258.     and I cant guarantee the results... All of the other Prompts are self 
  259.     evident.
  260.  
  261.      COMM1              2638   8-16-84  7:36p   on line help files
  262.      COMM02              937   8-16-84  7:44p    "
  263.      COMM01             2642   8-16-84  7:43p    "
  264.      COMM03              679   8-16-84  7:44p    "
  265.      COMM04              513   8-16-84  7:45p    "
  266.      COMM05             1043   8-16-84  7:45p    "
  267.      COMM06              639   8-16-84  7:45p    "
  268.      COMM07              348   8-16-84  7:46p    "
  269.      COMM08              237   8-16-84  7:46p    "
  270.      COMM10              494   8-16-84  7:46p    "
  271.      COMM11              494   8-16-84  7:47p    "
  272.      COMM12              386   8-16-84  7:48p    "
  273.      COMM13              495   8-16-84  7:48p    "
  274.      COMM14              584   8-16-84  7:49p    "
  275.      COMM15              480   8-16-84  7:49p    "
  276.      COMM16              568   8-16-84  7:49p    "
  277.      COMM17              482   8-16-84  7:49p    "
  278.      COMM18              235   8-16-84  7:50p    "
  279.      COMM19              511   8-16-84  7:50p    "
  280.      COMM20              403   8-16-84  7:51p    "
  281.      COMM21              642   8-16-84  7:51p    "
  282.      COMM22              424   8-16-84  7:52p    "
  283.      COMM23              115   8-16-84  7:52p    "
  284.      COMM024             111   8-23-84  4:54p    "
  285.      COMM011             553   8-16-84  7:53p    "
  286.      COMM012             687   8-16-84  7:57p    "
  287.      COMM041             437   8-16-84  7:58p    "
  288.      COMM042             791   8-16-84  7:58p    "
  289.      COMM051             463   8-16-84  7:59p    "
  290.      COMM052             402   8-16-84  7:59p    "
  291.      COMM061             905   8-16-84  7:59p    "
  292.      COMM062             289   8-16-84  7:59p    "
  293.      COMM063             433   8-16-84  8:00p    "
  294.      COMM071             387   8-16-84  8:01p    "
  295.      COMM091             178   8-16-84  8:01p    "
  296.      COMM092            1189   8-16-84  8:01p    "
  297.      COMM093             321   8-16-84  8:02p    "
  298.      COMM0101            577   8-16-84  8:03p    "
  299.      COMM0111            577   8-16-84  8:03p    "
  300.      COMM0121            397   8-16-84  8:03p    "
  301.      COMM0181            237   8-16-84  8:04p    "
  302.      COMM0191            775   8-16-84  8:05p    "
  303.      COMM0192            585   8-16-84  8:05p    "
  304.      COMM0193            405   8-16-84  8:06p    "
  305.      COMM0194            377   8-16-84  8:07p    "
  306.      COMM0201            424   8-16-84  8:07p    "
  307.      COMM0202           1659   8-16-84  8:08p    "
  308.      COMM0203            280   8-16-84  8:08p    "
  309.      COMM0204            381   8-16-84  8:09p    "
  310.      COMM0205            383   8-16-84  8:09p    "
  311.      COMM0206            280   8-16-84  8:10p    "
  312.      COMM0211            144   8-16-84  8:11p    "
  313.      COMM0212            931   8-16-84  8:11p    "
  314.      COMM0221            563   8-16-84  8:11p    "
  315.      COMM0222            327   8-16-84  8:12p    "
  316.      GEN01              2262   8-16-84  8:14p    "
  317.      GEN02               203   8-16-84  8:15p    "
  318.      GEN03               379   8-16-84  8:15p    "
  319.      GEN04              4309   8-16-84  8:16p    "
  320.  
  321.     Total: 299,402
  322.