home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / simtel / sigm / vols000 / vol015 / catalog.016 < prev    next >
Encoding:
Text File  |  1984-04-29  |  7.7 KB  |  215 lines
  1. VOLUME 16
  2.  
  3. ASSEMBLERS, OTHER UTILITIES AND FOCAL
  4.  
  5. NUMBER    SIZE    NAME        COMMENTS
  6.  
  7.         CATALOG.16    CONTENTS OF CP/M GROUP VOL 16
  8.         VOLUME16.DOC    COMMENTS ON CERTAIN PROGRAMS
  9. 16.1    9K    ASMX.COM    ASSEMBLER WHICH RECOGNIZES Z-80 OPS
  10.                 SEE VOL.DOC  [CAREFUL: WITH CORRECT
  11.                 SYNTAX (ASMX FILENAME.AAA) THIS DOES
  12.                 WORK.  WITH FAULTY SYNTAX THE PROGRAM
  13.                 TAKES REVENGE ON THE DISK DIRECTORY.]
  14.                 RUNS OK ON 8080
  15. 16.2    12K    COPYDSK.ASM    DISK COPY PROGRAM. SEE VOL.DOC
  16. 16.3    13K    COPYDSK.MAC    AS 16.2 FOR TDL ASSEMBLER
  17. 16.4    7K    CPMUTIL.ASM    CP/M SUBROUTINES USEFUL GENARALLY AND
  18.                 EMPLOYED AS PART OF Z80ASM 16.17
  19. 16.5    3K    EDIT.COM    INTEL-LIKE EDITOR. DOES L F B AND -B
  20.                 MUCH FASTER THAN ED.COM. SEE VOL.DOC
  21. 16.6    8K    EDUCATOR.ASM    8080 INSTRUCTION SET TUTOR FROM BYTE
  22.                 OF JULY 1976
  23. 16.7    57K    FOCAL.ASM    FOCAL LANGUAGE INTERPRETER. SEE VOL.DOC
  24. 16.8    8K    MACASM.COM    MACRO ASSEMBLER. SEE VOL.DOC
  25. 16.9    2K    MOVDOWN.ASM    PROGRAM TO LOAD FILE WHICH OPERATES BELOW
  26.                 100H
  27. 16.10    2K    SEEK.ASM    SET DISK TRACK FROM FRONT PANEL DURING
  28.                 ALIGNMENT
  29. 16.11    9K    SPAT1.ASM    RE-WRITE OF 1.29 TO GENERALIZE CONSOLE FROM
  30.                 ORIGINAL VDM DEPENDANCY
  31. 16.12    2K    TASMIO.DOC    DOC FOR TASMIO PATCH TO PUT TDL TAPE ASSEMBLER
  32.                 UP ON CP/M
  33. 16.13    3K    TASMIO.HEX    SEE TASMIO.DOC
  34. 16.14    18K    TASMIO.MAC    SEE TASMIO.DOC
  35. 16.15    3K    TEST1A.ASM    SUCCESSFUL TEST FOR Z80ASM 16.17
  36. 16.16    1K    TEST2.ASM    UNSUCCESSFUL TEST FOR Z80ASM 16.17
  37. 16.17    9K    Z80ASM.COM    ZILOG MNEMONIC ASSEMBLER. RUNS ON 8080. SEE
  38.                 Z80DOC.DOC 16.18
  39. 16.18    4K    Z80DOC.DOC    DOC FOR 16.17
  40. 16.19    28K    Z80MAIN.ASM    SEE 16.17
  41. 16.20    4K    Z80OPCDS.ASM    SEE 16.17
  42. 16.21    11K    Z80SUBS.ASM    SEE 16.17
  43.  
  44.  
  45.  
  46.     Z80DOC.DOC explains the Z80 Assembler routines which
  47. follow.  Z80MAIN.ASM   Z80OPCDS.ASM   Z80SUBS.ASM   and the
  48. assembled program Z80ASM.COM.  TEST1A.ASM and TEST2.ASM are short
  49. test programs for the assembler.  This program was written and
  50. donated to the user group by Mike Lehman for unrestricted
  51. distrubution in the hobbyist community.
  52.     COPYDSK.MAC is a disk copy routine written by Frank
  53. Maclachlan in the TDL assembler format.  It is very different
  54. from the version in Vol. 1 and performs a read and write
  55. verify.  This routine was also rewritten for the CPM assembler
  56. by Dick Mason and is included as COPYDSK.ASM.
  57.     TASMIO.DOC explains how to patch the TDL Assembler to
  58. operate with the CP/M system.  It includes TASMIO.HEX and
  59. TASMIO.MAC.  The last one would be useful for any future
  60. modifications.  This routine was written and donated by Frank
  61. Maclachlan.
  62.     SEEK.ASM is a simple utility routine which allows you
  63. to select a desired track on a drive during alignment by use
  64. of the front panel sense switches.
  65.     SPAT1.ASM is a modified version of SPAT.ASM from Vol. 1
  66. which is good for any terminal, not just the VDM.  Control
  67. characters have been removed from the ASCII print and periods
  68. inserted in their places.  This modification was made by Dick
  69. Mason.
  70.     MOVDOWN.ASM is a program used in conjunction with 
  71. those that do not start a location 100.  It loads them at
  72. location 100 and then automaticlly moves them to 0 or some
  73. other address and starts.  This was written by Dick Mason.
  74.     CPMUTIL.ASM is a different set of utilities for the
  75. various I/O routines.  This was also donated by Mike
  76. Lehman.
  77.  
  78. MACASM -- THIS IS A MACRO ASSEMBLER WITH CHARACTERISTICS SIMILAR
  79.     TO THE INTEL ASSEMBLER.  WHEN USED UNDER CP/M, IT HAS
  80.     THE FOLLOWING ADDITIONAL FEATURE:  ANOTHER OPTION FOR THE 
  81.     LIST FILE IS THE LETTER 'P' WHICH SENDS THE LISTING TO THE
  82.     LIST DEVICE DIRECTLY; E.G., ONE MIGHT TYPE
  83.   
  84.         MACASM LLLBASIC.AZP
  85.  
  86.     THIS WILL SEND THE LISTING DIRECTLY TO THE LIST DEVICE.
  87.   
  88.     THERE IS AT LEAST ONE KNOWN BUG (THE FIX IS UNKNOWN, HOWEVER)
  89.     AND THAT IS THAT SOMETIMES WITH NESTED MACROS, LOCATIONS 5,6,
  90.     AND 7 ARE CLOBBERED; THIS OF COURSE, KILLS COMMUNICATION
  91.     WITH CP/M AND ALL IS DEAD.
  92.   
  93. ASMX -- THIS IS ANOTHER ASSEMBLER, WITHOUT MACROS, BUT WITH CROSS-
  94.     REFERENCE MAP.  IT ALSO RECOGNIZES MNEMONICS FOR THE Z80.
  95.     THE MNEMONICS IT RECOGNIZES ARE SIMILAR TO THOSE PROMULGATED
  96.     BY TDL WITH THE EXCEPTION OF INDEX REGISTER OPERATIONS AND 
  97.     THE INSTRUCTION DSBB (TDL USES DSBC).  ASSEMBLE THE FILE
  98.     Z80-OPS.ASM TO SEE THE INDEX REGISTER OP CODE SYNTAX.
  99.   
  100.     ---- CHARACTERISTICS OF THIS ASSEMBLER ---
  101.   
  102.     THE ASSEMBLER DOES NOT RECOGNIZE '!'
  103.  
  104.     THE DISK BUFFERS ARE ONLY 128 BYTES, SO THERE MAY BE MORE DISK
  105.     ACTIVITY THAN WITH ASM.COM
  106.  
  107.     LABELS MUST BEGIN IN COLUMN ONE, AND SIX CHARACTERS OF THE
  108.     LABEL ARE USED.
  109.   
  110.     INSTRUCTIONS MAY NOT BEGIN IN COLUMN ONE
  111.  
  112.     THE ASSEMBLER DOES NOT MIND LABELS THAT ARE THE SAME AS OP-
  113.     CODES,E.G. JMP,ADD,SUB,END, ETC.
  114.   
  115.     LABELS NEED NOT BE FOLLOWED BY A COLON.
  116.  
  117.     CERTAIN ADDITIONAL PSEUDO-OPS ARE RECOGNIZED:
  118.   
  119.     LIST    -L    ;TURNS OFF THE LISTING
  120.  
  121.     LIST    L    ;TURNS THE LISTING BACK ON
  122.  
  123.     TP        ;TABULATE PAGE- MOVES THE PC TO THE NEXT PAGE
  124.  
  125.     TM    VAL    ;IF <VAL> BYTES REMAIN IN THE CURRENT PAGE,
  126.             ;THEN NOTHING HAPPENS; OTHERWISE MOVE THE PC
  127.             ;TO THE NEXT PAGE (IN OTHER WORDS, MAKE SURE
  128.             ;THAT AT LEAST <VAL> BYTES REMAIN IN THE CURRENT
  129.             ;PAGE)
  130.   
  131.     BASE    8    ;CAUSES LISTING IN OCTAL
  132.  
  133.     BASE    16    ;CAUSES LISTING IN HEX
  134.  
  135. EDIT -- THIS IS AN EDITOR SIMILAR TO CP/M'S ED.COM, BUT WITH COMMAND
  136.     SYNTAX LIKE INTEL'S EDITOR FOR THOSE OF YOU WHO ARE USED TO 
  137.     THAT.  THE ESCAPE CHAR IS USED AS A DELIMITER IN COMMAND LINES
  138.     (IT IS ECHOED AS A $), AND A DOUBLE ESCAPE IS USED TO TERMINATE
  139.     A COMMAND LINE. THIS EDITOR IS MUCH FASTER THAN EITHER THE INTEL
  140.     EDITOR OR ED.COM; UNLIKE THE INTEL EDITOR, THIS ONE DOES HAVE 
  141.     THE 'N' COMMAND AND THE 'Q' COMMAND; IT DOES NOT HAVE THE 'R'
  142.     COMMAND, HOWEVER.  ANOTHER DIFFERENCE WITH RESPECT TO THE 
  143.     INTEL EDITOR IS THAT THE 'A' COMMAND ONLY APPENDS ONE LINE,
  144.     BUT YOU CAN SAY 9999A TO APPEND MUCH.  THE EDITOR CREATES
  145.     A THIRD FILE WITH TYPE $$$ WHICH IS RENAMED WHEN THE EDIT JOB
  146.     IS COMPLETE.  THIS MEANS THAT IF YOU ARE EDITING A FILE WHICH
  147.     OCCUPIES OVER HALF OF THE DISK, YOU MUST ERASE ANY PRE-EXISTING
  148.     BACK-UP FILE SO THAT THERE WILL BE ROOM FOR THE TEMPORARY.  IF 
  149.     YOU DON'T, YOU WILL GET A DISK FULL ERROR.  IN FIND OR 
  150.     SUBSTITUTE COMMANDS, THE CHARACTER '|' WILL MATCH ANY CHARACTER.
  151.     IF YOU WANT TO CHANGE THIS CHARACTER, LOOK FOR THE SEQUENCE
  152.     FE, 7C  IN THE CODE AND CHANGE THE 7C TO THE CHARACTER YOU
  153.     PREFER.
  154.  
  155.     [A.R.G SUMMARY OF COMMANDS COMPARED WITH ED.COM
  156.  
  157.     NOTE () ARE TO INDICATE A CONTROL CHARACTER, <> USED LITERALLY
  158.  
  159.     ED.COM        EDITOR.COM    
  160.  
  161.     B        B
  162.     -B        Z
  163.     E        E
  164.     Q        Q
  165.     C        C
  166.     T        T
  167.     L        L
  168.     K        K
  169.     D        D
  170.     I        I
  171.     A        A
  172.     W        W
  173.     N        N
  174.     #        65536
  175.     M        <>        SEE EXTENDED COMMAND BELOW  
  176.     P        NONE
  177.     H        NONE
  178.     O        NONE
  179.     R        NONE
  180.     (SUB)        (ESC)        (AS TERMINATOR IN SEARCHES)
  181.     (CR)        (ESC) (ESC) (TO EXECUTE COMMANDS)
  182.     (CR)        NONE        (TO CAUSE LT SEQUENCE)
  183.     ANY CHARACTER    (NUL)        (TO INTERUPT PRINTING)
  184.  
  185.  
  186.     EXTENDED COMMAND:
  187.  
  188.     2MF.ASM(SUB)0LK(CR)  2<F.ASM(ESC)0LK>(ESC)(ESC)   
  189.  
  190.  
  191.     CONTROL CHARACTERS REFERENCED ABOVE:
  192.  
  193.     (CR)    :=    0DH    ^M    RETURN
  194.     (SUB)    :=    1AH    ^Z
  195.     (ESC)    :=    1BH    ^[    ESCAPE
  196.     (NUL)    :=    00H    ^@    BREAK        ]
  197.  
  198.  
  199.   
  200. FOCAL.ASM -- THIS IS THE FOCAL THAT PROCESSOR TECHNOLOGY WAS 
  201.     DISTRIBUTING IN 1976 ON BLUE XEROX-PROOF PAPER.  IT HAS SOME
  202.     KNOWN BUGS: EXPONENTIATION DOESN'T WORK AND IT HAS NO OPERATOR
  203.     PRECEDENCE.  I HAVE ADDED A FEW THINGS:  I/O FOR CP/M (JUST
  204.     CONSOLE I/O) AND A ROUTINE TO LIST THE ERROR MESSAGES.  LOAD
  205.     FOCAL WITH DDT AND JUMP TO 103H; A LIST OF THE ERROR MESSAGES
  206.     WILL BE PRINTED.  A NOTE OF INTEREST-THE FLOATING POINT PACKAGE
  207.     IN FOCAL IS FROM THE INTEL USERS LIBRARY AND WAS ORIGINALLY
  208.     WRITTEN FOR THE 8008 CPU.
  209.     [A.R.G. I understand that the exponentiation error only
  210.     occurs (symptom x^y results in y^y) with the 100H origin.
  211.     May give a clue to finding page-dependant routine]
  212.  
  213. EDUCATOR.ASM -- THIS IS FROM BYTE MAGAZINE OF JULY 1976
  214.  
  215.