CPMFiler 1.31 ============= J.G.Harston -- http://mdfs.net/CPM/Filer 70 Camm Street, Walkley, Sheffield, S6 3TR CPMFiler is a simple program for accessing Acorn CPM, Slogger DDCPM, Torch CPN and Amstrad AmsDOS disks and disk images to examine and extract files. It will run on BBC, Master, RISC OS and Windows. It will access physical floppies, hard disks and disk images on BBC, Master and RISC OS, and disk images on Windows. On running, you get a drive prompt A> or B>, as if running the Console Command Processor. You specify the drive to access by using A: and B: just as in the CCP, or specify a disk image to access with the MOUNT command, which changes the prompt to display the image file name. At the prompt you can enter commands to examine the disk, examine files on the disk, and transfer files from the disk. To get a list of commands, enter ? or HELP. Command Summary =============== *command -------- This passes the command to the OS. d: -- Entering A: or B: will select the specified floppy drive to access. Hard drive access is selected by using the MOUNT command to mount the hard drive image file. MOUNT | -------------------- If a single character this selects the specified drive. Otherwise, it selects the specified file as a disk image file. All disk access is then from this file instead of a physical disk drive. MOUNT with no parameter re-mounts the current disk. USER ----------- Select user area. USER * selects all user areas, and is the default when the program starts. DIR --- This command displays a catalogue of all the files in the selected user area, or all files on the disk if USER * is selected. STAT ----------- This displays information on either all the files or one specific file. STAT displays the information CPM-style, as follows: D:FILENAME.EXT U LENGTH RSA EX <- - - - Allocation - - - -> Each line lists the drive, the filename and extension, the user number, the file length (including any final-sector byte count), the file attributes ReadOnly, System and Archive, the extent, and the allocation sector numbers. INFO ---- INFO displays the disk parameters for the currently mounted disk. TYPE [CTRLS], DUMP [7BIT] --------------------------------------- TYPE displays a file, and DUMP gives a hexadecimal file dump. If the [CTRLS] option is given to TYPE, then all control characters are passed unfiltered, otherwise only LF and CR are displayed. If the [7BIT] option is given to DUMP, then the characters in the dump are displayed in 7-bit format, with bit 7 ignored. DISS ----------- This disassembles the specified file into Z80 mnenomics. The DisAssem OSWORD call must be available for this command, as provided in the DisAssem and Z80 BASIC ROM images. COPY (C) ------------------------ This allows you to copy single or multiple files from the CPM disk. If the source is a file, only that one file is copied to the specified destination file. If the source is * or *.* then everything in the directory is copied to the destination directory. Using the C option will prompt for confirmation before copying each file, where you can answer Yes or No, or All to copy all files from that point onwards. For example, COPY READ.ME README would copy the file 'READ.ME' from the CPM disk to the currently selected filing system. COPY * COBOLCPM would copy the entire disk into a directory called 'COBOLCPM'. Characters in file names invalid on BBC filing systems are translated when copying to BBC files according to the following standard table: CPM character . # $ ^ & @ % ~ BBC character / ? < > + = ; \ When copying all files from all user areas, if there are files with the same name in different user areas, the destination files will be overwritten. Select each user area in turn to copy the files. FREE, MAP --------- These two commands display the free space and map on the CPM disk. BLOCK -------------- This dumps out the specified CPM disk block. Each block is as shown in the display from MAP, and block 0 starts after the reserved areas. With Acorn disks blocks start at track 3, and blocks are &800 bytes long, and &1000 bytes long with Slogger DDCPM disks. The block parameter is in hexadecimal, as with the allocation numbers displayed by STAT. BLOCK can take small negative numbers as the sector parameter, and will dump the system tracks at FFFF, FFFE, FFFD and FFFC. HELP ---- This will list all the commands you can use. QUIT ---- This will terminate the program Notes ===== The following disks and disk images are recognised: AcornCPM AmstradDOS AmstradSYS Einstein IBM 8" MyZ80 Hard Disk SloggerCPM Spectrum+3 TorchCPN Slogger DDCPM is a double-density CP/M system used with Challenger compatible double-density disk systems. Version History =============== 31-Mar-2020 v1.31 Optimised format investigation code, finds directory geometry on Einstein disks 20-Mar-2020 v1.30 Files larger than 32K can be examined and copied. 29-Mar-2019 v1.29 Copy from CPN gets correct name, gets length from EX correctly, DUMP has tidier final line, tidied COPY, added (C)onfirm. 12-Aug-2007 v1.28 Slogger DDCPM mixed-format disks and images supported. 28-Apr-2007 v1.27 Physical disks accessible on RISC OS, works on Windows. 11-Feb-2001 v1.25 Commands in lower case recognised. 05-Dec-1999 v1.24 AmsDOS disks recognised. Partial support for Einstein disk images. 28-Nov-1999 v1.23 Access to CPN disks implemented, USER command. 27-Nov-1999 v1.22 Will access image files, side 2 access corrected. 15-Dec-1998 v1.21 Displays file attributes. 27-Nov-1998 v1.20 FDC routines call DFS to reset the FDC. 17-Jul-1998 v1.12 COPY fully working, with BBC: and CPM: specifiers. Program now called CPMFiler. 18-Feb-1998 v1.10 All routines implemented. 06-Jun-1994 v1.00 Initial version of CPMReader, only DIR, DUMP and TYPE implemented.