delaney@wnre.aecl.CDN (Grant Delaney) (07/23/87)
Documentation for EXECUTIONER
by Glen E. Bredon
The EXECUTIONER will take a ProDOS file of any type and convert it to an
EXEC file for uploading. The file parameters (such as file type) will be
correctly put in the EXECed file.
Directions:
0. An ESC at any (Y/N) prompt quits the program. At other places it
usually sends you to the start of the program. Hitting RETURN on
an empty filename also aborts the program as will Control-open apple-
RESET.
1. You are asked if you want packed mode. A packed file is still a text
file but is compressed relative to standard dumps and an interpreter
routine is written into the file so that the file can still be EXECed.
Packed files are much shorter than unpacked ones and are recommended
for large files. The packed mode includes a checksum and the EXEC
will produce an error message if the checksum is not ok. (The file
will still be saved but its parameters will not have been fixed.)
2. If you chose packed mode then you are asked if you want 4 bit or 6 bit
packing. The 4-bit mode just removes space between hex bytes. The
6-bit mode is a denser packing in which lower case characters are
significant. It is possible that some people will have trouble with
the EXEC of such files. Time will tell. For sizable files, the
4-bit compression is slightly more than twice the original file size,
while 6-bit mode produces a file about 45% larger than the original.
3. You are shown the current prefix and you can type over it to change it.
Just hit return to accept it as shown. Hit ESC to go to the start of
the program. You MUST set the prefix to the directory containing the
file you want converted.
4. The directory specified by the prefix is read and the last file in
that directory is displayed after a prompt for the file to be converted.
You can use the up/down arrow keys to see other files in that directory.
(The last one is displayed first because it is expected that that will
be the usual selection.) You could also backspace to the beginning and
just type the name of the file you want to convert.
5. You will be shown some of the file characteristics of the file you have
selected and asked if it is correct. If NO then you go back to the
start of the program. If YES then the file is loaded for processing.
6. You are asked for the name of the destination EXEC text file. This can
be a full pathname if you want it in another directory. If you hit
return on the first character, the program is aborted, if you hit ESC
then you return to the start of the program.
7. If the text file exists, you will be asked if you want it deleted.
(A locked file is never deleted, that would defeat the purpose of locking
it in the first place.) If not, or if you answer YES then the program
proceeds to create the EXEC file.
8. When the file is made, you are asked if you want to do another. If YES
then you return to the start of the program. If NO, it exits. The
EXECUTIONER is a SYS (stand alone) program, so it exits through the
"quit" routine.
9. Note that the created EXEC file always has a "header" placed at $E00, then
the hex code of the converted file, placed at $1000, then a BSAVE command
then a E00G or E05G as the last line. Do not modify this last line;
it is essential. Also, do not modify the file name it is saved under,
which is always the original name of the file. This name is also in
the "header" and if it is changed in the BSAVE line, the EXEC will not
work correctly. In the packed modes there is an empty line before the
BSAVE line. This is essential as it is the signal for the decompressor
that the data is finished.
10. If the original file is a BAS file then, after step 6, you are asked
if you want a BASIC listing EXEC file. This is just a listing with
spaces removed and "PRINT" changed to "?". (There is no check on too
long lines.) If you chose this option then previous answers to the
packing questions are ignored. This is just a conveniece feature so
that separate means of making such files are unnecessary.
11. You can use the "startup" position in the EXECUTIONER file, or the
startup in PROSEL or other program selectors to specify the destination
file directory (or the entire pathname if you want). For example, if
the startup is "/HARD1/MODEM/" then in step 6 above, this text will
be placed after the prompt the cursor following it. You can modify
it just as if you had typed it.