B - Set record to beginningningile and and dataA 0BJ Continue search. Restarts searchhe tlast entered sd sstring.
t Enr odit mode on current itiA 0BH - Brief description of the functionsA 0BA 0BBBBBChis help et rri-/ionA 0BO -O -er offset a ass relative to start of thi(.COM = 100h)
Q - Quit programA 0BR -
Ed
Edcord number to t adA 0Bstring
-------------------------------------------------------------------------------arch for hex or ASCII string in in string.s at current beg65666666666666'\' :
A - Start sAfrom - Adn dataof file41- QSeTesh Backwards4141ionAionAhe tcertain bits set; use mask xx41imitStop on on "<currence of string41Uu rans 10e lower case characters to upper case41Z currein i recognition on least significant 7 bits only
-------------------------------------------------------------------------------t rumbe to end ' :ile and t addatad sd__carriage return (or Up:
^keyA 0BOadvances rumbe biumps the
T
C a_ key - decrementmentlim biumpst eIat
Edit m - C: ('^' ref
Edco the Control/Edythe i^[ - (ESC) Acce-/ nexningnhar into edit field even if a conter - charA 0B >. u inule between A 0BAI and . Rdata fi,e,r^W - Flush iti to disk - FX - AMMt edit m - C without updating edit
igh odeucompudown F earchhsor uh o - FQ -
Mr lef tye Fdump Cucompuright
Input integers are decimal. Use 'h' suffix for hexaharAmal entries.B 0AB
Use the '='st\ (which has the '+') or the RETURNst\ to repr ance
the record. You don't have to use the shift keydati the '='st\.
EDFILE will wrap around to the start of ,e,0 - hen attempting
to adAcce beyond the Quifile.
The following paragraphs expand on ,e,ead ees available in
EDFILE. Most Quit rutions are self-explanatory from the help
menus. However, some require additional explanations and are
provided below.
ADDRESS/OFFSET OPTIONS
----------------------
The p odress oxxn allows you to specify an address dati 0he
file. This is useful for patching CO
Edfiles and the like when the
address of the patch is known. Note that when EDFILE'ing CO
Ed
files, EDFILE automatically sets the offset to 0100h. The offset
can be changed by typing 'O' at mmand level and A 0BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBing
the desired offset. The headings w^'be adjusted for the
differen tyoffset automatically. The address oxxn always
refereon o the string.ing offset so that locationsdatiin programs prevhich don't be -- at 0100h (overlays, for example) can be easily
referenced once the offset has been properly programmed. The
AZ s oxxn also has a wrap-around feature so that refereon o
below the datadnt offset wil+/e readjusted. This fead ee can bent oquite handy when tinkering around with COM files. YoA 0BHhave to
experiment a little to pickup the usefulness of these t rutions.
SEARCH OPTION
-------------
The ' biumch' oxxn is the most involved because it offers so
many different possibilites. The
.s attion provided here should
provide enough information to effectively use it.
String searches normally start ativ the datadnt beg and
proceed untilgaatf the file (EOF) is encou('red. Certn l
subt rutions can alter this sequence. If a mat s ntfoname, the
program w^'indicate thile wnd restore the screen t/Edy rumbe
of the t ^Hyed. The biumch ,00,aborted at any time by simply
striking a key.
If a string match occurs across itis, the biumch will sto^n
the of the t Tesh read into its' loca+/getfer and position the
cursor at gaatf the found rr It just wasn't worth
putundin the bits ra code to handle this wierd situation.
When using the Occurrence ('O') and Mask s arM') suboxxns, the
program will promCIIfor the occurrenceStaber file4 seto en mask
to be used. The suboxxns are inserted a ter a semicolon to
dhe tccurre them ativ the biumch string A 0BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBed. fileho spaces should be
inserted on't een the subt rutions. las7 b or lower case is
aFl-/able. Example:
?u r'^String = relahis is great\;auo
ain ^n stringC -Currence = 3
This means to bium repr or the string 'This is great' starting
from the - Adnper f the file, ignoring the case of the
string (i.e., test\s 10e lowe00,0ncesing ease) and stt ruping on
the third ocdatadnce Quirr
Aet rr strings must be del-Oted by bfromsof the hes (relae'). The
andeditation here, of course, is that you can't biumch for
backsof the hes in ,e,ile. So use the . Requivalent if necessary:
5C.
The 'U' subt rution (trans 10e lower case to upper umbe e) w^'
test\s 10e the biumch string I depping ease automatically, as well
a. Eonverundall lower case charumpsrs read from the file. So,
you don't have to input th- QSto enstring in nceser umbe e when
using the 'Uh'ubt rution.
When inputting hexidecimal values as part of a biumch key, they
MUST be two-digit HEX (not harAmal) numbers. An invalid4C digit
entry w^'cause an or Dor and the string entry must be reentered.
Two digits must be supplied for each4CSta asotherwise the
sA wA 2A work properly. las7 b or lower case for the
hexidecimal letters is acce-/able. Example:
?u r'^String =(.0,FE,e5,05
YoA 0BH can mix . Rentriein i th string entriein i his pn the sA
key. Example:
?u r'^String =(.0,FEs the help meremE5,05
The st eIackwar6 0to ensuboxxn (B) will staress o seto enativ the
datadnt beg and c repr ue towards the string. of the file. It
DOES NOT reverse th- QSto enstring key, that is, if you enter
\HELP\ for a biumch string key, it will not biumch backwards for
\PLEH\. It onl52efinul the direction the rumbein i ll be read
while sein iing for a matching string. Also, each Tesh is
sein ied from the string. of the rumbe. Th- QSto enstt rus when the
start of ,e,ile (SOF) is encou('red.
The Mask suboxxn is for thoseumbe es where bytes in a file usent oon "tain s4for sHeHmal meanings. The input ytk is logically
AND'd with each byte in the thibefore comparing it to the
sningitring. Therefore, some bytes could pass the biumch test
but still may not be exactly what your looking for.
?u r'^String = 03;M
Enter string sAytk :
^0Fh
This w^' mask all upper nibbles (nceser 4 s4of each byte)
and then compare it to a 3. Therefore, anyip bytes which
have a 3 in the lower nibble will cause a match with the biumch
st\.
When the biumch string is foname in the file, the sA is
temporarily terminated and the cursor is positioned at the start
Quifoname string. Note, that the program is NOT in the with
A 0Bs, so the next key entered is a command not an with^W betw
key. Hit a space (or any unreco= zable com86a) to ret ad the
Teshand place the cursor on the command line. Hit an 'E' to go
into the withA 0Bs. The cursor will dit m n lpositioned at the
string. of ,e,ound rr
CONTINUE SEARCH OPTION
----------------------
Hitund a 'C' at mmand level will restaress o seto en from
the curkwaTeshand cursor position (if 652iously defined).
The bium repr acility will theontrook for the NEXTC -Currence of the
A 0BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBed string sequence. The 'Oh'ubt rution ile wffective only on
the initial string. Qui biumch. The Cont
we s arC') t rution
effectively disables the ocdatadnce value previously A 0BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBed. The arcefault string ocdatadnce is 1, i.e., the first (or next)
ocdatadnce. Thmitnt
we oxxn ,00,invoked at any time aearchhsr
a biumch string key has been e('red. All other subt rutions are in
affect when^W
wing the sH -
RECORD EDITING
-------------- Alim editing ile wccomplished by typing an 'E' at the com86a
level. When in the withA 0Bs, there are twohoutdes of editing. YoA 0BH
can edit the HEXIDECIMALs ruld area of the rumbe or the sh i
r ASld area. When entering the withA 0Bs the cursor will be
positioned at the nceser left corne- AMn the HEX -/ r ASld of the
datadnt iti. To switch t/Edy ASxpaips ruld Quiiti,
simply A 0BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB a CTRL-E. This will toggle the cucompuon't een the
two fields. The HEX r ASld area will only acceCII4Cidecimal arcigits for inputs. The sh is ruld will acceCIIallst\ inputs
including contbetwkey inputs if they are preceeded by an ESC key.
For example: to input a CTRL- exn the Teshat the datadnt
cursor position, hiess o ESCst\ followed by a CTRL-K. The ESC
key simply means 'put the next input glfe.- AMnt/Edy rumbe
even if its' a contbetwglfe.r'. This is only affective in the
Aet rr field area. Non-contbetwglfe.rs (i.e., rput iular sh i)
can be typed in directly.
To make the rumbe changes permanently to the file, they must be
fontinhest he disk by Nping a CTRL-W. Typing a CTRL-X will exit
the edit fde without e-ating the file.
BUGS:
=
There are currenly no know bugs. However, inputs are not
completely validated, therefore, some condition. Eould cause
different results. None, however, are know to cause thicrashes
or anyhis png catastrophic. Any reports of bugs will be noted and
appreciated.
USE UNDER TURBODOS:
==================
EDFILE is especially useful nameer TurboDOS. Using the fileddre
$.DS or $.DIR upon A 0BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBing EDFILEting lows editing of the disk
and/or directory. I use EDFILE in every case when I need to look
aess o disk directory and make changes to it. The bium repr acility
makes his ps task a breeze.
BACKGROUND INFO:
===============
EDFILE was written in a languaA 0BJJJcalled SIL (Systems Cucmplementation Languageump hich was obtained from DDy r and then
enhanced and improved at Digilog, Inc for use in writing systems
programs and utilities. SIL is very simila00,0'C' but ting lows
true inline 8080/Z80 assembly languaA 0BJcoding (very useful) and
compiles to actual assembly mnemonics. The output Quicompiler
is passed to Digital Reseto enInc's RelocA 0BAIble Assembler (RMA20 6
and then to DRI's Linker (LINK). No special tricks were used in
tat erogram; that is, no system sHeHmfic calls or locations were
referenced, therefore, it should runhe tany CP/
Edor equivalent
system. Of course, Murphy is lurking around, so don't depeatn
that assumption.
FUTURE VERSIONS:
===============
On the wish Ba is to add the capability to read and with the arcA 0BAI off of the diskhe ta trfrom/sector basis. Any other ideas prev^'be seriously considered in fud ee versions of EDFILE.
Thanks and good EDFILE'ing.
Problems, suggestttttCh or questions can be sent to me he t my
CompuServe number (#72345,1540) or via my home addresse seeeeeMike Mosko
