home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpmug / cpmug036.ark / MAC6.DOC < prev    next >
Text File  |  1984-04-29  |  4KB  |  120 lines
  1.         * * * *  MAC6.DOC  * * * *
  2.  
  3.         MIKE FAVITTA - 5/16/79
  4.         2 JANET LANE
  5.         ALBANY, N.Y.  12203
  6.  
  7.  
  8.     THIS PROGRAM IS AN EXTENSION OF MAC4.ASM THAT IS ALREADY AVAILIBLE
  9.     FROM THE CP/M USERS GROUP. BOTH THESE PROGRAMS ADAPT THE TDL
  10.     MACRO-ASSEMBLER TO WORK WITH DISK FILES UNDER THE CP/M OPERATING
  11.     SYSTEM.
  12.  
  13.  
  14.     * ENHANCEMENTS PRESENT IN MAC6.AZM THAT ARE NOT IN MAC4.ASM *
  15.  
  16.  
  17.    1.    MULTI-EXTENSION SOURCE FILES (OVER 16K OF TEXT) MAY NOW BE
  18.     ASSEMBLED WITHOUT ERROR.
  19.  
  20.    2.    THE HIGHEST MEMORY AVAILIBLE FOR USE BY THE ASSEMBLER CALCULATION
  21.     HAS BEEN CORRECTED (IT IS POSSIBLE TO WRITE OVER THE FIRST JUMP
  22.     VECTOR FOR CP/M IF YOU RUN OUT OF MEMORY USING MAC4.ASM).
  23.  
  24.    3.    DIAGNOSTIC ERROR MESSAGES HAVE BEEN ADDED ALONG WITH INCREASED
  25.     ERROR DETECTION.
  26.  
  27.    4.    CONTROL OF THE ASSEMBLERS THREE PASSES HAS BEEN ADDED. IT IS
  28.     POSSIBLE TO GENERATE JUST A LISTING OR A OBJECT FILE BY
  29.     SPECIFYING OPTIONS ON THE ASSEMBLER CALL. NO OPTION CAUSES THE
  30.     DEFAULT CASE OF BOTH A LISTING AND A OBJECT FILE TO BE CREATED.
  31.  
  32.    5.    FOR USERS WITH DUAL DRIVE SYSTEMS THE EFFICIENCY OF ASSEMBLY HAS
  33.     BEEN INCREASED BY AUTOMATICALLY PLACING ANY OUTPUT FILES ON THE
  34.     DRIVE THAT DOES NOT CONTAIN THE SOURCE FILE. THIS GREATLY
  35.     REDUCES THE AMOUNT OF HEAD REPOSITIONING NECESSARY. IF YOU
  36.     ONLY HAVE A SINGLE DRIVE SYSTEM OR WANT TO OVER RIDE THIS FILE
  37.     PLACEMENT SCHEME, AN OPTION IS AVAILABLE TO FORCE ALL FILE I/O
  38.     TO ONLY THE CURRANTLY LOGGED IN DRIVE.
  39.  
  40.    6.    MAC6.AZM IS WRITTEN FOR THE Z-80 AND WILL NOT RUN ON A 8080 BASED
  41.     MICROCOMPUTER WITHOUT MODIFICATION.
  42.  
  43.  
  44.     * GENERATION NOTES *
  45.  
  46.  
  47.    1.    THE OBJECT CODE IS SUPPLIED IN A DIRECTLY EXECUTABLE FORM IN
  48.     THE FILE MAC6.COM. THIS FILE CONTAINS THE CODE FROM ASSEMBLING
  49.     MAC6.AZM AND IS SET TO RUN AT 100H. WHEN LOADED IT OCCUPIES
  50.     MEMORY FROM 100H TO 820H. THIS ALLOWS PEOPLE THAT DON'T HAVE
  51.     ANY Z-80 ASSEMBLER RUNNING UNDER CP/M TO STILL PUT THE TDL
  52.     ASSEMBLER UP ON THEIR SYSTEM.
  53.  
  54.    2.    PROCEDURE:
  55.  
  56.        A.    CREATE A FILE CALLED TDL.COM THAT CONTAINS THE TDL
  57.         ASSEMBLER SET TO RUN AT 800H.
  58.  
  59.         - USE TDL'S RELOCATING LOADER TO LOAD THE ASSEMBLER
  60.           AT 800H (R,800).
  61.  
  62.         - ENTER OR BOOT CP/M AND TYPE
  63.           SAVE 48 TDL.COM (CR)
  64.  
  65.        B.    USING DDT MERGE THE FILES TDL.COM AND MAC6.COM
  66.  
  67.         - ENTER DDT AND TYPE THE FOLLOWING COMMANDS
  68.  
  69.           ITDL.COM (CR)
  70.           R (CR)
  71.           IMAC6.COM (CR)
  72.           R (CR)
  73.           ^C (^C = CONTROL C)
  74.           SAVE 48 MASM.COM
  75.  
  76.         - THE TDL.COM FILE MUST BE READ IN FIRST AS PART OF MAC6.COM
  77.           OVERLAYS IT.
  78.  
  79.  
  80.     * NOTES ON OPERATION *
  81.  
  82.  
  83.    1.    FORMAT OF ASSEMBLER CALL:    MASM FILENAME OPTIONS
  84.  
  85.     - FILENAME NEVER HAS THE EXTENSION. IT IS ALWAYS ASSUMED TO BE AZM.
  86.     - OPTIONS AVAILIBLE ARE:
  87.         S - USE THE CURRANTLY LOGGED IN DRIVE FOR ALL FILES
  88.             (SINGLE DRIVE MODE)
  89.         L - PRODUCE A LISTING FILE ONLY (PASSES 1 AND 2)
  90.         O - PRODUCE A OBJECT FILE ONLY (PASSES 1 AND 3)
  91.     - ANY COMBINATION OF OPTIONS IS LEGAL EXCEPT OL AND LO
  92.     - IF NO OPTIONS ARE SPECIFIED THEN DUAL DRIVE MODE AND A COMPLETE
  93.       ASSEMBLY (PASSES 1, 2 AND 3) IS ASSUMED
  94.  
  95.    2.    SAMPLE MASM CALLS:
  96.  
  97.     - MASM TEST
  98.     - MASM TEST SL
  99.     - MASM TEST O
  100.  
  101.    3.    WHEN A DISK ERROR OCCURS THE FOLLOWING INFORMATION IS PROVIDED:
  102.  
  103.     - THE ADDRESS IN THE PROGRAM AT WHICH THE ERROR OCCURED
  104.     - THE STATUS RETURNED BY CP/M
  105.     - THE TYPE OF DISK FUNCTION THAT WAS ATTEMPTED
  106.  
  107.    4.    THE ASSEMBLY LISTING AND OBJECT CODE WILL BE IN FILES WITH THE
  108.     SAME FILE NAME AS THE SOURCE FILE AND WILL HAVE THE EXTENSIONS
  109.     PRN AND HXR. THE TDL PSUEDO-OPS .PABS AND .LOC 100H CAN BE USED
  110.     TO GENERATE CODE THAT CAN BE HANDLED BY CP/M'S LOAD PROGRAM (THE
  111.     EXTENSION MUST BE CHANGED TO HEX). OTHERWISE THE OBJECT FILE
  112.     CONTAINS FULLY RELOCATABLE CODE. A PROGRAM TO DIRECTLY
  113.     LOAD (ANY WHERE IN MEMORY YOU WANT) THESE FILES UNDER CP/M
  114.     IS BEING DEVELOPED AND WILL BE SUBMITTED TO THE CP/M USERS GROUP
  115.     SHORTLY. IT WILL BE CALLED RELOC.AZM.
  116.  
  117.    5.    THIS PROGRAM HAS BEEN EXTENSIVELY TESTED, BUT IF ANY ERRORS ARE
  118.     FOUND I WOULD APPRECIATE BEING NOTIFIED.
  119.  
  120.