home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / simtel / cpmug / cpmug019.ark / CPM.DOC < prev    next >
Encoding:
Text File  |  1985-02-10  |  8.3 KB  |  215 lines
  1. CPM DOCUMENTATION
  2.  
  3.    THIS FILE CONTAINS SHORT DESCRIPTIONS OF THE FILES PROVIDED BY
  4. DIGITAL RESEARCH. FOR FURTHER DOCUMNENTATION SEE THE DIGITAL RESEARCH
  5. CPM REFERENCE MANUALS. THESE INCLUDE THE FOLLOWING:
  6.  
  7.      AN INTRODUCTION TO CP/M FEATURES AND FACILITIES
  8.      ED - A CONTEXT EDITOR FOR THE CP/M SYSTEM / USER'S GUIDE
  9.      CP/M ASSEMBLER (ASM) / USER'S GUIDE
  10.      CP/M DYNAMIC DEBUGGING TOOL (DDT) / USER'S GUIDE
  11.      CP/M INTERFACE GUIDE
  12.      CP/M SYSTEM ALTERATION GUIDE
  13.      BASIC-E REFERENCE MANUAL
  14.  
  15. THESE MANUALS (AND OTHERS, SUCH AS THE ML80 MANUAL) MAY BE OBTAINED
  16. EITHER FROM IMSAI OR DIRECTLY FROM DIGITAL RESEARCH, AT:
  17.  
  18.      DIGITAL RESEARCH
  19.      POST OFFICE BOX 579
  20.      PACIFIC GROVE, CALIFORNIA 93950
  21.      PHONE 408-649-3896
  22.  
  23. -----------------------------------------------------------------------
  24.  
  25. CCP (DIRECT) COMMANDS:
  26.  
  27.    IN THE FOLLOWING, UFN STANDS FOR 'UNAMBIGUOUS FILE NAME', WHICH
  28.    IS OF THE FORM 'N:NAME.TYPE', WHERE N IS A DISK NAME (A OR B, OR
  29.    CURRENT DISK IF OMITTED), NAME IS AN UP TO 8 CHARACTER FILE NAME,
  30.    AND TYPE IS AN UP TO 3 CHARACTER FILE TYPE. TYPICAL UFN'S ARE
  31.         FRED.ASM     B:TEST.COM     SALLY69     VOLUME.001
  32.  
  33.    AFN STANDS FOR 'AMBIGUOUS FILE NAME', WHICH FOLLOWS THE RULE ABOVE,
  34.    BUT THE CHARACTER ? MAY BE SATISFIED BY ANY SINGLE CHARACTER, AND
  35.    THE CHARACTER * MAY BE SATISFIED BY ANY STRING OF ANY LENGTH.
  36.    TYPICAL AFN'S ARE:   *.ASM     XDIR.80?     B:I*.*
  37.  
  38.    DIR AFN        - REQUEST LIST OF ALL FILE NAME IN THE DIRECTORY
  39.                     WHICH SATISFY THE AMBIGUOUS FILE NAME
  40.    ERA AFN        - ERASE ALL FILES WHOSE NAME SATISFIES THE 
  41.                     AMBIGUOUS FILE NAME
  42.    TYPE UFN       - TYPE THE FILE SPECIFIED ON THE CONSOLE
  43.    SAVE N UFN     - SAVE N (DECIMAL) PAGES (OF 256 BYTES EACH)
  44.                     ON DISK, WITH NAME SPECIFIED
  45.    REN UFN1=UFN2  - RENAME EXISTING FILE UFN2 WITH FIRST NAME SPECIFIED
  46.    UFN            - LOAD THE SPECIFIED FILE (ASSUMED TYPE 'COM') AND
  47.                     JUMP TO LOCATION 100H.
  48.  
  49. -----------------------------------------------------------------------
  50.  
  51. SYSGEN.COM
  52.  
  53.    CP/M UTILITY TO TRANSFER THE SYSTEM IMAGE FROM ONE DISKETTE TO ANY
  54.    OTHER. MAY ALSO BE USED JUST TO LOAD THE SYSTEM IMAGE INTO RAM, OR
  55.    VICA VERSA. 
  56.  
  57.    TYPICAL COMMAND:
  58.  
  59.       SYSGEN
  60.  
  61. -----------------------------------------------------------------------
  62.  
  63. STAT.COM
  64.  
  65.    UTILITY COMMAND TO REQUEST INFORMATION ABOUT REMAINING SPACE ON THE
  66.    CURRENT DISKETTE, OR SIZE DATA ON A PARTICULAR FILE OR GROUP OF FILES.
  67.  
  68.    TYPICAL COMMANDS:
  69.  
  70.       STAT           REQUEST INFO ON AVAILABLE SPACE
  71.       STAT ASM.COM   REQUEST SIZE DATA ON FILE 'ASM.COM'
  72.       STAT *.ASM     REQUEST SIZE DATA ON ALL FILES OF TYPE 'ASM'
  73.  
  74. ------------------------------------------------------------------------
  75.  
  76. PIP.COM
  77.  
  78.    GENERALIZED COPY UTILITY. MAY BE USED TO TRANSFER FILES FROM ONE DISK
  79.    TO ANOTHER, OR FROM POINT TO POINT ON ONE DISK, OR FROM DISK TO AN I/O
  80.    DEVICE (SUCH AS THE CONSOLE), OR FROM AN I/O DEVICE TO DISK.
  81.  
  82.    TYPICAL COMMANDS:
  83.  
  84.       PIP            START PIP AND ALLOW MULTIPLE COMMANDS TO BE ENTERED
  85.       PIP A:X=B:Y    TRANSFER FILE Y FROM DISK B TO FILE X ON DISK A
  86.       PIP B:FRED=A:  TRANSFER FILE FRED ON DISK A TO FILE FRED ON DISK B
  87.       
  88. -----------------------------------------------------------------------
  89.  
  90. ED.COM
  91.   
  92.    CONTEXT EDITOR. CREATES BACKUP FILE OF TYPE 'BAK' WITH NAME OF FILE
  93.    BEING EDITED. WRITES NEW FILE WITH NAME AND TYPE OF ORIGINAL FILE
  94.    FOR DETAILED DESCRIPTION OF EDITING COMMANDS, SEE CP/M MANUAL ON ED.
  95.  
  96.    TYPICAL COMMAND:
  97.  
  98.       ED TEST.ASM
  99.  
  100. -----------------------------------------------------------------------
  101.  
  102. ASM.COM
  103.  
  104.    SIMPLE INTEL-FORMAT ASSEMBLER. NO MACROS OR RELOCATABLE CODE, BUT IT
  105.    DOES HAVE CONDITIONAL ASSEMBLY. OTHERWISE REASONABLY COMPATIBLE WITH
  106.    INTEL STANDARD ASSEMBLER (HOWEVER NOTE THAT SYMBOLS MAY BE LONGER THAN
  107.    SIX CHARACTERS, WHICH IS THE MAX WITH THE INTEL ASSEMBLER.
  108.    THE NAME OF THE FILE (NO TYPE) IS SPECIFIED AS THE FIRST PARAMETER
  109.    IN THE INVOCATION. DO NOT SPECIFY TYPE 'ASM' - THE TYPE FIELD IS FOR
  110.    SPECIFYING WHICH DISK THE THREE FILES ARE ON. INPUT IS ASSUMED TO
  111.    BE ON FILE 'X.ASM', LISTING GOES TO FILE 'X.PRN' AND HEX OBJECT FILE
  112.    GOES TO FILE 'X.HEX' (WHERE 'X' IS THE NAME SPECIFIED IN THE COMMAND)
  113.  
  114.    LINES WITH ERRORS WILL BE LISTED TO THE CONSOLE DURING ASSEMBLY.
  115.  
  116.    TYPICAL COMMANDS:
  117.  
  118.       ASM TEST        - ASSEMBLE FILE TEST.ASM, CREATE TEST.PRN, TEST.HEX
  119.       ASM TEST.ABX    - ASSEMBLE FILE TEST.ASM (ON DISK A), CREATE FILE
  120.                         TEST.HEX (ON DISK B), AND SEND LISTING TO CONSOLE
  121.  
  122. -----------------------------------------------------------------------
  123.  
  124. LOAD.COM
  125.  
  126.    UTILITY PROGRAM TO TRANSLATE HEX FILES CREATED BY ASSEMBLER INTO
  127.    COM FILES (MEMORY IMAGE / AUTO LOAD). FILE TYPE NEED NOT BE SPECIFIED
  128.  
  129.    LOAD READS STANDARD INTEL HEX OBJECT FILES FROM FILE 'X.HEX', AND
  130.    CREATES A MEMORY IMAGE FILE ON FILE 'X.COM', WHERE X IS THE NAME
  131.    SPECIFIED IN THE COMMAND.
  132.  
  133.    TYPICAL COMMAND:
  134.  
  135.       LOAD TEST      - CREATE FILE TEST.COM FOR EXECUTION BY TYPING
  136.                        JUST THE NAME 'TEST'.
  137.  
  138. -----------------------------------------------------------------------
  139.  
  140. DDT.COM
  141.  
  142.    POWERFUL REAL-TIME DEBUGGING FACILITY, INCLUDING HEX MEMORY DUMP
  143.    AND EDIT, SIMPLE ASSEMBLER/DISASSEMBLER, BREAKPOINTS, EXECUTION
  144.    TRACE, AND REGISTER DISPLAY AND SET.
  145.  
  146.    FOR FURTHER DETAILS ON DDT, SEE THE CP/M DDT MANUAL.
  147.  
  148.    TYPICAL COMMANDS:
  149.  
  150.       DDT TEST.COM   - LOAD THE FILE TEST.COM DIRECTLY AND START
  151.       DDT TEST.HEX   - LOAD THE HEX OBJECT FILE ON TEST.HEX AND START 
  152.  
  153. -----------------------------------------------------------------------
  154.  
  155. DUMP.COM
  156.  
  157.    HEX FILEDUMP FACILITY. ALLOWS USER TO DISPLAY CONTENTS OF ANY DISK
  158.    FILE IN HEXADECIMAL. VERY USEFUL WHEN DEBUGGING PROGRAMS WHICH DO
  159.    DISK I/O. 
  160.  
  161.    TYPICAL COMMAND:
  162.  
  163.       DUMP TEST.COM   - DISPLAY CONTENTS OF FILE TEST.COM IN HEX
  164.  
  165. -----------------------------------------------------------------------
  166.  
  167. BASIC-E.COM
  168.  
  169.    BASIC COMPILER FROM NAVAL POSTGRADUATE LAB. TRANSLATES REASONABLY
  170.    STANDARD BASIC, WITH DISK I/O REFERENCES INTO MACHINE LANGUAGE FOR
  171.    A HYPOTHETICAL MACHINE. NOT PARTICULARY FAST OR ELEGANT. INPUT FILE
  172.    IS ASSUMED TO BE OF TYPE 'BAS', OUTPUT FILE WILL BE OF SAME NAME,
  173.    AS INPUT, BUT OF TYPE 'INT'. NOTE THAT THE OBJECT FILE CREATED IS
  174.    NOT 8080 CODE, AND MAY ONLY BE RUN ON THE 'RUN-E' 'INTERPRETER'
  175.    FOR FURTHER DETAILS, SEE THE CP/M BASIC-E REFERENCE MANUAL.
  176.  
  177.    TYPICAL COMMAND:
  178.  
  179.       BASIC-E DEMO      - COMPILE SOURCE PROGRAM ON 'DEMO.BAS' AND
  180.                           CREATE INTERNAL FILE ON 'DEMO.INT'
  181.  
  182. -----------------------------------------------------------------------
  183.  
  184. RUN-E.COM
  185.  
  186.    RUN-TIME 'INTERPRETER' FOR INT FILES CREATED BY BASIC-E. INPUT FILE
  187.    IS ASSUMED TO BE OF TYPE 'INT'. 
  188.  
  189.    TYPICAL COMMAND:
  190.  
  191.       RUN-E DEMO        - EXECUTE THE PROGRAM ORIGINALLY COMPILED FROM
  192.                           FILE 'DEMO.BAS'
  193.  
  194. -----------------------------------------------------------------------
  195.  
  196. SUBMIT.COM
  197.  
  198.    PROCEDURE FILE FACILITY. ALLOWS USER TO CREATE A STRING OF CP/M
  199.    CONSOLE COMMANDS ON A DISK FILE (OF TYPE 'SUB') AND HAVE THEM
  200.    EXECUTED ONE BY ONE. THE 'SUB' FILE MAY BE CREATED BY THE TEXT
  201.    EDITOR, AND CONTAINS LINE IMAGES OF LEGAL CP/M COMMANDS, FOLLOWED
  202.    BY CR AND LF. FOR EXAMPLE, SEE FILE ML.SUB. DUMMY PARAMETERS MAY
  203.    BE USED AT ANY POINT IN THE SUB FILE ($N, WHERE N IS AN INTEGER).
  204.    ANY FORMAL PARAMETERS SPECIFIED AT THE TIME THE SUBMIT COMMAND IS
  205.    INVOKED (SUBMIT XXX P1 P2 P3 ... PN, WHERE X IS THE NAME OF THE
  206.    'SUB' FILE, AND EACH PI IS A PARAMETER) WILL BE SUBSTITUTED INTO
  207.    THE TEXT OF THE SUB FILE POSITIONALLY. THE SYMBOL $1 WILL BE REPLACED
  208.    BY THE FIRST PARAMETER, ETC.
  209.  
  210.    TYPICAL COMMAND:
  211.  
  212.       SUBMIT ML XDIR      - SUBMIT FILE ML.SUB, WITH $1 REPLACED BY XDIR
  213.  
  214. -----------------------------------------------------------------------
  215.