THIS PROGRAM IS FREEWARE! DIR2ATR ----------------------------------------------------------------------- Dir2Atr - Converts one (or more) IBM compatible PC Directory(ies) into one (or more) Atari 8-bit .ATR (or .XFD) disk image(s). CREDITS ----------------------------------------------------------------------- Dir2Atr is developed by Bo Schreurs - CHiPS bv CHiPS - Computer High Performance Software The latest version of Dir2Atr is v05.07.00 - February 22nd 1999. All previous versions of Dir2Atr are no longer supported. HISTORY ----------------------------------------------------------------------- There are some nifty programs out there that let you extract Atari 8-bit files from .ATR disk images on your pc, i.e. XDIR is a utility which does this for you. So, now you have several seperate Atari 8-bit files, and you want to store them all back in an .ATR (or .XFD) disk image, so you can access them (with the help of Sio2PC) on your Atari 8-bit computer (i.e. 400, 600XL, 800, 800XL, 1200XL, 65XE, 130XE, etc.) Where ATR is mentioned in this document, you can read .XFD as well. With XFormer you can turn one file into a disk image. And with ATRIMG11 you can select seperate files from within a pc directory and put them in a .ATR disk image. So, with the above utilities you can create your own .ATR images. However, I think those programs have their limitations, i.e. no SpartaDos support, no large disk support, no multiple DOS-es, etc. So I thought it was time for another nice utility. It's called DIR2ATR (pc DIRectory to ATR image disk). PREFACE ----------------------------------------------------------------------- Dir2Atr has been previously released as a command line driven utility. Since this is a kind of akward when you work in a windows environment, it has been changed into a more graphical and user friendly program. The nice thing about Dir2Atr, is that it converts a complete pc directory into one or more .ATR disk images. So you can create a pc directory, store all your favourite Atari Basic files in it, and then convert that directory into mulitple .ATR disk images! Or store it in one large disk. Before you start DIR2ATR, you must think about the following: a. Which pc directory (or pc directories) do I want to image. b. Do I want to create one or more .ATR disk images? c. What will the DOS type be of the disk images to be created? d. What will the disk density of the disk image be? e. Must DOS.SYS (and DUP.SYS) be placed on the disk image? f. Must the files be placed on the disk image(s) be in sequential order, or do I want to place as many files on a disk image as possible? g. Do I want add the disk images at the end of the last generated disk image, or do I want to start at disk image number 001.ATR or 001.XFD? RUNNING DIR2ATR ----------------------------------------------------------------------- Let us assume that the following PATH statement is specified in your AUTOEXEC.BAT file: PATH=C:\DOS If you place the DIR2ATR.EXE program in the C:\DOS directory, you can always run the program, regardless of the drive or directory you're currently in. For more info about this, refer to your DOS or Windows manual. The program will look for a config file called DIR2ATR.CFG. This file must be placed on your "C" drive. If this file (C:\DIR2ATR.CFG) is not present, it will be created. A default config file was included in the DIR2ATR package. The program expects the following files to be present in the package: ..\C:\DIR2ATR.CFG ..\DIR2ATR\DOS25\BOOTCODE ..\DIR2ATR\DOS25\DOS.SYS ..\DIR2ATR\DOS25\DUP.SYS ..\DIR2ATR\MYDOS\BOOTCODE ..\DIR2ATR\MYDOS\DOS.SYS ..\DIR2ATR\MYDOS\DUP.SYS ..\DIR2ATR\SPARTA\BOOTCODE ..\DIR2ATR\SPARTA\DOS.SYS These files are included in the package as well. If not, worry! Step 1: SELECTING THE PC DIRECTORY TO BE IMAGED. ----------------------------------------------------------------------- Let us assume that you're currently in the following drive/directory: C:\MYDIR If you run DIR2ATR now by typing the following: C:> DIR2ATR or C:> C:\DOS\DIR2ATR or C:> any_drive\any_directory\DIR2ATR You get the following screen: ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ º Path: C:\MYDIR\*.* ºÉÍÍÍ[Select Dir/Image]Í..» ºº.. º ººABBUC º DIR2ATR - Convert pc dir into .ATRs - v05.02.00 ººPOKEY º ººPROJECT .TOO º by B.F. Schreurs, January 21th, 1999, CHiPS bv ººSCAT º Computer High Performance Software - Freeware ººTHUNDERD.OME º Email: stack@xs4all.nl ººATARI .TXT 1,176º Homepage: http:\\www.xs4all.nl\~stack ººDEMO .COM 4,413º ººSPACE .BAS 339º Please select the appropiate Directory ººSTACK .ATR 183,936º (and Drive) to be converted into .ATR disks. ////////////////////////////////////////////////////////////////////////////// ºº º ººENTER=Select Esc=Cancel º ººF1=Help F2=CurDir F3=Drvº ºÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ From this screen, select the pc directory to be converted into one or more .ATR disk images. The path setting shows you which directory will be converted into disk images. At the screen shown, it will convert the files within the C:\MYDIR directory into .ATR or .XFD disk images. Pressing the "Esc" key, terminates the program. Pressing the F1 key, shows a help screen. Pressing the F3 key, let you select between the available drives. Pressing the ENTER key, let you select the highlighted (sub)directory, if there is one, and shows the available files there. Pressing the F2 key, selects the current directory (see the path displayed at the top of the screen) to be converted. Now continue with step 2. Pressing the F4 key, let you change the configuration file. This key is not shown on the screen, but is active. Use cursor keys up and down, to move around the screen. Use "Pg Up", "Pg Dn", "End" and "Home" to scroll up or down faster. If a mouse is enabled, you can use the mouse too to select a directory. Use the up and down arrow at the top right corner of the box, to scroll up or down. The function keys (Esc, Enter, F1, etc) can also be selected with the mouse. Step 2: SELECTING THE DIRECTORY WHERE THE IMAGES WILL BE STORED. ----------------------------------------------------------------------- Let us assume that you've specified the following in your configuration file (press F4 from step 1) for "Disk Images Location": C:\ATR_DISK\PROJECT.TOO for "Create ATR/XFD disks": A (for .ATR disks) You get the following screen: ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ º Path: C:\ATR_DISK\PROJECT.TOO\*.ATR ºÉÍÍÍ[Select Dir/Image]Í..» ºº.. º ºº1_SINGLE.ATR 92,176º DIR2ATR - Convert pc dir into .ATRs - v05.02.00 ºº2_MEDIUM.ATR 133,136º ºº3_ENHANC.ATR 143,376º ºº4_DOUBLE.ATR 183,952º ºº5_QUAD .ATR 368,272º ºº6_720KB .ATR 736,912º ºº7_MEGADI.ATR 1,048,592º ºº8_1440KB.ATR 1,474,192º Please select the appropiate Directory ºº9_HARDDI.ATR 16,776,592º (and Drive) to store the .ATR disk images ////////////////////////////////////////////////////////////////////////////// ºº º ººENTER=Select Esc=Cancel º ººF1=Help F2=CurDir F3=Drvº ºÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ Select a pc directory where the .ATR disk images will be stored. Pressing the "Esc" key, let you return to step 1. Pressing the F1 key, shows a help screen. Pressing the F3 key, let you select between the available drives. Pressing the ENTER key, let you select the highlighted (sub)directory, if there is one. Pressing the F2 key, selects the current directory (see the path displayed at the top of the screen). This directory will be used as the store directory. Now continue with step 3. Use cursor keys up and down, to move around the screen. Use "Pg Up", "Pg Dn", "End" and "Home" to scroll up or down faster. If a mouse is enabled, you can use the mouse too to select a directory. Use the up and down arrow at the top right corner of the box, to scroll up or down. The function keys (Esc, Enter, F1, etc) can also be selected with the mouse. Step 3: MEDIUM SPECIFICATION. ----------------------------------------------------------------------- Select what kind of density the disk image should be. Depending on the configuration file (or what was selected the previous time during running DIR2ATR), the appropiate disk medium is pre-selected, as well as which kind of disk type (ATR or XFD). You get the following screen: ÉÍÍ[Medium specification]ÍÍ» º º º [ ] SINGLE density º º [X] MEDIUM density º º [ ] DOUBLE density º º [ ] QUAD density º º [ ] 720 KB disk(ette) º º [ ] 1.44 MB disk(ette) º º [ ] HARDDISK 16 MB disk º º º º [A] Disk Type Creation º º A=ATR, X=XFD º º [ ] Put as many files onº º a disk as possible º º º ºENTER=Specify Esc=Cancelº ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ Placing a nonblank character in front of the desired option is sufficient to activate the option. Please note that you cannot choose multiple mediums. You can also specify what type of disk images should be created, .ATR or .XFD disk images. No other disk image type can be selected. Placing a nonblank character in front of the "Put as many files on a disk as possible" question, will try to maximize the disk usage of the disk image. If this is left blank, the "pc" files will be written to the disk image(s) in alphabetical order. Pressing the "Esc" key, let you return to step 2. Pressing the ENTER key, let you confirm your selection. Make your selection by non-blanking one selection! Continue with step 4. Use cursor keys to move around the screen. Use "Tab", "Backtab", "Pg Up" or "Pg Dn" to move around fast. If a mouse is enabled, you can use the mouse to select a density, flip the "ATR or XFD" selection, and flip the "Put as many files..." option. The function keys (Esc, Enter) can also be selected with the mouse. Step 4: SELECTING THE DOS TO INCLUDE ON THE IMAGE(S). ----------------------------------------------------- Select if a Disk Operating System (DOS) should be stored on the disk images, and if so, which DOS. Depending on the configuration file (or what was selected the previous time during running DIR2ATR or what was selected at step 3), the appropiate Disk type is pre-selected. You get the following screen: ÉÍÍÍÍÍÍ[Include which DOS]ÍÍÍÍÍÍ» º º º [X] Disk type DOS 2.5 º º [ ] Disk type MYDOS 4.53 º º [ ] Disk type Your Own MYDOS º º [ ] Disk type BeWe DOS º º [ ] Disk type SPARTADOS 3.3a º º [ ] Disk type SPARTADOS/X º º [ ] Disk type Your Own SPARTAº º º º [X] Write DOS Files º º If DOS is written, º º [X] Include DUP.SYS º º º ºENTER=Specify Esc=Cancelº ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ You can specify what kind of disk type the disk image should be, DOS, MYDOS, SPARTADOS, SPARTADOS/X, BeWeDOS or your own format. From Double density and up (step 3), the program will block the selection of DOS 2.5. You can always specify which DOS files should be written to the disk image: No DOS files, only DOS.SYS or DOS.SYS and DUP.SYS. The DOS.SYS file is neccessary if you want to boot from disk. The DUP.SYS gives you the DOS Menu when you boot up the disk image on your original Atari XL/XE. From this DOS Menu you can run programs, copy files, remove files, etc. Placing a nonblank character in front of the desired option is sufficient to activate the option. Please note that you cannot choose multiple DOS options. Please note that the DUP.SYS option will only be validated, if you selected to write DOS files to the disk image. ********************************************************************* Assuming that the following is specified in the configuration file for "Specify DOS File path": C:\DIR2ATR\ then the following is true: If DOS 2.5 is selected the program assumes that the BOOTCODE file, DOS.SYS and DUP.SYS reside in: C:\DIR2ATR\DOS25\ If MYDOS 4.5.3 is selected the program assumes that the BOOTCODE file, DOS.SYS and DUP.SYS reside in: C:\DIR2ATR\MYDOS\ If SPARTADOS 3.3a is selected the program assumes that the BOOTCODE file and DOS.SYS reside in: C:\DIR2ATR\SPARTA\ If SPARTADOS/X is selected the program assumes that the BOOTCODE file and DOS.SYS reside in: C:\DIR2ATR\SPARTAX\ If BeWeDOS is selected the program assumes that the BOOTCODE file and DOS.SYS reside in: C:\DIR2ATR\BEWEDOS\ If you select your own DOS, the program assumes that the BOOTCODE file and DOS.SYS reside in: C:\DIR2ATR\MYOWNDOS\ ********************************************************************* Pressing the "Esc" key, let you return to step 3. Pressing the ENTER key, let you confirm your selection. Make your selection by non-blanking one selection! Continue with step 5. Use cursor keys to move around the screen. Use "Tab", "Backtab", "Pg Up" or "Pg Dn" to move around fast. If a mouse is enabled, you can use the mouse to select to add disk images at the end of an existing range, or start from number 001. The function keys (Esc, Enter) can also be selected with the mouse. Step 5: SPARTADOS SUPPORT - CONVERTING ONE OR MORE DIRECTORIES ----------------------------------------------------------------------- If you've selected to use DOS 2.5 or MYDOS go on with step 7. If the directory to be converted does not contain any directory at all, step 5 and 6 are skipped, and you can continue with step 7. When you've selected to create a SpartaDos format disk image (i.e. SpartaDos 3.3a, SpartaDos/X, BeWe Dos or your own Sparta), read on. The SpartaDos format supports (sub)directories. On an Atari XL/XE you can use the "CD [directory]" and "CD .." commands to navigate between directories. DIR2ATR let you specify if (sub)directories should be included in the conversion process from directory (or directories) to the disk image. You get the following screen: ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ[Subdirectories]ÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» º º º Process the (sub)directories as well? º º º º [Y] Y=Yes, all files and (sub)directories º º MUST fit on ONE disk image!!! º º N=No , if files don't fit on one disk, º º another disk will be created. º º º ºENTER=Specify Esc=Cancel º ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ If you've selected "Y" for Yes to include all (sub)directories, please note that the media you've selected is of such a size that DIR2ATR can store all the (sub)directories and its data on it. Continue with step 6. If you've selected "N" for No, DIR2ATR will store all the files of the currently selected directory into one or more disk images (being in SpartaDos format). A volume name is automatically assigned to the SpartaDos disk image. The volume names will be in the "001" thru "999" range (in conjunction with the disk image pc's filename 001.ATR thru 999.ATR). Continue with step 7. Pressing the "Esc" key, let you return to step 3. Pressing the ENTER key, let you confirm your selection. Make your selection by choosing a "Y" or "N". If "Y"es is selected, continue with step 6. If "N"o is selected, continue with step 7. Use cursor keys to move around the screen. If a mouse is enabled, you can use the mouse to flip the "include (sub)directories" selection. The function keys (Esc, Enter) can also be selected with the mouse. Step 6: SPARTADOS SUPPORT - SPECIFYING A VOLUME NAME ----------------------------------------------------------------------- A SpartaDos format disk image needs a volume name. If no (sub)directories are included, DIR2ATR will take care of assigning a volume name to the SpartaDos disk image. However, if (sub)directories are included, the user may specify it. You get the following screen: ÉÍÍÍÍÍÍÍÍÍÍ[SpartaDos Volume Name]ÍÍÍÍÍÍÍÍÍÍÍ» º º º Please specify the SpartaDos Volume Name: º º MYDIR___ º º º ºENTER=Specify Esc=Cancel º ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ DIR2ATR will assume that the volume name will be the same as the directory name being converted. However, the volume name field is editable, so the user can choose a more appropriate volume name if desired. Pressing the "Esc" key, let you return to step 5. Pressing the ENTER key, let you confirm your entry. Specify another SpartaDos volume name if desired. Continue with step 8. Use cursor keys to move around the screen. The function keys (Esc, Enter) can also be selected with the mouse. Step 7: IF OTHER IMAGES ALREADY EXIST IN THE STORE DIRECTORY. ----------------------------------------------------------------------- If no previous .ATR disk images reside in the "store" directory, the program will create disk images starting from disk image "001.ATR" or from "001.XFD", depending on the disk type selected, and the program will continue with step 8. If shown, you get the following screen: ÉÍÍÍÍÍ[Add from where]ÍÍÍÍÍÍ» º º º [X] Add at end º º [ ] Add from begin º º º ºENTER=Specify Esc=Cancelº ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ Select if the disk images to be created will be added after the highest currently available disk number, or should start from the beginning of the numbering sequence (i.e. 001.ATR or 001.XFD). The program checks if there are disk images present in the "store" directory with disk numbers within the range "001.ATR" thru "999.ATR", or within the range "001.XFD" thru "999.XFD". If so, this step is executed, and you'll have to decide what the start number of the first to be created disk image will be. Placing a nonblank character in front of the desired option is sufficient to activate the option. Please note that you cannot choose multiple options. Pressing the "Esc" key, let you return to step 4. Pressing the ENTER key, let you confirm your selection. Make your selection by non-blanking one selection! Continue with step 8. Use cursor keys to move around the screen. Use "Tab" to jump to the next field. THAT'S IT!!! In fact you're job is now done. Sit back and watch the program do its job. The remaining steps are for your info only. Step 8: INFORMING THE USER ABOUT THE PROGRESS OF THE IMAGE PROCESSING. ----------------------------------------------------------------------- The program will now convert the selected pc directory into .ATR or .XFD disk images, and store them in the selected pc "store" directory. DOS files will be written to the disk images if selected. The program will create the disk images starting from disk number 001.ATR (or 001.XFD) unless the user specified otherwise. On slow pc's (80386 and lower), and slow disk drives, formatting the disk image can take quite a while. Therefore a formatting disk screen is shown as soon as a disk image is formatted, and looks similar to the following: ÉÍÍÍÍÍ[Formatting Disk Image]ÍÍÍÍÍÍ» ºÛÛÛÛÛÛÛÛÛÛÛÛ±±±±±±±±±±±±±±±±±±±±±±º ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ As soon as the disk image is formatted, the program will first write the BOOTCODE to the diskfile, then the DOS file DOS.SYS is written to the diskfile (if selected), and if selected, DOS file DUP.SYS as well. SpartaDos doesn't use a DUP.SYS, and hence this file is not written. Next the pc files (and/or directories) are written to the diskfile. Which files are written to disk, are displayed to the user. DOS 2.5 and MYDOS disk format ----------------------------- The progress of "moving" the "pc" files from the pc directory to the disk image file is graphically depicted, and look similar to the following: ÉÍÍ[Adding files to disk images]ÍÍÍ»" º º" º ÛÛÛÛÛÛÛÛÛÛÛÛ±±±±±±±±±±±±±±±±±±±± º" º º" º Processing disk: 001.ATR º" º Processing file: SPACE.BAS º" ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ" As soon as the progress bar is completely filled, the "pc" files in the pc directory have been moved into .ATR (or .XFD) disk images. Pc files which are too large to fit on the selected disk image density, are skipped. The program keeps track of the remaining free sectors on a disk image, if a file does fit on the selected disk image density, but is too large to fit on it, because there are not enough free sectors remaining, a new disk image is created (that's because the pc files are written to the disk images in their alphabetical order). However, if the "Put as many files on a disk as possible" option is selected, the program will ignore the alphabetical order, and will check all files remaining to be written to the image, to see which will fit within the remaining free sectors. It will select that file which is equal to or almost close to the remaining free sectors. So if we have 10 free sectors, and we have a file 3 sectors in size, and a file 6 sectors in size, the file with 6 sectors will be written to the disk image first... The Atari 8bit Volume Table Of Contents (VTOC) sectors, are written to the disk image at the end (including the bitmap sectors). You should be able to write additional files to the disk (image) using a regular Atari 8bit computer and SIO2PC... SPARTADOS disk format --------------------- The progress of "moving" the "pc" files from the pc directory to the disk image file is graphically depicted, and look similar to the following: ÉÍÍ[Adding files to disk images]ÍÍÍ»" º º" º ÛÛÛÛÛÛÛÛÛÛÛÛ±±±±±±±±±±±±±±±±±±±± º" º º" º Processing disk: 001.ATR º" º Processing dir : ABBUC º" º Processing file: SPACE.BAS º" ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ" or ÉÍÍ[Adding files to disk images]ÍÍÍ»" º º" º ÛÛÛÛÛÛÛÛÛÛÛÛ±±±±±±±±±±±±±±±±±±±± º" º º" º Processing disk: MYDIR.ATR º" º Processing dir : ABBUC º" º Processing file: SPACE.BAS º" ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ" As soon as the progress bar is completely filled, the "pc" files in the pc directory and (sub'directories and their files) have been moved into .ATR (or .XFD) disk images. SPARTADOS disk format - Include (sub)directories ------------------------------------------------ Pc files which are too large to fit on the selected disk image density, are skipped. All directories and their files should fit on the selected disk image. If not, the program will inform the user about this. SPARTADOS disk format - Don't include (sub)directories ------------------------------------------------------ Pc files which are too large to fit on the selected disk image density, are skipped. The program keeps track of the remaining free sectors on a disk image, if a file does fit on the selected disk image density, because there are not enough free sectors remaining, a new disk image is created (that's because the pc files are written to the disk images in their alphabetical order). However, if the "Put as many files on a disk as possible" option is selected, the program will ignore the alphabetical order, and will check all files remaining to be written to the image, to see which will fit within the remaining free sectors. It will select that file which is equal to or almost close to the remaining free sectors. So if we have 10 free sectors, and we have a file 3 sectors in size, and a file 6 sectors in size, the file with 6 sectors will be written to the disk image first... VOLUME TABLE OF CONTENTS - VTOC ------------------------------- The Atari 8bit Volume Table Of Contents (VTOC) sectors, are written to the disk image in the end (including the bitmap sectors). You should be able to write additional files to the disk (image) using a regular Atari 8bit computer and SIO2PC... In case of a SpartaDos disk image, the directories structure is written out to the disk image as well. Step 9: WHEN ALL IS SAID AND DONE. ----------------------------------------------------------------------- After creating the disk images, the program continues with step 1. Press the Esc(ape) key to terminate the program. THE CONFIGURATION FILE. ----------------------------------------------------------------------- The following parameters can be specified through the configuration file: ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ[Configuration Setup]ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ºStartup Drives : CDEF______________________ º Use a '*' to scan all available drives, º or specify the dirve letters to scan, i.e. 'CDE'. ºCurrently Active : CD________________________ º Shows the drives who are currently available, º and is always a subset of the Startup Drives specified ºDisk Images Location : C:\ATARI\8BIT\IMAGES\ATR\_____________________________ º Use a '*' to use the current drive/directory, º or specify the drive/directory, i.e. 'C:\MYDIR\'. ºDisk Density to use : M º S=Single, M=Medium, D=Double, Q=Quad, º 7=720 KB disk, 1=1.44 MB disk, H=16 MB harddisk ºCreate ATR/XFD disks : A º A=.ATR disks, X=.XFD disks ºSpecify DOS File path: C:\ATARI\DIR2ATR\_____________________________________ º I.e 'C:\DIR2ATR\', the program will add 'DOS25\' etc. ºDisk Format to use : D º D=DOS 2.5, M=MYDOS 4.53, B=BEWEDOS, O=MY OWN DOS (DOS) º S=SPARTADOS 3.3a, X=SPARTADOS/X, Y=MY OWN DOS (SPARTA) ºWrite DOS Files : Y º Y=Yes, N=No º Write DUP.SYS file: Y (Y=Yes, N=No) ºENTER=Save F2=Update Configuration File C:\DIR2ATR.CFG Esc=Cancel ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ We will discuss those parameters in detail now. All of those parameters can be changed online without changing the Disk Configuration File. To change the Disk Configuration File you'll have to specify that (Key F2). For now, the Disk Configuration File is always located in the root disk C:\ However you can change the DIR2ATR.EXE with the Microsoft program DEBUG, and change the location to look for...! Let look at the parameters now: ----------------------------------------------------------------------- ºStartup Drives : CDE_______________________ º Use a '*' to scan all available drives, º or specify the dirve letters to scan, i.e. 'CDE'. Previous versions of DIR2ATR would always check all available drives upon startup. Even the diskette drive. When there was no diskette in the diskette drive, it would take a while before DIR2ATR would be ready. And sometimes you don't want DIR2ATR to know about certain drives. With this parameter you can specify which disk drives may be used by DIR2ATR. Let's say you have the following disk drives: A, C, D and cdrom drive E. On top of that you can access the Network drives F, G and H. You want DIR2ATR only to access drive C, D and E. That is what currently is specified to be the case for the "Startup Drives". Although drives A, F, G and H are present, they will not be accessed by the DIR2ATR program. Up to 26 drive letters can be specified (the maximum number of drives on a pc). If you want DIR2ATR to scan all available drives on the pc, specify an asterisk (*). ----------------------------------------------------------------------- ºCurrently Active : CD________________________ º Shows the drives who are currently available, º and is always a subset of the Startup Drives specified Let us suppose you specified as Startup Drives C, D and E. And let us suppose the cdrom drive is removed from the pc. So drive E no longer exists. If DIR2ATR is run now, and the configuration file is accessed by pressing F4, the program will show which drives were found of the list specified by the user (Startup Drives). Drive E was not found, so it will only display drives C and D. ----------------------------------------------------------------------- ºDisk Images Location : C:\ATARI\8BIT\IMAGES\ATR\_____________________________ º Use a '*' to use the current drive/directory, º or specify the drive/directory, i.e. 'C:\MYDIR\'. You can specify here where the disk images to be created should be stored. If you want to store the disk images in the directory where you were, when DIR2ATR got launched, specify an asterisk (*). ----------------------------------------------------------------------- ºDisk Density to use : M º S=Single, M=Medium, D=Double, Q=Quad, º 7=720 KB disk, 1=1.44 MB disk, H=16 MB harddisk The disk density of the disk images to be created is also parameterized. If you normally always create Medium density disks, specify a "M" here. If the majority of the disk images you create are Single density disk, specify a "S" here. However as soon as DIR2ATR runs, it will use this specification once, and from there on use the setting specified online. So if "S" for Single is specified here, and the user selects "M" for Medium when actually creating the disk images, DIR2ATR will use the "M"edium density setting from that moment on as the default for as long as the DIR2ATR program runs. ----------------------------------------------------------------------- ºCreate ATR/XFD disks : A º A=.ATR disks, X=.XFD disks For now, you can only create .ATR or .XFD disk images. The .XFD disk image is a standard created by Darek Mihocka. This disk image is in fact an exact copy of the actual disk used on an Atari 1050 disk drive. The .ATR disk image is a standard created by Nick Kennedy. It is similar to the .XFD disk image, however, 16 bytes are added in front of the disk image to be able to recognize the pc file to be and Atari disk. It also stores the disk type information in this header (i.e. Sector Size and in fact disk size). However as soon as DIR2ATR runs, it will use this specification once, and from there on use the setting specified online. So if "A" for .ATR is specified here, and the user selects "X" for .XFD when actually creating the disk images, DIR2ATR will use the "X"FD format from that moment on as the default for as long as the DIR2ATR program runs. ----------------------------------------------------------------------- ºSpecify DOS File path: C:\ATARI\DIR2ATR\_____________________________________ º I.e 'C:\DIR2ATR\', the program will add 'DOS25\' etc. You can specify here, where DIR2ATR should look when it wants to write the BOOTCODE, DOS.SYS and/or DUP.SYS files to the disk image. It normally assumes C:\DIR2ATR\ but you can specify any (existing) directory you like. However, make sure the directories DOS25 and MYDOS are present in that specified directory. The DOS25 and MYDOS directory must also contain the following files: BOOTCODE, DOS.SYS and DUP.SYS These files should belong to DOS 2.5 and MYDOS 4.53 respectfully. ----------------------------------------------------------------------- ºDisk Format to use : D º D=DOS 2.5, M=MYDOS 4.53, B=BEWEDOS, O=MY OWN DOS (DOS) º S=SPARTADOS 3.3a, X=SPARTADOS/X, Y=MY OWN DOS (SPARTA) Each DOS uses a disk in a specific manner. For instance, MYDOS uses sector 358 and 359 as the bitmap sectors on a Medium density disk, while DOS 2.5 uses the bitmap sectors 359 and 1024. That's why you have to specify which DOS the disk image should "emulate" amongst other things. Of course SpartaDos and "My Own Dos" are even more weird. It also depends on the BOOTCODE to use and or DOS Files for instance. However as soon as DIR2ATR runs, it will use this specification once, and from there on use the setting specified online. So if "M" for MYDOS is specified here, and the user selects "D" for DOS 2.5 when actually creating the disk images, DIR2ATR will use the "D"OS 2.5 format from that moment on as the default for as long as the DIR2ATR program runs. ----------------------------------------------------------------------- ºWrite DOS Files : Y º Y=Yes, N=No º Write DUP.SYS file: Y (Y=Yes, N=No) When you want to include the DOS files on the disk, specify a "Y"es here. If not, specify a "N"o. When DOS files are written to disk, do you want to include the DOS menu file DUP.SYS? If yes, specify a "Y"es here, otherwise specify a "N"o. However as soon as DIR2ATR runs, it will use this specification once, and from there on use the setting specified online. So if "Y" for Yes is specified here, and the user selects "N" for No when actually creating the disk images, DIR2ATR will use the "N"o setting from that moment on as the default for as long as the DIR2ATR program runs. ----------------------------------------------------------------------- Pressing the "Esc" key, let you return to the previous screen. Pressing the ENTER key, let you confirm your specification and the program will use those specifations from that moment on! You will be returned to the previous screen. Pressing the F2 key, let you confirm your specification and the program will use those specifations from that moment on! The specifications are made permanent by updating the DIR2ATR.CFG file on your pc's hard drive. You will be returned to the previous screen. Use cursor keys to move around the screen. Use "Tab", "Backtab", "Pg Up" or "Pg Dn" to move around fast. If a mouse is enabled, the function keys (Esc, Enter) can be selected with it QUESTION, COMMENTS, PRAISE? EMAIL! ----------------------------------------------------------------------- Well, that's basically it! Thank you for using Dir2Atr. If you've got questions, comments, praise, my email address is: stack@xs4all.nl Sincerely, Bo. ************************** Modification History ****************************** v1.00.00 November 5th 1997, release of the program to the Public Domain. v2.00.00 The program is now Freeware. It's no longer command line driven. An user interface has been implemented. The user can skip the DUP.SYS file from the image if desired. The DOS.SYS and DUP.SYS file are still located in the same directory (i.e. \DOS25 or \MYDOS), but the DOS25 and MYDOS directory have been placed in the C:\DIR2ATR directory now. So DOS.SYS for DOS 2.5 should be located at: C:\DIR2ATR\DOS25\DOS.SYS Wish list: Being able to create DOUBLE density disks. v3.00.00 Added density selection in coniguration file. Double density disks is supported. The program now uses module WSIO to communicate with the user. v4.00.00 Never released. The program now uses module FMSIO to communicate with the pc hard disk. Error screens added. v04.04.00 September 23rd, 1998. Public release. Several disk densities can be choosen from. Bitmap for the disk image is maintained up to double density. Disk image capacity can be used to the full using disk optimization. The configuration file has been enhanced. Many options can be set. Mouse support added for all screens, except error screens. The BOOTCODE for a disk is placed in a file as well and is called BOOTCODE. The DOS25 and MYDOS directory can be placed anywhere on the pc now. A directory pointer has been added to the configuration file. Wish list: Adding SpartaDos capabilities. Looking for the configuration file in the directory from which DIR2ATR was started from. v05.02.00 January 24th, 1999. Public release. SpartaDos support implemented. SpartaDos 3.3a resides in C:\DIR2ATR\SPARTA The user can use his own DOS now if desired. User's own DOS resides in C:\DIR2ATR\MYOWNDOS The program now determines the size of the DOS.SYS and DUP.SYS itself, instead of using hard coded values. Displaying the store directory will use a *.ATR or *.XFD mask now depending on the user's configuration file. Wish list: Looking for the configuration file in the directory from which DIR2ATR was started from. v05.07.00 February 22nd, 1999. Public release. Program CLEANUP from Fte reported an error when checking SpartaDos .ATR disks created by Dir2atr. Bitmap count bug solved. Error was reported by Marius Diepenhorst. He also asked if it was possible to have the user to decide the main directory name of a SpartaDos .ATR disk. Configuration file adapted to meet this demand. The user can now specify if main directory of a SpartaDos disk is called "MAIN" or that is named after the first directory being .ATR-ed.