💾 Archived View for mirrors.apple2.org.za › archive › www.textfiles.com › apple › DOCUMENTATION › ch… captured on 2024-08-19 at 03:07:03.
⬅️ Previous capture (2023-01-29)
-=-=-=-=-=-=-
CHANGE-A-FILE
by
Harold D. Portnoy
======================================================================
Be sure to copy CHANGE-A-FILE before using!!!
---------------
Because of the time spent in developing this program, I find it necessary
to charge a small fee for the use of some of the utilities in CHANGE-A-FILE:
Convert AWP to TXT, TXT to AWP, AWP 3.0 to 2.x; AWP File Doctor, Exhume AWP
file, and Restore ADB file. These utilities are protected with a password that
will also apply to future revisions. The remainder of the utilities remain
free.
The same password also unlocks the Auto-Restore function of the repair
file program, RESURRECTION.
To obtain the password, send $10.00 to:
Change File
c/o Harold D. Portnoy
1431 Woodward
Bloomfield Hills, MI 48302
**********************************************************************
When an AppleWorks word processor or data base file goes bad is not the
time to worry about how you are going to repair the damage. AWP File Doctor and
Restore ADB can repair these files. Each of these utilities, alone, are worth
the small fee in time saved.
**********************************************************************
CHANGE-A-FILE - -
CHANGE-A-FILE is a batch file utility that reads AppleWorks Word Processor
(AWP) and text (TXT) files; converts AWP files to TXT files, TXT files to AWP
files, and AWP 3.0 files to AWP 2.x files; restores damaged AWP and ADB (data
base) files; change file or auxiliary type codes, and strip line feeds. Up to
88 files in a directory or subdirectory can be altered. This program uses the
Bredon ProSel utilities type of format. CHANGE-A-FILE is particularly useful to
the AppleWorks (AWKS) user and to prepare files for uploading or alter files
after downloading.
Password
CHANGE-A-FILE is a system file. When run, the user is initially presented
with a password screen. Entering the password allows the user to access all the
program's utilities. If the password is not entered only the last 6 utilities
listed below can be accessed.
Activating protected utilities and removing password screen
Transfer the program file to the volume directory of a disk under ProDOS
(P8). Rename the file to CF.SYSTEM. Be sure this file is the first .SYSTEM file
in the directory (e.g. ahead of BASIC.SYSTEM). Boot the disk. (You must boot
directly into CF.SYSTEM.) The password screen will be presented. Enter the
password. When the menu is presented, select Quit. The file will be rewritten
to the disk without the screen. Rename the file to CHANGE.FILE or any other
name of your choice. Whether you have the passwo
rd or not, the password screen will be removed. If you enter the password, all
the utilities will be able to be used. If not, only the 'free' utilities will
be able to be used.
If RESURRECTION is placed in the same directory as CF.SYSTEM, the Auto-
Restore function will be unlocked on entering the password and then quitting.
Menu
The program menu is as follows:
________________________________________________
Q- Quit
X- Convert AWP 3.0 to 2.x
W- ... AWP File to TXT File
T- ... TXT File to AWP File
D- AWP File Doctor
E- Exhume AWP File
R- Restore ADB File
V- View File (TXT, AWP, etc.)
F- Change File Type/Aux. Type/Access Code L- Strip
Line Feed after Carriage Return
C- ... All Control Characters
S- ... Specified Control Character
I- Insert Line Feed after Carriage Return
________________________________________________
The appropriate utility can be selected from the main menu with the light
bar selector, by entering the appropriate letter or by using the mouse.
Pressing RETURN, a letter or the mouse button accepts the selection.
Directory Selection
The volume directory name is the initial default directory. The default
source directory or destination directory can be accepted by pressing RETURN or
mouse button. Any directory online can be entered. These directories will
remain the default directories until changed or the program is quit. The TAB
key tabs to the next slash in a directory pathname and then to the end of the
pathname. Control-X switches the source and destination directories.
Alternately, the prefix can be selected by pressing the Closed Apple (Option)
key. A list of directories is presented from which one can be selected in a
manner similar to that in AppleWorks (AWKS) 3.0. The up and down arrows or the
mouse move the light bar selector, RETURN or the mouse button selects a
subdirectory and Open Apple-RETURN accepts the completed directory name. If an
error is made, pressing TAB lets you restart the selection.
File Selection
Files are selected or deselected with the spacebar or mouse button. A
check mark is placed in front of the selected file. The light bar can be
positioned using the four arrow keys or mouse. When using the spacebar or mouse
button to select a file, the selection is made in the direction first
initiated. After selecting the desired files, press RETURN. ESCape always
returns you to the main menu.
The Utilities
Convert AWP 3.0 to 2.x file. Usually AWP files generated by Appleworks
3.0 cannot be read by versions 2.1 and below. If you do not have version 3.0,
an AWP 3.0 file can be read by your version of Appleworks by converting the AWP
3.0 to an AWP 2.x file. The suffix ".X" is added to the file name. If the
original name is greater than 13 characters, the last two characters are
replaced with the suffix. This utility is particularly useful for those AWKS3.0
users who would like to upload AWP files that can be read by all versions of
AWKS.
The AWP 3.0 file is not converted if it is already compatible with the AWP
2.x format and the source and destination directories are the same. This is
indicated by a bell and a diamond replacing the check mark.
Convert AWP to TXT file.
This utility converts AWP files into text files. In preparation for
uploading, each line is followed by a carriage return. If you want a carriage
return only at the end of a paragraph, press the Open Apple key at the start of
the conversion. Pressing the Open Apple key also sets the left margin to zero.
The text file created is designated by the suffix ".W" added to the
original file name. The original file is preserved. The auxiliary file code is
changed to $0000.
Convert TXT to AWP file.
This utility converts TXT files into AWP files. The conversion,
particularly of multiple files, is considerably faster than using the
AppleWorks from text file option. Only sequential text files are accepted
(auxiliary file code = $0000). The new file is designated by the suffix ".T"
added to the original name. The original file is left undisturbed. When loaded
into AppleWorks, the file may not properly word wrap. This is easily corrected
by changing any margin justification.
AWP File Doctor.
When an AWP file is damaged, it cannot be loaded into AppleWorks instead
the 'Getting error trying to read ...' message is displayed. The AWP File
Doctor will almost always restore the non-corrupted portions of an AWP file to
a new file that can be loaded into AWKS. The restored file has the suffix ".D"
added to the file name. Asterisks replace the bad bytes, however, if the bad
bytes are text characters, these characters may be displayed. The characters
usually make no sense and are easily identified. Except for the damaged text,
the new file requires no revision.
If the file is loaded into AWKS 2.x and the 'Getting error .." message is
still displayed, first convert the file to AWP 2.x format using Convert AWP 3.0
to 2.x, reload the file and try again.
Exhume AWP.
If the file is so damaged that AWP File Doctor cannot repair it, then
Exhume AWP should be tried. Exhume AWP restores the AWP file by searching for
text characters. The restored file contains all characters in the text
character range. Thus text characters that are not part of the original text
will be included (frequently an additional character at the beginning and end
of a text line). Non-text characters are replaced with an asterisk. If the
number of characters exceeds 79 only one line of asterisks is added. The
repaired file has the suffix ".E" added to the file name.
The exhumed file when loaded into AWKS must be edited to remove spurious
characters and add any text that may have been corrupted. This is the hard part
of the repair, but usually not as hard as having to rewrite the whole file from
scratch.
It is suggested that a damaged AWP file be processed by both the AWP File
Doctor and Exhume AWP. The former will reconstruct almost all of the file in a
form requiring virtually no revision. The latter may extract a few more words
of value.
Restore ADB
If an AppleWorks Data Base (ADB) file is corrupted, the file can be
restored with Restore ADB. Damage can occur within a category, to individual
records or to the header. Damage limited to within a category is flagged with
an asterisk. If one or more categories have been damaged, the entire record (or
contiguous records) cannot be restored and the first category in the record(s)
is flagged with the message '** DAMAGED RECORD(S) **'. When this message occurs
as the first record, a report record may actually have been damaged.
If the file header is damaged, a standard header is substituted, which
contains 30 categories. Category names may or may not be restored depending on
whether the names were damaged. Report formats will be lost and have to be
reentered. Occasionally, if the file still cannot be loaded into AWKS after
processing with Restore ADB, the file may still be restored by forcing the
standard header. This can be done by pressing the Closed Apple key when the ADB
file is selected.
______________________________________________________________________
NOTE: AWP File Doctor, Exhume AWP and Restore ADB will restore files with
bad blocks. The message '** BAD BLOCK **' is inserted when a bad block is
encountered. These utilities cannot repair a file if the volume directory or
subdirectory are damaged (and sometimes the file directory pointing to the data
blocks in the file). If one of the directories is damaged, I suggest using the
ProSel utility, Mr. Fixit or my new utility, RESURRECTION.
If you have a file that cannot be restored and the various directories are
intact, please send it to me so that I can improve the algorithms used in the
AWKS and ADB repair utilities. Copy the disk on which the file exists using a
nibble copying utility such as Copy II+ and send the copy, not the original.
Occasionally, when several blocks have been damaged, AWP File Doctor will
produce a new file that cannot be loaded into AWKs. Try using AWP File Doctor
again on the new file. This will usually restore the file. If not, use Exhume
AWP.
______________________________________________________________________
View file.
This utility will read any file. It works best with text files. Control
characters are presented in uppercase inverse. The spacebar stop/starts the
file.
If the file is an AppleWorks word processor (AWP) file (AW 3.0 and lower
versions), it will automatically read it properly. (Read AWP is no longer a
separate utility.) This allows you to rapidly review TXT or AWP files in order
to determine if you wish to use or convert them. The spacebar allows you to
step through the file. Restart scrolling with the down arrow key. The RETURN
key can be used to abort the file. The left margin is automatically set. For
convenience, the file may be output to a printer. Reading AWP files works best
when the characters per inch is 10. If word wrap appears defeated, try pressing
Open Apple at the beginning of the conversion (see AWP to TXT above).
The printer output is set to slot 1. If you use a different slot, then
change the low nibble of byte $05 (C1) to the slot number. This is most easily
accomplished using a block editing utility such as ProSel Block Warden.
Alternately the following patch will suffice after setting the prefix to the
directory containing CHANGE.
FILE.
POKE 768,19n (where n = slot number + 2)
BSAVE CHANGE.FILE,TSYS,A$300,L1,B5
Change file type, auxiliary type or access codes.
Any file type can be altered. You are responsible for the alteration. No
checking is done. Following selection of the file(s), the previous file type is
presented at the cursor and can be accepted as the default by pressing RETURN.
Alteration can be accomplished using the designated file type abbreviations
displayed (e.g. BIN, TXT). Or, if the abbreviation is not listed, by entering
the hexadecimal code (e.g. $04, $06). If you have a favorite abbreviation that
is not listed then the list can be altered
.
Using a block editor, such as ProSel Block Warden, the abbreviation list
can be altered to suit yourself. The file type table begins at byte $07 with A0
A0 A0 20. There is another similar four byte combination that can be changed to
a three byte ASCII abbreviation, which replaces the three A0's, followed by the
file type code, which replaces the 20. Alternately, one of the other
abbreviations can be changed along with its following file code byte. (Note: To
my knowledge, there is no assigned abbreviation to code 20.)
After the file type code is accepted, the auxiliary type code is presented
and can be altered by entering the appropriate code at the cursor. When the
auxiliary type code is governed by the file type code (e.g. SYS always loads at
$2000), the appropriate default can be accepted by pressing RETURN or the mouse
button.
The file access code can then be altered. The file can be toggled locked
or unlocked, or each of the recognized bits in the byte can be separately
toggled. The bits are 7 (Destroy-enable), 6 (ReName-enable), 5 (BacKUp-needed),
2 (INVisibility, GS/OS only), 1 (WRiTe enable), 0 (ReaD-enable). If the bit is
set (1), then the bit is enabled. If cleared (0), then the bit is disabled. If
bits DES,RN and WRT (7,6,1) are all set, then the file is considered unlocked.
If any of these bits are cleared then the file is considered locked. The right
and left arrows and the mouse move the cursor. The spacebar toggles whether the
file is locked or not as well as the individual bits. The RETURN key or the
mouse button accepts the displayed values.
NOTE: The changes in this section are not written to the file until the
final RETURN. ESCape always sends you back to the main menu.
Line feed stripper.
This utility strips line feeds that follow a carriage return. Only text
files are accepted. The original file is preserved.
Two other control character strippers are available. One removes all
control characters, and the other will remove any specified control character
(^J = line feed). If the specified control character is 'M' (e.i. carriage
return), then a space is substituted for the carriage return. All the control
character strippers designate the altered file with the ".C" suffix.
Insert line feed after carriage return.
Some users apparently wish to communicate with Big Blue machines. This
utility inserts a line feed after each carriage return in a text file, which is
required by IBM and IBM compatible computers.
And for those of you wishing to read from the UNIX system, press the Open-
Apple key before entering 'I'. This will convert line feeds to carriage
returns.
When converting files or stripping a control character with only one disk
drive, the source and destination volumes must be the same.
Icons
CF.RES.ICONS contains Change-A-File and Resurrection icons. The Change-A-
File icon is courtesy of Karl Bunker. To use these icons in the Finder, place
CF.RES.ICONS in the ICONS subdirectory of the boot volume
(BOOT.VOLUME/ICONS/CF.RES.ICONS) and reboot. The two programs must have file
names of CHANGE.FILE and RESURRECTION.
Suggestions, bugs and other trivia to:
Compuserve [75156,2436]
GEnie [H.PORTNOY]
All rights reserved.
AppleWorks, copyright Claris Corporation
ProSel, copyright Glen Bredon
Copy II+, copyright Central Point Software, Inc.
Version updates:
1.95- Add output to printer for Read AWP.
2.0 - Add Convert TXT to AWP
2.05- Minor bug
2.1 - Add ability to Change Access Code. Cosmetic
alteration to Change File Type.
2.15- Clear backup bit now works correctly.
2.20- Fix bug in alter auxiliary type code.
2.30- Add mouse to menu and file selector.
2.35- Add mouse to pathname selection.
2.37- A smoother mouse.
2.40- Corrects input bug.
2.41- Add mouse to file type, auxiliary type, and aux
code.
2.46- Corrects bug when used with IIe and single
drive. Adds clock.
2.48- Corrects bug in quit when used with IIe.
2.61- Update to AW 3.0 format in read AWP and AWP to
TXT.
2.63- Eradication of small AWP to TXT infestation.
2.64- Eases AW version conversion.
2.66- Adds AWP 3.0 to 2.x converter.
2.68- Adds View File (by request of several users).
2.69- A few cosmetic changes.
2.71- Corrects bug that prevented proper launching directly
from P8 and certain selectors.
2.73- Update of AWP 3.0 format and a few cosmetic changes.
2.75- Adds directory name selector.
2.76- Bug correction in AWP 3.0 to 2.x.
2.77- Bug correction, View file, IIc only.
2.78- Corrects bug in TXT to AWP and AWP 3.0 to 2.x. AWP
header byte +004 must be $4F (ruler length) otherwise
the new file cannot be saved properly when using
AWKS 3.0 (does not effect AWKS 2.x). 2.81- Adds Exhume
AWP which extracts all text characters
from a damaged AWP file. For highly damaged files and
requires considerable editing. Also corrects a few bugs.
2.85- Adds AWP File Doctor. Corrects several minor bugs and
adds some cosmetic changes.
2.87- Adds Restore ADB, a utility for restoring ADB files.
Read AWP is now included under View File.
2.88- Corrects bug in Restore ADB.
2.89- Now able to restore AWP and ADB files with bad blocks.
2.90- Some improvements and a dead bug.
2.91- Additional header information preserved in Restore ADB.
2.92- Fixes bug in password. Updated documentation.
2.93- Improved bad block routine.
2.94- Bug fix and now, if specified control character is ^M
(e.i. carriage return), a space is substituted.
2.95- Password scheme changed so as to activate RESURRECTION
Auto-Restore function.
2.96- Remove bug from RESURRECTION activation scheme.
2.97- Add insert line feed after carriage return. Bug fix
in strip line feed after carriage return.
2.98- Password scheme change made necessary by RESURRECTION
change.
2.99- Add convert line feed to carriage return.
3.00- Correct minor bug in directory input.
3.01- Correct bug in filetype listing when over 66 files