home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpmug / cpmug036.ark / TOP.PRN < prev    next >
Encoding:
Text File  |  1984-04-29  |  4.1 KB  |  133 lines
  1.  
  2.  
  3.           
  4.           
  5.  
  6.                    * * * *  TOP.DOC  * * * *  
  7.           
  8.                    MIKE FAVITTA - 9/12/79  
  9.                    2 JANET LANE  
  10.                    ALBANY, N.Y.  12203  
  11.           
  12.           
  13.           THIS PROGRAM ADAPTS THE  TDL TEXT OUTPUT  PROCESSOR (TOP) TO
  14.           RUN UNDER CP/M. IT ALLOWS  TOP TO USE A  DISK FILE FOR INPUT
  15.           AND EITHER THE LIST DEVICE OR A DISK FILE FOR OUTPUT.  
  16.           
  17.           
  18.                * FEATURES PRESENT IN TOP.AZM * 
  19.           
  20.           
  21.           1.   DIAGNOSTIC ERROR MESSAGES ARE PRINTED ON DISK ERRORS.  
  22.           
  23.           2.   FOR USERS WITH DUAL DRIVE SYSTEMS THE EFFICIENCY OF 
  24.                PROCESSING HAS BEEN INCREASED  BY AUTOMATICALLY PLACING
  25.                THE OUTPUT FILE ON THE DRIVE  THAT DOES NOT CONTAIN THE
  26.                INPUT FILE. THIS  GREATLY  REDUCES  THE  AMOUNT OF HEAD
  27.                REPOSITIONING NECESSARY.  IF  YOU  ONLY  HAVE  A SINGLE
  28.                DRIVE SYSTEM OR WANT  TO OVER RIDE  THIS FILE PLACEMENT
  29.                SCHEME, AN OPTION IS AVAILABLE TO FORCE ALL FILE I/O TO
  30.                THE CURRANTLY LOGGED IN DRIVE ONLY.  
  31.           
  32.           3.   TOP.AZM IS WRITTEN USING TDL'S MACRO ASSEMBLER 
  33.                MNEMONICS AND WILL NOT RUN ON 8080 BASED SYSTEMS.  
  34.           
  35.           
  36.                    * GENERATION NOTES * 
  37.           
  38.           
  39.           1.   PROCEDURE: 
  40.           
  41.                A.   CREATE A FILE CALLED TDL.COM THAT CONTAINS THE TDL 
  42.                     TEXT OUTPUT PROCESSOR SET TO RUN AT 600H.  
  43.           
  44.                     -  USE  TDL'S   RELOCATING  LOADER   TO  LOAD  THE
  45.                     ASSEMBLER AT 600H  (R,600). RELOC.AZM  CAN ALSO BE
  46.                     USED.  
  47.           
  48.                     - ENTER OR BOOT CP/M AND TYPE 
  49.                       SAVE 20 TDL.COM (CR) 
  50.           
  51.           
  52.                B.   ASSEMBLE THE PROGRAM TOP.AZM USING TDL'S 
  53.                     ASSEMBLER.  
  54.           
  55.           
  56.                C.   RENAME THE OBJECT FILE TOP.HEX 
  57.           
  58.                     - REN TOP.HEX=TOP.HXR 
  59.           
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                                                               Page 2
  70.           
  71.  
  72.                D.  USING DDT MERGE THE FILES TDL.COM AND TOP.HEX 
  73.           
  74.                     - ENTER DDT AND TYPE THE FOLLOWING COMMANDS 
  75.           
  76.                       ITDL.COM (CR) 
  77.                       R (CR) 
  78.                       ITOP.HEX (CR) 
  79.                       R (CR) 
  80.                       ^C (^C = CONTROL C) 
  81.                       SAVE 20 TOP.COM 
  82.           
  83.                     - THE TDL.COM FILE  MUST BE READ  IN FIRST AS PART
  84.                     OF TOP.HEX OVERLAYS IT.  
  85.           
  86.           
  87.               * NOTES ON OPERATION * 
  88.           
  89.           
  90.           1.   FORMAT OF TOP CALL:     TOP FILENAME OPTIONS 
  91.           
  92.                - FILENAME  NEVER  HAS  THE  EXTENSION.  IT  IS  ALWAYS
  93.                ASSUMED TO BE TOP  OR DOC. THE  EXTENSION TOP IS ALWAYS
  94.                TRIED FIRST.  
  95.           
  96.                - OPTIONS AVAILIBLE ARE: 
  97.           
  98.                     S - USE  THE  CURRANTLY  LOGGED  IN  DRIVE FOR ALL
  99.                     FILES (SINGLE DRIVE MODE) 
  100.           
  101.                     D - ALL OUTPUT IS TO BE PLACED IN A DISK FILE WITH
  102.                     THE EXTENSION  PRN. (OUTPUT  NORMALLY GOES  TO THE
  103.                     LIST DEVICE) 
  104.           
  105.                - ANY COMBINATION OF  OPTIONS IS LEGAL  BUT S BY ITSELF
  106.                IS MEANINGLESS.  
  107.           
  108.           2.   SAMPLE TOP CALLS: 
  109.           
  110.                - TOP TEST 
  111.                - TOP TEST D 
  112.                - TOP TEST SD 
  113.           
  114.           3.   WHEN A DISK ERROR OCCURS THE FOLLOWING INFORMATION IS 
  115.                PROVIDED: 
  116.           
  117.                - THE ADDRESS IN THE PROGRAM AT WHICH THE ERROR OCCURED
  118.                - THE STATUS  RETURNED  BY  CP/M  -  THE  TYPE  OF DISK
  119.                FUNCTION THAT WAS ATTEMPTED 
  120.           
  121.           4.   THIS PROGRAM HAS BEEN EXTENSIVELY TESTED, BUT IF ANY 
  122.                ERRORS ARE FOUND I WOULD APPRECIATE BEING NOTIFIED.  
  123.                
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.