to what to do with your work file: SAVE AS CURRENT - which makes the definitions in your work file  effective immediately upon exiting this program SAVE ON CP/M DISK - which will cause the definitions in yo KEYS- which allows you to modify key definitions. ASSIGN LOGICAL/PHYSICAL COLORS - which allows you to redefine the meaning  associated with a particular color. EXIT AND SAVE YOUR WORK FILE - This is provided here as a quic CURRENT DEFINITIONS - which represent the most recently loaded set of  definitions. DEFINITIONS ON CP/M BOOT DISK - which represent the set of definitions stored  on your boot disk, norma the fifth choice - "exit and save work file". (NOTE: To view the up arrow, down arrow or return key, type the desired key and the control key simultaneously). ///2Setting_Up  Setting Up Your Work File Thselect the specific (1 of 4) value of the key that you want to modify. To do this, type the key so that the four values associated with it are displayed. Use the up and down arrow keys to scroll through the four values; type the return key to  will be asked to select the logical color you want to assign (type the letter in the box with the color you want from the top map). Then you will be asked for the physical color you want assigned to it (type the letter in the box with the coE mode.  This mode is obtained by typing the COMMODORE key and  stays in effect until you type it again. ///2Log/Phy_Clrs  Assigning Logical/Physical Colors Once you have chosen to assi - which represents the unshifted value of the key as  labelled. SHIFTED value - which represents the values of the keys, as labelled,  obtained by typing the desired key and the shift key  the string and CONTROL RIGHT SHIFT + or - to insert or delete a character respectively. To assign a single hex value, type CONTROL,RIGHT SHIFT and LEFT ARROW key simultaneously. Again, a window will pop up at the bottom of the screen dit a string type the CONTROL KEY, the RIGHT SHIFT key and the RIGHT ARROW key simultaneously, then type the key to which you want to assign the string. Note that the key you pick must already have a string value (80-9F) assigned to it. ur work file  to be loaded the next time you boot from the disk  to which it was saved DON'T SAVE - a means of exiting if you made a mistake or changed  yk means of  copying one set of definitions to another. For example,  loading the default definitions into your work file and saving  them as the current definitions, provides a means of restoring lly default definitons,  unless you replace them via this program. ///3What_To_Do  What To Do With Your Work File Once your work file is set up, you will be given a choice of 3 things to do: EDITe first thing you will be asked to do is set up your work file. You will be given a choice of 3 sources from which you can do this: DEFAULT DEFINITIONS - which basically represent a standard set of key  definitions. select the value that is highlighted. This is the specific key value that will be modified. The next time you view this key the new value you assigned will be displayed. You can modify as many keys as you want. When you are done, select lor you want, from the bottom map.) You can assign as many colors as you want; type the RETURN key when you are finished. ///2Select_a_Key  Selecting a Key to Edit To select a key for editing, you must actually gn logical/physical colors, you will be given a choice of doing this for either a 40 or an 80 column screen. Then, two color maps will be displayed. The top one is the current logical color map; the bottom one is the physical color map. You simultaneously. CONTROL value - which represents the value of the key obtained by typing  the desired key and the CONTROL key simultaneously. CAPS LOCK value - which represents the value obtained while in COMMODOR showing the current hex value. Enter the new hex value. NOTE that any illegal key will abort the edit without modifying the key. ///2Key_Values " Key Values Each key has 4 values associated with it: normal valueA window will pop up at the bottom of the screen, in which you will edit. Type the string and type CONTROL, RIGHT SHIFT, RETURN to exit. For editing, you can use CONTROL, RIGHT SHIFT, RIGHT ARROW or LEFT ARROW to move right or left through our mind. ///2For_Experts  For Experts Only The C128 allows you to edit key definitions directly, without using the KEYFIG program. There are 2 alternatives: edit a string or assign a single hex value. To e%ADDCP/M PLUS 652AU fier} " {,filespec{modifier} ... } Explanation: A library is a file that contains a collection of object modules. Use the LIB utility to create libraries, and to append, replace, select or delete modules frarch's relocatable macro-assembler program, RMAC, or any other language translator that pruduces modules in Microsoft REL file format. You can use LINK-80 to link the object modules contained in a library to other object file of type .IRL. LINK-80 searches faster on indexed libraries than on non-indexed libraries.  M The MODULE option displays module names.  P The PUBLICS option displays module names and the publ select modules in a library file. Angle brackets enclose the modules to be deleted or replaced. Parentheses enclose the modules to be selected.  LIB Modifiers  Delete odLAST,mod1,mod2,...,modN) ///2Examples A>LIB TEST4[P]  Displays all modules and publics in TEST4.REL. A>LIB TEST5[P]=FILE1,FILE2  Creates TEST5.REL from FILE1.REL and FILE2.REL and displays  all modules and publiated between them,  as well as module C6 from TEST2.REL. A>LIB FILE2=FILE3  Creates FILE2.REL from FILE3.REL, omitting MODA which is  a module in FILE3.REL. A>LIB FILE6=FILE5  Creates F HISNAME. A>LIB FILE1[I]=B:FILE2(PLOTS,FIND,SEARCH-DISPLAY)  Creates FILE1.IRL on drive A from the selected modules  PLOTS, FIND, and modules SEARCH through the module  DISPLAY, in FILE2.REL on drive B. ///1L. Relocatable files can contain external references and publics. Relocatable files can reference modules in library files. LINK searches the library files and includes the referenced modules in the output file. See the e brackets. Multiple switches are separated by commas.  LINK-80 Options A Additional memory; reduces buffer space  and writes temporary data to disk B   your current definitions after running an application which may  have used a now undesired set of key definitions. ///1LIB Syntax: LIB filespec{[I|M|P|D]} LIB filespec{[I|M|P]}=filespec{modiom an existing library. Use LIB to obtain information about the contents of library files. LIB creates and maintains library files that contain object modules in Microsoft REL file format. These modules are produced by Digital Reses. LINK-80 automatically selects from the library only those modules needed by the program being linked, and then forms an executable file with a filetype of COM. ///2Options  I The INDEX option creates an indexed library file ic variables for the new library file.  D The DUMP option displays the contents of object modules in ASCII form. ///2Modifiers Use modifiers in the command line to instruct LIB to delete, replace, or  Replace  If module name and filename are the  same this shorthand can be used:   Select (modFIRST-mcs in TEST5.REL. A>LIB TEST=TEST1(MOD1,MOD4),TEST2(C1-C4,C6)  Creates a library file TEST.REL from modules in two source  files. TEST1.REL contributes MOD1 and MOD4. LIB extracts  modules C1, C4, and all the modules locILE6.REL from FILE5.REL, FILEB.REL replaces MODA. A>LIB FILE6=FILE5  Module THISNAME is in FILE5.REL. When LIB creates  FILE6.REL from FILE5.REL the file THISNAME.REL replaces the  similarly named module TINK Syntax: LINK d:{filespec,{[options]}=}filespec{[options]}{,...} Explanation: LINK combines relocatable object modules such as those produced by RMAC and PL/I-80 into a .COM file ready for execution CP/M 3 Programmer's Utilities Guide for a complete description of LINK- 80. ///2Options Use LINK option switches to control execution parameters. Link options follow the file specifications and are enclosed within squar BIOS link in banked CP/M 3 system.  1. Aligns data segment on page boundary.  2. Puts length of code segment in header.  3. Defaults to .SPR filetype. Dh Data origin; s  Memory size; Define free memory  requirements for MP/M modules. NL No listing of symbol table at console NR No symbol table file OC Output .COM command file. Default  MP/M OS Output .SPR system page relocatable file  for execution under MP/M Ph Program origin; changes default  program origin address to h.  Defaul  or Z (zero output). Default is X. $Id Source of intermediate files;  d is disk drive A-P. Default  is current drive. $Ld Source of library files;  first file in the LINK-80 command. $Sd Destination of symbol file;  d can be Y or Z or disk drive A-P.  Default is to same drive as  first file in LINK-80 command. / 1,m2,m3  LINK-80 combines the separately compiled files m1, m2, and  m3, resolves their external references, and produces the  executable machine code file m1.COM. A>LINK m=m1,m2,m3  LINK-80 combines the separatelrenced  subroutines contained in FILE5.REL on the default drive  A and produces MYFILE.COM on drive A. ///1mac Syntax:  MAC filename {$options} Explanation: MAC, the CP/M 3 macro assembler, reads assem de. Filename.PRN contains an annotated source listing that you can print or examine at the console. Filename.SYM contains a sorted list of symbols defined in the program. ///2Examples A>MAC SAMPLE A>MAC SAMPLE $PB nd Z specify console, printer, and zero output, respectively.  Assembly Options That Direct Input/Output A source drive for .ASM file (A-O) H destination drive for .HEX file (A-O, Z) L source drive for macrolibraread from macrollibrary .LIB files -L suppresses listing (default) +M lists all macro lines as they are processed during assembly -M suppresses all macro lines as they are read during assembly *M lists only hex generated by macro expanets memory origin for  common and data area Gn Go; set start address to label n Lh Load; change default load address  of module to h. Default 0100H Mh  OP Output .PRL page relocatable file for  execution under MP/M in relocatable  segment OR Output .RSP resident system process file  for execution undert is 0100H. Q Lists symbols with leading question mark S Search preceding file as a library $Cd Destination of console messages  d can be X (console), Y (printer),   d is disk drive A-P. Default  is current drive. $Od Destination of of object file;  d can be Z or disk drive A-P.  Default is to same drive as  //2Examples A>LINK b:MYFILE[NR]  LINK-80 on drive A uses as input MYFILE.REL on drive B and  produces the executable machine code file MYFILE.COM on  drive B. The [NR] option specifies no symbol table file. A>LINK my compiled files m1, m2, and  m3 and produces the executable machine code file m.COM. A>LINK MYFILE,FILE5[s]  The [s] option tells LINK-80 to search FILE5 as a library.  LINK-80 combines MYFILE.REL with the refebly language statements from a file of type .ASM, assembles the statements, and produces three output files with the input filename and filetypes of .HEX, .PRN, and .SYM. Filename.HEX contains INTEL hexadecimal format object coAA HB SX ///2options Use options to direct the input and output of MAC. Use a letter with the option to indicate the source and destination drives, and console, printer, or zero output. Valid drive names are A thru O. X, P a y .LIB files called by the MACLIB statement. P destination drive for .PRN file (A-O, X, P, Z) S destination drive for .SYM file  Assembly Options That Modify Contents Of Output File +L lists input lines rsions +Q lists all LOCAL symbols in the symbol list -Q suppresses all LOCAL symbols in the symbol list (default) +S appends symbol file to print file -S suppresses creation of symbol file +1 produces a pass 1 listing for macro s. The patch number n must be between 1 and 32 inclusive. Example: A>PATCH SHOW 2  Patches the SHOW.COM system file with patch number 2. ///1PIP (copy) Syntax:  DESTINATION SOURCE  PI first filespec is the destination. The second filespec is the source. Use two or more source filespecs separated by commas to combine two or more files into one file. [o] is any combination of the available options. The [Gn] option in any CP/M 3 logical device. ///2Examples COPY A FILE FROM ONE DISK TO ANOTHER  A>PIP b:=a:draft.txt  A>PIP b:draft.txt = a:  B3>PIP myfile.dat=A:[G9]  A9>PIP B:[G3]=myfile.dat COPY A FILE AND RENAME IT   COMBINE MULTIPLE FILES  A>PIP b:new.dat=file1.dat,file2.dat COPY, RENAME AND PLACE IN USER 1  A>pip newdraft.txt[g1]=oldraft.txt COPY, RENAME AND GET FROM USER 1  A>PIP newdraft.txt=oldraft.txt[g1] COPY TO/FROM last copy. C Confirm. PIP prompts for confirmation before each file copy. Dn Delete any characters past column n. E Echo transfer to console. F Filter form-feeds from source data. Gn Get from or go to user n. H Test for vaage length to n. (default n=60) Qs^Z Quit copying from source at string s. R Read files that have been set to SYStem. Ss^Z Start copying from the source at the string s. Tn Expand tabs to n spaces. U Translate lower case to upper ca inated by a ^Z. ///1PUT Syntax:  PUT CONSOLE {OUTPUT TO} FILE filespec {option} | CONSOLE  PUT PRINTER {OUTPUT TO} FILE filespec {option} | PRINTER  PUT CONSOLE {OUTPUT TO} CONSOLE  PUT PRINTER {OUTPUT TO} PRINTER Euntil the program terminates. Then printer output is put back to the printer. PUT with the SYSTEM option directs all subsequent console/printer output to the specified file. This option terminates when you enter rect console output  to a file. NO ECHO specifies that file output is not echoed to the  console. NO ECHO is the default for the PUT PRINTER  command. FILTER specifies filtering of condebugging in .PRN file -1 suppress listing on pass 1 (default) ///1PATCH Syntax: PATCH filename{.typ} {n} Explanation: The PATCH command displays or installs patch number n to the CP/M 3 system or command fileP d:{Gn} | filespec{[Gn]} = filespec{[o]},... | d:{[o]} Explanation: The file copy program PIP copies files, combines files, and transfers files between disks, printers, consoles, or other devices attached to your computer. Thethe destination filespec tells PIP to copy your file to that user number. PIP with no command tail displays an * prompt and awaits your series of commands, entered and processed one line at a time. The source or destination can be A5>PIP newdraft.txt=oldraft.txt  C8>PIP b:newdraft.txt=a:oldraft.txt COPY MULTIPLE FILES  A>PIP b:=draft.*  A>PIP b:=*.*  B>PIP b:=c:.*.*  C>PIP b:=*.txt[g5]  C>PIP a:=*.com[wr]  B>PIP a:[g3]=c:*.*  LOGICAL DEVICES  A>PIP b:funfile.sue=con:  A>PIP lst:=con:  A>PIP lst:=b:draft.txt[t8]  A>PIP prn:=b:draft.txt ///2options PIP OPTIONS A Archive. Copy only files that have been changed since the  lid Hex format. I Ignore :00 Hex data records and test for valid Hex format. K Kill display of filespecs on console. L Translate upper case to lower case. N Number output lines O Object file transfer, ^Z ignored. Pn Set pse. V Verify that data has been written correctly. W Write over Read Only files without console query. Z Zero the parity bit. All options except C,G,K,O,R,V and W force an ASCII file transfer, character by character, termxplanation: PUT puts console or printer output to a file for the next command entered at the console, until the program terminates. Then console output reverts to the console. Printer output is directed to a file the PUT CONSOLE or PUT PRINTER command. ///2Options [ {ECHO | NO ECHO} {FILTER | NO FILTER} | {SYSTEM} ] ECHO specifies that output is echoed to the console. This  is the default option when you ditrol characters, which  means that control characters are translated to  printable characters. For example, an ESCape  character is translated to ^[. NO FILTER means that PUT does no written to the file until a  subsequent PUT CONSOLE command redirects console  output back to the console. ///2Examples A>PUT CONSOLE OUTPUT TO FILE XOUT [ECHO]  Directs console output to file XOUT ILE XOUT2 [ECHO,SYSTEM]  Directs all printer output to file XOUT2 as well as to the  printer (with ECHO option), and the PUT is in effect until  you enter a PUT PRINTER OUTPUT TO PRINTER command. A>PUT CONSOLE OUTPUT TO CONS RENAME lets you change the name of a file in the directory of a disk. To change several filenames in one command use the * or ? wildcards in the file specifications. The RENAME command can be abbreviated REN. REN prompts you for input.  .PRN=X .PRN A> File X.PRN is renamed to Y.PRN on drive A. B>REN A:PRINTS.NEW = PRINCE.NEW  The file PRINCE.NEW on drive A changes to PRINTS.NEW on  drive A. A>RENAME S*.TEX=A*.TEX  The abov first one, it  is unnecessary in this example. The command line above has  the same effect as the following: A>REN B:NEWLIST=OLDLIST  or A>REN NEWLIST=B:OLDLIST ///1RMAC Syntax:  utput files. Replace d with the destination drive letter for the output files.  Option d=output option R- drive for REL file (A-O, Z) S- drive for SYM file (A-O, X, P, Z) P- driv the file TEST.ASM from drive A, sends the listing  file (TEST.PRN) to the console, puts the symbol file  (TEST.SYM) on drive B and puts the relocatable object  file (TEST.REL) on drive B. ///1SAVE Syntax: for a filespec to which it copies the contents of memory, and the beginning and ending address of the memory to be SAVEd. ///2Example A>SAVE Activates the SAVE utility. Now enter the name of the program which loads a filr 3.0  Enter file (type RETURN to exit):dump2.com If file DUMP2.COM exists already, the system asks:  Delete dump2.com? Y Then the system asks for the bounds of memory to be saved:  Beginning hex address: 100  Endit translate control  characters. This is the default option. SYSTEM specifies that system output as well as program  output is written to the file specified by  filespec. Output is  with the output echoed  to the console. A>PUT PRINTER OUTPUT TO FILE XOUT A>MYPROG  Directs the printer output of program MYPROG to file  XOUT. The output is not echoed to the printer. A>PUT PRINTER OUTPUT TO FOLE  Directs console output back to the console. A>PUT PRINTER OUTPUT TO PRINTER  Directs printer output back to the printer. ///1RENAME Syntax:  RENAME {new-filespec=old-filespec} Explanation:  ///2Examples A>RENAME NEWFILE.BAS=OLDFILE.BAS  The file OLDFILE.BAS changes to NEWFILE.BAS on drive A. A>RENAME The system prompts for the filespecs: Enter New Name:X.PRN Enter Old Name:Y.PRN Y e command renames all the files matching  A*.TEX to files with filenames S*.TEX. A>REN B:NEWLIST=B:OLDLIST  The file OLDLIST changes to NEWLIST on drive B. Since the  second drive specifier, B: is implied by the  RMAC filespec {$Rd | $Sd | $Pd} Explanation: RMAC, a relocatable macro assembler, assembles .ASM files of into .REL files that you can link to create .COM files. ///2options RMAC options specify the destination of the oe for PRN file (A-O, X, P, Z) A-O specifies drive A-O. X means output to the console. P means output to the printer. Z means zero output. ///2Example A>RMAC TEST $PX SB RB  Assembles SAVE Explanation: SAVE copies the contents of memory to a file. To use SAVE, first issue the SAVE command, then run your program which reads a file into memory. Your program exits to the SAVE utility which prompts you e into memory.  A>SID dump.com Next, execute the program.  #g0 When the program exits, SAVE intercepts the return to the system and prompts the user for the filespec and the bounds of memory to be SAVEd.  SAVE Veng hex address: 400 The contents of memory from 100H (Hexadecimal) to 400H is copied to file DUMP2.COM. ///1SET Syntax: SET [options] SET d: [options] SET filespec [options] Explanation: SET files, you must first run INITDIR to format the disk directory. ///2Label Syntax: SET {d:} [NAME=labelname.typ] SET [PASSWORD=password] SET [PASSWORD= ///3Examples A>SET [NAME=DISK100]  SET [PROTECT=OFF] SET filspec [PASSWORD=password] SET filespec [PROTECT=READ] SET filespec [PROTECT=WRITE] SET filespec [PROTECT=DELETE] SET filespec [PROTECT=NONE] SET filespec [attribute  The password is required for writing, deleting or  renaming the file. You do not need a password to  read the file. DELETE The password is only required for deleting or  renaming ssword. ///2Attributes RO sets the file attribute to Read-Only. RW sets the file attribute to Read-Write. SYS sets the file attribute to SYS. DIR sets the file attribute to DIR. AR IP when copying a group of files with the PIP  [A] option. SHOW and DIR display the Archive  option. F1=ON|OFF turns on or off the user-definable file attribute  F1. F2=ON|OFF t. ///3Examples SET [PROTECT=ON]  Turns on password protection for all the files on the disk.  You must turn on password protection before you can assign  passwords to files. SET [PROTECT=OFF]  Disables pass drive B.  Each TEX file is given a WRITE protect mode to prevent  unauthorized editing. A>SET MYFILE.TEX [RO SYS]  Sets MYFILE.TEX to Read-Only and SYStem. ///2Default A>SET [DEFAULT=dd]  Instructs the scommands allow you to keep a record of the time and date of file creation and update, or of the last access and update of your files. ///3Options [CREATE=ON] turns on CREATE time stamps on the disk in the  defa default or specified drive. ACCESS and CREATE  options are mutually exclusive; only one can be in  effect at a time. If you turn on the ACCESS time  stamp on a disk that previously had initiates password protection and time stamping of files. It also sets the file and drive attributes Read-Write, Read-Only, DIR and SYS. It lets you label a disk and password protect the label. To enable time stamping of  Labels the disk on the default drive as DISK100. A>SET [PASSWORD=SECRET]  Assigns SECRET to the disk label. A>SET [PASSWORD=  Nullifies the existing password. ///2Passwords SET [PROTECT=ON] -options] ///3Modes  Password Protection Modes Mode Protection READ The password is required for reading, copying  writing, deleting or renaming the file. WRITE  the file. You do not need a password to  read or modify the file. NONE No password exists for the file. If a password  password exists, this modifier can be used to  delete the paCHIVE=OFF means that the file has not been backed up  (archived). ARCHIVE=ON means that the file has been backed up (archived).  The Archive attribute can be turned on by SET or  by Purns on or off the user-definable file attribute  F2. F3=ON|OFF turns on or off the user-definable file attribute  F3. F4=ON|OFF turns on or off the user-definable file attribute  F4word protection for the files on your disk. A>SET MYFILE.TEX [PASSWORD=MYFIL]  MYFIL is the password assigned to file MYFILE.TEX. B>SET *.TEX [PASSWORD=SECRET, PROTECT=WRITE]  Assigns the password SECRET to all the TEX files on ystem to use dd as a password if you do not  enter a password for a password-protected file. ///2Time-Stamps Syntax: SET [CREATE=ON] SET [ACCESS=ON] SET [UPDATE=ON] Explanation: The above SET ult or specified drive. To record the  creation time of a file, the CREATE option must be  turned on before the file is created. [ACCESS=ON] turns on ACCESS time stamps on the disk in the CREATE  time stamp, the CREATE time stamp is  automatically turned off. [UPDATE=ON] turns on UPDATE time stamps on the disk in the  default or specified drive. UPDATE time sta A>SET B: [RO]  Sets drive B to Read-Only. ///1SETDEF Syntax: SETDEF { d: {,d: {,d: {,d:} {[ TEMPORARY = d: ] | * [ ORDER = (typ {,typ}) ]} SETDEF [DISPLAY | NO DISPLAY] affect only the loading of programs and/or execution of SUBMIT (SUB) files. SETDEF turns on/off the system Display and Console Page modes. When on, the system displays the location and name of programs loaded or SUBmit files ex ry  files. A>SETDEF C:,*  Tells the system to search for a program on drive C, then,  if not found, search for it on the default drive. A>SETDEF [ORDER=(SUB,COM)]  Instructs the system to search for a SUB file  A>SETDEF [NO DISPLAY] Turns off the system Display mode. ///1SHOW Syntax:  SHOW {d:}{[SPACE |LABEL |USERS |DIR |DRIVE]} Explanation: The SHOW command displays the following disk drive information:  Access mode and OW [SPACE]  Instructs the system to display access mode and amount of  space left on logged-in drives. A>SHOW B:  Show access mode for drive B and amount of space left on  drive B. A>SHOW B:[LABEL]  directory entries on drive C. A>SHOW [DRIVE]  Displays the drive characteristics of drive A. ///1SID Syntax:  SID {pgm-filespec} {,sym-filespec} Explanation: The SID symbolic debugger allows you to monitor tility programs to provide traceback and histogram facilities. ///2Commands  Command Meaning  As (Assemble) Enter assembly language # statements   pair d is the value of the DE # register pair  D{W}{s}{,f} (Display) Display memory in hex and ASCII # W is a 16-bit word format   a symbol table file  Fs,f,d (Fill) Fill memory with constant value # s is the start address # f is the finish address # d is an eimps  record the time the file was last modified. ///3Examples A>SET [ACCESS=ON] A>SET [CREATE=ON,UPDATE=ON] ///2Drives Syntax: SET {d:} [RO] SET {d:} [RW] Example:  SETDEF [PAGE | NOPAGE] Explanation: SETDEF allows the user to display or define up to four drives for the program search order, the drive for temporary files, and the file type search order. The SETDEF definitions ecuted, and stops after displaying one full console screen of information. ///2Examples A>SETDEF  Displays current SETDEF parameters. A>SETDEF [TEMPORARY=C:]  Sets disk drive C as the drive to be used for temporato execute.  If no SUB file is found, search for a COM file. A>SETDEF [DISPLAY]  Turns on the system display mode. Henceforth, the system  displays the name and location of programs loaded or submit  files executed.the amount of free disk space  Disk label  Current user number and  Number of files for each user number on the disk  Number of free directory entries for the disk  Drive characteristics ///2Examples A>SHOW  A>SH Displays label information for drive B. A>SHOW [USERS]  Displays the current user number and all the users on drive  A and the corresponding number of files assigned to them. A>SHOW C:[DIR]  Displays the number of free and test programs developed for the 8080 microprocessor. SID supports real-time breakpoints, fully monitored execution, symbolic disassembly, assembly, and memory display and fill functions. SID can dynamically load SID u s is the start address  Cs{b{,d}} (Call) Call to memory location from SID # s is the called address # b is the value of the BC register  s is the start address # f is the finish address  Epgm-filespec (Load) Load program and symbol table  {,sym-filespec} for execution  E*sym-filespec (Load) Loadght-bit data item  G{p}{,a{,b}} (Go) Begin Execution # p is a start address # a is a temporary breakpoint  H (Hex) Displays all symbols with  Computes hex sum and difference # of a and b where # a and b are symbolic expressions  Icommand tail (Input) Input CCP command line  L{s}{,f}  s is the start address # h is the high address of the block # d is the destination start address  P{p{,c}} (Pass) Pass point set, reset, and display  S{W}s (Set) Set Memory Values # s is address where value is sent # W is 16 bit word  T{n{,c}} (Trace) Trace Program Execution   subroutines # n is the number of program steps # c is the utility entry address  U{W}{n{,c}} (Untrace) Monitor Execution without Trace  (Value) Display the value of the next # available location in memory # (NEXT), the next location after # the largest file read in (MSZE), f a contiguous # block of memory to filespec. # f is finish address  X{f}{r} (Examine) Examine/alter CPU state. # f is flag bit C,Z,M,E  CP/M 3 loads SID and the program file SAMPLE.HEX into memory  from drive B. ///2Utilities SID utilities, HIST.UTL and TRACE.UTL are special programs that operate with SID to provide additional debugging facilities. The mechanelected program segments of the test program. The HIST utility allows you to monitor those sections of code that execute most frequently. The TRACE utility obtains a backtrace of the instructions that led to a particular The SUBMIT command lets you execute a group (batch) of commands from a SUBmit file (a file with filetype of SUB). ///2Subfile The SUB file can contain the following types of lines:  Any valid CP/M 3 command  Any va # addresses in Hex  H.a Displays hex, decimal, and ASCII # values of a where # a is a symbolic expression  Ha,b  (List) List 8080 mnemonic instructions # s is the start address # f is the finish address  Ms,h,d (Move) Move Memory Block   p is a permanent breakpoint address # c is initial value of pass counter  Rfilespec{,d} (Read) Read Code/Symbols # d is an offset to each address  n is the number of program steps # c is the utility entry address.  T{W}{n{,c}} (Trace) Trace Without Call # W instructs SID not to trace   n is the number of program steps # c is the utility entry address # W instructs SID not to trace # subroutines  V  the current value of the Program # counter (PC), and the address of # the end of available memory (END)  Wfilespec,s,f (Write) Write the contents o or I. # r is register A,B,D,H,S or P. ///2Examples A>SID  CP/M 3 loads SID from drive A into memory. SID displays the  # prompt when it is ready to accept commands. A>B:SID SAMPLE.HEX isms for system initialization, data collection, and data display are described in the CP/M SID User's Guide. The HIST utility creates a histogram (bar graph) showing the relative frequency of execution of code within s breakpoint address in a program under test. You can collect the addresses of up to 256 instructions between pass points in U or T modes. ///1SUBMIT Syntax: SUBMIT {filespec} {argument} ... {argument} Explanation: lid CP/M 3 command with SUBMIT parameters ($0-$9)  Any data input line  Any program input line with parameters ($0 to $9) The command line cannot exceed 135 characters. The following lines illustrate the variety of lines which may e current user number is now 5 on drive A. A>USER 3 3A>  This command changes the current User Number to 3. ///1XREF Syntax: XREF {d:} filename {$P} Explanation: XREF provides a cross-reference summary le of type .XRF. Examples: A>XREF b:MYPROG A>XREF b:MYPROG $P 0tax: DIR {d:} DIR {filespec} DIRS {d:} DIRS {filespec} Explanation: Syntax: SUBMIT SUBMIT filespec SUBMIT filespec argument ... argument Examples: A>SUBMIT A>SUBMIT SUBA A>SUBMIT AA ZZ SZ A>SUBMIT B:START DIR E: ///2PROFILE.SUB  the file. This file is convenient to use if you regularly execute a set of commands before you do your regular session on the computer. ///1TYPE Syntax: TYPE {filespec {[ PAGE | NOPAGE ]}} Explanation: The TYPE \1"6CP/M Version 3.0COPYRIGHT 1982, DIGITAL RESEARCH151282654321͈͋>tPECTED END OF HEX FILE$INVALID SEPARATOR$NO DIRECTORY SPACE$INVALID FORMAT WITH SPARCE FILE$MAKE FILE$OPEN FILE$PRINTER BUSY$CAN'T DELETE TEMP FILE$ *5<P_lz)<\fp}NO DIRECTORY SPACE$NO DATA BLOCK$CAN'T CLOSE CURRENT EXTENT$SE n normally defaults to 24 lines per page. [NOPAGE] Turns off Console Page Mode and continuously displays a typed file on the screen. ///2Examples A>TYPE MYPROG.PLI  Displays the contents of the file e USER command sets the current user number. The disk directory can be divided into distinct groups according to a "User Number." User numbers range from 0 through 15. ///2Examples A>USER Enter User#:5 5A>  Th eT     =.:;,<> _[]OUTPRNLSTAXOAUXCONAXIINPNULEOFERROR: $ - $$$$DESTINATION IS R/O, DELETE (Y/N)? $**NOT DELETED**$COPYING -$ (Y/N)? $REQUIRES CP/M 3$CP/M 3 PIP VERSION 3.0$:"Q}#( :}#be entered in a SUB file: DIR DIR *.BAK MAC $1 $$$4 PIP LST:=$1.PRN[T$2 $3 $5] DIR *.ASM PIP USER Enter User#:5 5A>  Th Everytime you power up or reset your computer, CP/M 3 looks for a special SUBmit file named PROFILE.SUB to execute. If it does not exist, CP/M 3 resumes normal operation. If the PROFILE.SUB file exists, the system executes the commands incommand displays the contents of an ASCII character file on your screen. [PAGE] Causes the console listing to be displayed in paged mode; i.e., stop automatically after listing n lines of text, where (12/06/82) CP/M 3 PIP VERS 3.0 DISK READ$DISK WRITE$VERIFY$INVALID DESTINATION$INVALID SOURCE$USER ABORTED$BAD PARAMETER$INVALID USER NUMBER$INVALID FORMAT$HEX RECORD CHECKSUM$FILE NOT FOUND$START NOT FOUND$QUIT NOT FOUND$INVALID HEX DIGIT$CLOSE FILE$UNEXEK TO UNWRITTEN EXTENT$RANDOM RECORD OUT OF RANGE$RECORDS DON'T MATCH$RECORD LOCKED$INVALID FILENAME$FCB CHECKSUM$2FTe$NONRECOVERABLE$R/O DISK$R/O FILE$INVALID DISK SELECT$INCOMPATIBLE MODE$INVALID PASSWORD$ALREADY EXISTS$LIMIT EXCEEDED$MYPROG.PLI on your screen. A>TYPE B:THISFILE [PAGE]  Displays the contents of the file THISFILE from drive B on  your screen twenty four lines at a time. ///1USER Syntax: USER {number} Explanation: Th