NSTOCPM.DOC as of 12-06-82 Changes in version 2: - Commands can now be lower case - NSTOCPM will not run on a 8080 - NSTOCPM checks the OEM code of CP/M to see if it is running on a North Star implementation. NSTOCPM.COM is a utility for copying North Star DOS files onto a CP/M disk. Special features of North Star CP/M make this program independent of the disk controller address. In order to run this program your system has to meet the following requirements: 1. You have to have North Star CP/M on a Z-80 2. At least 2 drives 3. The DOS diskette and the files you want to copy MUST be double density. If you do not have CP/M as delivered by North Star, NSTOCPM *MAY* work. NSTOCPM will inform you if it can't run in your CP/M environment. USE OF NSTOCPM To execute the utility, simply enter NSTOCPM. Please note that all commands typed to NSTOCPM will execute immediately! NSTOCPM will now announce its presence and give you a brief rundown on your choices. You will then be asked to input the DOS drive number. The number must be between 1 and 4 or it will be rejected. Next, you will be asked for the CP/M drive number, and both numbers will be rejected if you enter any number other than 1,2,3, or 4, OR if the CP/M drive is specified to be the same as the DOS drive. Now you will be in command mode, with a "+" sign as prompt. You can enter one of three commands: D = display the DOS directory in DOS fashion C = copy a file Q = quit (warm-boot CP/M) If you specify the opy command, you will be asked for a DOS file name. Enter the file name ONLY (without disk designator) and terminate with a carriage return. The file name will be rejected if it is longer than 8 characters, empty, or if the file is not on the DOS disk. After successful entry of the DOS file name you will be asked for a CP/M file name. You can choose any CP/M file name you like, if the file name is longer than 12 characters or empty it will be rejected. If the file name is longer than 8 characters, everything after the 8th character is treated as file type, i.e. "TOOLONGNAME" will become "TOOLONGN.AME." After entering a valid CP/M file name, the CP/M file will be created, overwriting any file already on disk by that name, and copying will start. The DOS file is copied 512 bytes at a time. When finished, control will return to the command prompt in anticipation of another copy. When finished copying, type a "Q" at the prompt to return to CP/M. Please note that file names in NSTOCPM MUST be made in UPPER CASE! NSTOCPM will accept lower case COMMANDS. Use lower case for the DOS file name, if the directory shows it in lower case. If you use lower case for the CP/M file, you will have to run a disk utility to convert the file name to upper case in order to use the file. NSTOCPM does not perform any error checking on file names; it allows all characters to be used, so be careful! If the DOS disk is dual sided, but inserted into a single sided drive and an attempt is made to copy a file on the back side, the results are unpredictable, since the drive is not checked for DS operation. The resulting CP/M file will most likely contain blanks. IMPORTANT! If you have a CP/M other than the one distributed by North Star, NSTOCPM will tell you so and offer you a chouce to go ahead or abort. It will do this only if the BIOS jump table has 18 entries! In that case, WRITE-PROTECT all disks and go ahead. If you do a irectory and it comes up, you're fine. If not, NSTOCPM won't work. You may now go ahead and determine the OEM code in your CP/M. This code is located at BDOS+0 and BDOS+1. Using DDT, place the OEM code into the following locations: BDOS+0 into NSTOCPM 011DH BDOS+1 into NSTOCPM 0123H This will inhibit the "go-ahead" question when running NSTOCPM.