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