Antic super-utility now even betterby PATRICK DELL'ERA
This spectacular update of the original DISKIO disk operation utility provides instant, one-dot keystroke commands for nearly all DOS functions, an alphabetized disk directory, single-key macros and much more. All without touching your resident program. Works with BASIC, BASIC XL/XE, MAC/65 (cartridge only), or Atari Assembler Editor. DISKIO PLUS is compatible with DOS 2, DOS 2.5, DOS XL and will work with single or enhanced density. It also works with all 8-BIT Atari computers-including the 130XE.
Last January, Antic published one of our most popular and
useful programs-DISKIO by Dr Bernard Oppenheim. It was a resident disk
file utility that permitted most disk operations to be accessed directly
from BASIC or Atari Assembler Editor with quick, one-dot commands. DISKIO
instantly became our in-house utility and generated a great deal of appreciative
mail. But when DOS 2.5 appeared, it became evident that DISKIO needed an
update since it didn't work with the new DOS.
Antic contacted Dr. Oppenheim, who Is a nuclear medicine physician. Though he was unable to find time in his busy schedule to rewrite the program, he generously sent us his source code which we immediately passed on to Patrick Dell'Era. Patrick-who will be remembered for his Antic enhancements of Price's Painter (April 1985) and Fader (May 1985)-set to work and created the following incredible DISKIO PLUS. Yes, it works with DOS 2.5. But a lot of new bells and whistles have been added -ANTIC ED)
Okay, throw out your DUP.SYS. You're not going to need it anymore. DISKIO PLUS will take care of just about any disk function you can think of. And you won't have to go to DOS to do it.
Before we get heavily into all the new things DISKIO PLUS can do, let's take care of those who already have DISKIO and just want to get it working with DOS 2.5.
Type in Listing 3, DSKIOFIX.BAS, check it with TYPO II, and SAVE a copy before you RUN it. This short BASIC program will alter a few bytes in your original DISKIO AUTORUN.SYS file and make it work with DOS 2.5 as well as DOS 2. If you're happy with DISKIO as is, you can stop reading right here. But if you want the full package of extras-like multiple file moves, wild cards, macros, BASIC XL/XE and MAC/65 compatibility-read on.
Still with us? Listing 1, DSKIOMAK.BAS, creates DISKIO PLUS. It's a lot of typing, but worth it. Type it in very carefully, check it with TYPO II and SAVE a copy. All that data is machine language and every number must be absolutely correct.
When you RUN Listing 1, it will count the data statements to make sure you have the right total. Then it will ask you to specify a filename. If you're using Atari DOS, call your file AUTORUN.SYS. DOS XL users should name theirs STARTUP.EXC.
Next you're asked if you want your DISKIO PLUS for BASIC or assembly language. Choose your favorite language and the program will create a binary file of 30 sectors. (That's right, it's a little longer than the original. DISKIO eats 3129 bytes of RAM while DISKIO PLUS gobbles 3408.)
Listing 2, KEYMAC.BAS, is a special utility which will be described later. You don't need to type it in to make DISKIO PLUS work.
Antic Disk subscribers will find all three of the above listings on their monthly disk, under the filenames previously mentioned.
There are a lot of options and commands with DISKIO PLUS. Maybe a little scenario will clarify things.
You decide to do a bit of programming in BASIC, so you boot your disk containing DISKIO PLUS in the form of an AUTORUN.SYS file. (Note: the assembly-language version of DISKIO PLUS operates identically to the BASIC version with the exception of using the [#] for file access).
A brief title screen appears to let you know DISKIO PLUS is installed, then the READY prompt pops into place.
You want to see what files are on the disk, so you type DIR [RETURN], and the DIRectory of drive 1 appears with all the files in alphabetical order, looking something like this:
1 AUTORUN SYS 030 5 MYMAC KEY
2 BIFFIII BAS 057 6 RANDISK COM 009
3 DOS SYS 074 7 SAMPLE BAS 014
4 DUP SYS 042 8 WORDTREEOBJ 001
479 FREE SECTORS
Notice the numbers immediately before each file. These
are "file reference numbers" and are used by the DISKIO PLUS "one-dot"
What's a one-dot command? Let's say you have decided to delete the file called SAMPLE.BAS. Since it has a reference number of 7, you type: .D7. A prompt will appear to make sure you really want to do this. Answer the prompt by pressing [Y], and the file will be deleted.
Want to LOAD a file? Type .L2. You can rename a file by typing:
How about moving a file from drive 1 to drive 2? Type .M6/2.
And for you jaded DISKIO users who have seen most of this stuff, how about
wild-card multiple file moves? Type .M *.*/2 to move all files from
drive 1 to drive 2.
And-oh yes-that BASIC program you LOADed is still in memory-untouched and ready to examine.
At first there may seem to be a lot of combinations here. But once you get used to the structure of DISKIO PLUS commands, you'll find them to be automatic, natural, and very fast. In most cases, the commands use an identical pattern with only one different letter to differentiate the command.
Let's examine all the possibilities with only one command; the command to locK (protect) a file:
.K [n] [filename] [device:filename]
The first, and most important, character is the period-
or dot. This tells the computer that a DISKIO PLUS command is coming. Next
is the letter signifying the type of command-in this case K, for locK.
The square brackets indicate optional parameters. They are not part of the DISKIO PLUS command.
You can reference the file you wish to locK in three ways. The first optional parameter is n, which stands for file reference number. If the directory is showing on the screen, you may use the file reference number as: .K4.
This will locK file number four. Remember, the directory must be on the screen in order to use file reference numbers.
The second set of brackets shows we may alternatively type in the filename: .KMYFILE.BAS. Notice there is no space between the command letter and the file name.
Should we wish to locK a file in a drive other than the default drive, we can also use the device:
This example will locK MYFILE.BAS on the second drive.
Wild cards [*] may be used with the second and third options. You can locK all the files by typing .K * *.
All of the DISKIO PLUS dot commands work the same as locK, with the exception of some which have a few extra possibilities. If you forget a particular command, type HELP and the following menu will appear:
.N = RENAME
.M = MOVE
.D = DELETE FORMAT
.K = LOCK DIR
.U = UNLOCK OFF
.X = LIST ON
.S = SAVE LIST
.E = ENTER WDOS
.L = LOAD DEF1
.R = RUN DEF2
.B = BINARY LOAD DEF3
Let's go through the commands one by one.
Notice there are two types of commands-one-dot commands and "word" commands. The most used word command is DIR.
Type DIR [RETURN] to see an alphabetized DIRectory of files. If you have more than one drive, place the number of the drive directory you wish immediately after the command: DIR2.
Once a disk drive number is specified, that drive becomes the "default" drive. For example, after typing DIR2, all commands-including DIR-will affect drive 2.
By adding a /P (slash P) after the command, you can send the directory of any drive to a printer. You may also specify a filename: DIR3/P * .OBJ will send all files on drive 3 with .OBJ extenders to the printer as well as to the screen.
FORMAT will format the default drive. You may format another drive by placing the drive number immediately after the command. A disk in a 1050 drive defaults to enhanced density under DOS 2.5. Should you wish to Force the format to single density, type FORMAT/F As with most DISKIO PLUS commands, you will be prompted to verify this command by pressing [Y]. (Old-time DISKIO users should note there will be only one prompt).
Five of the one-dot commands use identical parameters to the .K lock command described above. They are: .U, Unlock; .S, Save; .E, Enter; .L, Load; .R, Run. In each case, you may specify the filename, or the device and filename. If the directory is showing, you can also specify the file reference number.
Use .N to reName files. This is a little different from other dot commands because it requires you to enter a new name for your file. The filename parameters, however, are identical to other dot commands, followed by a space and the new filename. For example:
.N6 NE WFILE .TXT.
DISKIO PLUS will not allow you to create duplicate files.
Since the directory is alphabetical, you should re-list it after renaming
a file because the files may now be in a different order with altered reference
To LIST a file to the disk, use the .X command. With this command, you may also specify starting and ending line numbers. Should you wish to LIST a file from a particular line number to the end of the file, sandwich the line number with commas: .X7,360,.
You may LOAD Binary files from DISKIO PLUS with the .B command. No check is made to see what the Binary file might write over, so this could cause a crash. Should you wish to LOAD-but not RUN-the Binary file, append /N (slash N) to the command. If the file specified is not Binary, the LOAD will be aborted.
The Move command has many options, but we're always Moving a file, or files, from a "source" to a "destination."
Let's look at some examples. To Move reference-numbered 6 file from drive 1 to drive 2, where drive 1 is the default drive: .M6/2. You can also type:
or .MMYFILE.BAS D2:MYFILE.BAS.
You can change the destination filename:
or .MD2:MYFILE.BAS D:NEWFILE.BAS.
As previously mentioned, you can use wild cards on file
Moves: .M * .0BJ/2.
When using a single disk, you will be prompted to insert your source and destination disks. These prompts will also work with wild-card multiple file Moves.
By adding /S or /P to the Move command, you may Move the chosen file to the screen or printer. .M6/S Moves file #6 to the screen. .MMYFILE.LST/P prints the BASIC file, MYFILE.LST to the printer.
Naturally, only a text file or LISTed file will make much sense. But you can disable screen control characters during a screen print by adding 1 to the /S extender:
TURNING IT OFF
Caution! DISKIO PLUS can get in the way of string input in BASIC programs. While inputting a string, DISKIO PLUS will act upon any input that can be interpreted as a DISKIO PLUS command.
For example, suppose your program prompts you for input and you type in DIR while DISKIO PLUS is active. DISKIO PLUS will print a DIRectory.
Luckily, it's easy to get rid of DISKIO PLUS. Type OFF to disable it, and type ON to bring it back. Type OFF and press [RESET] to permanently disable DISKIO PLUS.
[SYSTEM RESET], by itself, will not affect DISKIO PLUS. You may also disable DISKIO PLUS from your program by POKEing location 10592 with a 255. POKE the same location with a zero to turn it back on.
DISKIO PLUS takes up some of your RAM and there are times when you need all the memory you can get. To get full memory, permanently disable DISKIO PLUS, as described above. Type DOS, then return to your cartridge. (Note: this will not work if you are using MEM.SAV).
BASIC XL has a command I've always liked, so I added it to DISKIO PLUS so other languages could use it. LIST, or L., followed by a line number and a comma, will LIST the resident program from that line number to its end. Otherwise LIST will function identically to the Atari BASIC command.
You may write whichever DOS is resident to disk by typing WDOS. If you wish to write to other than the default drive, follow the command with a drive number.
This function will not work with DOS XL. Also, DISKIO PLUS will not work with the supercartridge version of DOS XL.
DISKIO PLUS allows you to create as many as three single-key macros.
Let's say we're getting tired of constantly typing PRINT #6.". In stead, we type:
DEF1 P PRINT #6;" [RETURN].
Now, whenever [P] [RETURN] is pressed, our phrase will
be printed to the screen. Anytime after defining a macro, type HELP
and your macro will appear on the screen. You may edit the macros directly
on the HELP screen.
Your macros can call other macros, or call DISKIO PLUS commands. DEF3 D DIR8, will call the RAMdisk directory on the 130XE whenever [D] is pressed.
Macros are limited to 30 characters, and you can use control characters-but not special control characters such as the screen-clear symbol. Also, the macros are not casesensitive. Though you may enter key-command and the characters in inverse or lower-case, macros will reappear in normal, upper-case.
You can replace existing macros by redefining them. If you wish to completely delete a macro-DEF1, for example-type DEF1 [SPACE] [ESC] [ESC] [RETURN].
MACRO FILE MAKER
Listing 2 is a BASIC program which will save any currently defined macros into a one-sector binary file which can be loaded into memory with the .B command. This way you can create any number of macro files and instantly load them as needed.
Type in Listing 2, KEYMAC.BAS, check it with TYPO II and SAVE a copy.
Now, create some macros and make sure they're on the HELP screen. RUN Listing 2 which will ask for a filename. Device is optional. An extender of .KEY will be automatically added.
Now, whenever you boot DISKIO PLUS, all you have to do to create your macros is load the .KEY file with the .B Binary load command.
Note: Listing 2 will disable DISKIO PLUS during its run, so if you press [BREAK], don't press [RESET] until you've turned DISKIO PLUS back ON.
Remember, DISKIO PLUS commands will react from BASIC string input. So will macro commands-so if you're getting strange results from a BASIC program, turn DISKIO PLUS to OFF.
Also, DISKIO PLUS takes up some of your RAM. If you receive an ERROR 2-Out of Memory, you may need to get rid of DISKIO PLUS as described above, in Turning It Off.