home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Oakland CPM Archive
/
oakcpm.iso
/
cpm
/
dirutl
/
eraz11.lbr
/
ERAZ11.HZP
/
ERAZ11.HLP
Wrap
Text File
|
1988-05-09
|
12KB
|
236 lines
;
--- E R A Z ---
Version 1.1
An Enhanced ZCPR3-Compatible File Erasing Utility
I --> Installation
O --> Overview
S --> Syntax
/ --> Options
M --> Modifications
:I
Installation
Thσ distributioε versioε oµ ERA┌ i≤ supplieΣ witΦ aε AMPR╧ standarΣ Z3EN╓ ì
addres≤ oµ FE00H« ZCPR3.░ user≤ witΦ othe≥ Z3EN╓ location≤ shoulΣ instal∞ ì
ERA┌ usinτ Z3INS.CO═ anΣ SYS.EN╓ iε thσ norma∞ manner«
N∩ installatioε i≤ requireΣ fo≥ operatioε iε ZCPR3.│ o≥ non-ZCPR│ ì
environments« Fo≥ operatioε iε ß non-ZCPR│ environment¼ thσ maximuφ drivσ ì
anΣ use≥ tha⌠ wil∞ bσ accepteΣ ma∙ bσ patcheΣ a≤ describeΣ below.
:O
Overview ì
ERA┌ i≤ aε enhanceΣ Z8░ filσ erasinτ utilit∙ fo≥ usσ witΦ ZCPR│ anΣ CP/═ ì
2.▓ o≥ ZRDOS« ERA┌ ha≤ no⌠ beeε testeΣ witΦ CP/═ 3.0.
ERA┌ wa≤ designeΣ a≤ ß genera∞ purposσ filσ erasinτ utilit∙ a≤ wel∞ a≤ ß ì
companioε t∩ thσ ACOP┘ serie≤ oµ filσ utilities« I⌠ caε hel≡ reducσ thσ ì
ALIA╙ commanΣ linσ lengtΦ requireΣ t∩ erasσ group≤ oµ file≤ witΦ unrelateΣ ì
name≤ b∙ optionall∙ erasinτ onl∙ thosσ file≤ tha⌠ havσ beeε taggeΣ witΦ an∙ ì
combinatioε oµ thσ filσ attribute≤ F▒ througΦ F╖ (erasσ iµ AN┘ oµ thσ ì
selecteΣ attribute≤ arσ set)«
Fo≥ example¼ ERA┌ caε bσ useΣ witΦ thσ /▓ optioε t∩ clea≥ ß RA═ disδ oµ thσ ì
file≤ tha⌠ werσ loadeΣ fo≥ ß specifiπ applicatioε usinτ ACOP┘ anΣ thσ samσ ì
/▓ optioε (copyinτ onl∙ file≤ havinτ thσ attributσ F▓ set)¼ leavinτ thσ RA═ ì
disδ witΦ al∞ othe≥ file≤ intac⌠ anΣ read∙ fo≥ anothe≥ applicatioε t∩ bσ ì
loaded.
File≤ ma∙ bσ taggeΣ usinτ thσ ZRDO╙ utilit∙ SF┴ (Se⌠ Filσ Attributes⌐ o≥ ß ì
simila≥ CP/═ Publiπ Domaiε utilit∙ sucΦ a≤ DA« ERA┌ als∩ ha≤ ß numbe≥ oµ ì
othe≥ option≤ whicΦ arσ describeΣ in the Option≤ section.
ERA┌ i≤ full∙ ZCPR│ compatiblσ wheε operatinτ iε ß ZCPR│ environment¼ ì
acceptinτ botΦ thσ DIR║ anΣ thσ DU║ form≤ anΣ checkinτ thσ environmen⌠ t∩ ì
obtaiε thσ maximuφ drivσ anΣ use≥ tha⌠ wil∞ bσ accepted¼ whethe≥ i⌠ i≤ t∩ ì
bσ operatinτ iε ß quie⌠ environment¼ anΣ thσ namσ unde≥ whicΦ thσ prograφ ì
wa≤ calleΣ fo≥ usσ iε thσ HEL╨ message« Error≤ wil∞ causσ thσ ZCPR│ ì
prograφ erro≥ flaτ t∩ bσ set« Wheε operatinτ iε ß ZRDO╙ environment¼ file≤ ì
iε thσ PUBLI├ area≤ arσ protected.
Wheε ERA┌ operate≤ iε ß non-ZCPR│ environment¼ thσ requireΣ informatioε i≤ ì
obtaineΣ froφ interna∞ locations¼ whicΦ ma∙ bσ patcheΣ a≤ describeΣ below« ì
ERA┌ wil∞ no⌠ accep⌠ thσ DIR║ forφ wheε operatinτ iε ß non-ZCPR│ ì
environment.
:S
Syntax ì
ERAZá[dir:]afn1á[[dir:]afn2 ...] [/option(s)▌ì
T∩ hel≡ yo⌡ clea≥ you≥ workspacσ witΦ ß singlσ command¼ ERA┌ allow≤ yo⌡ t∩ ì
specif∙ u≡ t∩ 1╢ separatσ ambiguou≤ filename≤ oε thσ commanΣ line« Notσ ì
tha⌠ eacΦ filenamσ specifieΣ require≤ it≤ owε DIR║ o≥ DU║ reference« ì
However¼ an∙ option≤ als∩ specifieΣ wil∞ bσ applieΣ t∩ AL╠ filenames!
Wheneve≥ yo⌡ includσ thσ wildcarΣ filenamσ masδ '*.*º (unles≤ yo⌡ als∩ ì
specif∙ thσ Inspec⌠ (/I⌐ option)¼ ERA┌ wil∞ asδ yo⌡ iµ yo⌡ wan⌠ t∩ "Erasσ ì
AL╠ Files?ó anΣ wil∞ awai⌠ ß responsσ froφ yo⌡ beforσ al∞ remaininτ file≤ ì
arσ erased« Thi≤ i≤ t∩ hel≡ preven⌠ accidentall∙ erasinτ al∞ you≥ file≤ ì
duσ t∩ thσ sli≡ oµ ß finger« An∙ responsσ excep⌠ 'Yº o≥ 'yº wil∞ causσ ì
ERA┌ t∩ abor⌠ a⌠ tha⌠ point«
Iµ yo⌡ d∩ accidentall∙ erasσ an∙ files¼ IMMEDIATEL┘ usσ aε filσ unerasσ ì
utilit∙ sucΦ a≤ UNERAZ¼ UNERA¼ o≥ UNERAS┼ beforσ performinτ an∙ operation≤ ì
tha⌠ wil∞ writσ an∙ file≤ t∩ you≥ diskí Disδ writσ operation≤ ma∙ reusσ ì
an∙ director∙ entrie≤ markeΣ a≤ erased¼ anΣ thereb∙ makσ i⌠ impossiblσ t∩ ì
recove≥ you≥ eraseΣ files.
:/
Options ì
ERA┌ ha≤ ß numbe≥ oµ commanΣ linσ options¼ whicΦ mus⌠ bσ precedeΣ b∙ thσ ì
optioε flaτ characte≥ '/'« Thσ optioε letter≤ o≥ number≤ ma∙ appea≥ iε an∙ ì
orde≥ anΣ ma∙ appea≥ anywherσ iε thσ commanΣ line« Option≤ ma∙ bσ combineΣ ì
iε an∙ combination« Option≤ arσ toggleΣ a≤ the∙ arσ read¼ s∩ tha⌠ aε ì
optioε appearinτ twicσ wil∞ cance∞ itself« Al∞ oµ thσ followinτ commanΣ ì
line≤ havσ thσ samσ meaning:
áááááááá A0>erazá/12qáafn1 afn2ì
áááááááá A0>erazáafn1á/▒á/±á/2 afn2ì
áááááááá A0>erazá/12áafn2á/± afn1ì
áááááááá A0>erazá/qá/q afn1á/±á/2▒ afn2
Thσáoptions are║
Iá-áInspec⌠ option« Display≤ eacΦ proposeΣ erasσ anΣ ask≤ ì
ááááááááááfo≥ operato≥ approva∞ beforσ proceeding« Thσ defaul⌠ ì
áááááááááái≤ t∩ automaticall∙ erasσ R/W file≤ withou⌠ asking.
A - Erase≤ al∞ (botΦ director∙ anΣ system⌐ specifieΣ files« ì
ááááááááááThσ defaul⌠ i≤ t∩ erasσ director∙ file≤ only.
R - R/╧ option« Erase≤ R/╧ file≤ withou⌠ asking« Normally¼ ì
ááááááááááyo⌡ arσ askeΣ first.
ááááá1á- 7 options« Erase≤ onl∙ thosσ specifieΣ file≤ whicΦ als∩ ì
ááááááááááhavσ thσ selecteΣ combinatioε oµ thσ F▒ througΦ thσ F╖ ì
ááááááááááattribute≤ set« ì
ááááQá-áQuie⌠ option« Turn≤ ofµ non-erro≥ messages« An∙ ì
ááááááááááinformatioε yo⌡ shoulΣ kno≈ abou⌠ durinτ thσ erasinτ ì
ááááááááááprocess¼ sucΦ a≤ erro≥ information¼ i≤ stil∞ displayed« ì
ááááááááááWil∞ no⌠ erasσ an∙ systeφ o≥ R/╧ file≤ unles≤ thσ A o≥ ì
ááááááááááR optioεs are als∩ used«
Wheε operatinτ iε ß ZCPR│ environment¼ thσ ╤ optioε ì
ááááááááááinitia∞ settinτ wil∞ automaticall∙ bσ se⌠ accordinτ t∩ ì
ááááááááááthσ statσ oµ thσ ZCPR│ QUIE╘ flag« Iµ thσ ╤ optioε ha≤ ì
ááááááááááaε initia∞ settinτ oµ ON¼ thσ usσ oµ ╤ iε thσ commanΣ ì
áááááááááálinσ wil∞ theε togglσ thσ ╤ optioε OFF« Thσ hel≡ ì
ááááááááááscreeε wil∞ automaticall∙ displa∙ thσ prope≥ meaninτ oµ ì
ááááááááááthσ ╤ option.
:M
Modifications ì
ERA┌ ha≤ severa∞ location≤ nea≥ thσ beginninτ oµ thσ prograφ tha⌠ caε bσ ì
patcheΣ usinτ DDT¼ PATCH¼ ZPATCH¼ etc¼ t∩ alte≥ thσ operatioε oµ thσ ì
prograφ t∩ sui⌠ thσ user« Thσ followinτ tablσ list≤ thei≥ location≤ anΣ ì
thσ distributioε defaults.
Iµ yo⌡ arσ operatinτ iε ß ZCPR│ environmen⌠ anΣ wisΦ t∩ renamσ thσ program¼ ì
thσ namσ b∙ whicΦ thσ prograφ is invokeΣ wil∞ automaticall∙ appea≥ iε thσ ì
HEL╨ message¼ anΣ n∩ patchinτ neeΣ bσ done«
Iµ yo⌡ arσ primaril∙ operatinτ iε ß non-ZCPR│ environment¼ thσ prograφ ì
name¼ 'ERAZ'¼ a⌠ locatioε 010BH-0112H¼ ma∙ bσ patcheΣ t∩ an∙ desireΣ ne≈ ì
name¼ whicΦ wil∞ theε appea≥ a⌠ thσ prope≥ place≤ iε thσ HEL╨ messagσ wheε ì
i⌠ i≤ called« ┴ maximuφ oµ eigh⌠ character≤ arσ available« Fil∞ thσ ì
unuseΣ characte≥ position≤ witΦ spacσ characters¼ a≤ space≤ iε an∙ oµ thσ ì
eigh⌠ location≤ wil∞ bσ ignored« Fo≥ example¼ t∩ changσ thσ namσ oµ thσ ì
prograφ froφ ERA┌ t∩ ERA¼ yo⌡ ma∙ simpl∙ patcΦ thσ 'Zº iε 'ERAZº t∩ ß spacσ ì
characte≥ (20H⌐ anΣ thσ HEL╨ messagσ wil∞ theε displa∙ 'ERAº witΦ n∩ extrß ì
spaces«
Thσ optioε flaτ anΣ thσ defaul⌠ optioε character≤ ma∙ bσ changeΣ iµ yo⌡ ì
prefe≥ othe≥ mnemonics« Thσ changeΣ character≤ wil∞ automaticall∙ appea≥ ì
iε thσ hel≡ message.
Thσ option≤ arσ al∞ OFF-O╬ toggles« Thσ defaul⌠ setting≤ fo≥ thσ option≤ ì
ma∙ bσ changeΣ froφ OF╞ (00H⌐ t∩ O╬ (0FFH⌐ t∩ allow¼ fo≥ example¼ alway≤ ì
inspectinτ file≤ beforσ erasinτ withou⌠ havinτ t∩ usσ thσ /╔ option« Notσ ì
tha⌠ iµ yo⌡ theε usσ thσ /╔ option¼ i⌠ wil∞ turε OF╞ thσ automatiπ ì
inspection« Iµ yo⌡ changσ thσ optioε defaul⌠ setting≤ b∙ patching¼ thσ ì
hel≡ messagσ wil∞ automaticall∙ tr∙ t∩ reflec⌠ thesσ changes«
Sincσ changinτ somσ oµ thσ defaul⌠ optioε setting≤ ma∙ changσ thσ operatioε ì
oµ ERA┌ b∙ removinτ somσ oµ thσ built-iε safet∙ factor≤ tha⌠ hel≡ preven⌠ ì
overwritinτ importan⌠ existinτ file≤ b∙ accident¼ cautioε shoulΣ bσ ì
exerciseΣ iε changinτ an∙ oµ thσ defaul⌠ optioε settings!
Iµ i⌠ i≤ desireΣ t∩ eliminatσ AL╠ optioε choice≤ followinτ ß giveε option¼ ì
patcΦ thσ FIRS╘ undesireΣ optioε lette≥ o≥ numbe≥ t∩ ß 00╚ (fo≥ example¼ t∩ ì
eliminatσ thσ F1-F╖ options¼ changσ thσ F▒ bytσ a⌠ 0121╚ froφ '1º t∩ 00H)« ì
Al∞ subsequen⌠ optioε choice≤ wil∞ n∩ longe≥ operate.
Wheε ERA┌ step≤ througΦ ß numbe≥ oµ files¼ i⌠ ma∙ generatσ morσ thaε ß ì
screenfu∞ oµ display« T∩ hel≡ summarizσ wha⌠ ha≤ happened¼ ERA┌ display≤ ì
thσ tota∞ numbe≥ oµ file≤ eraseΣ oε completioε oµ thσ program« Iµ yo⌡ ì
prefe≥ no⌠ t∩ havσ thi≤ display¼ patcΦ locatioε 0119╚ froφ FF╚ (displa∙ ì
tota∞ numbe≥ oµ file≤ erased⌐ t∩ 00╚ (n∩ display).
Location áá Default Purposeááááááá
================================================================ ì
á 010BHááááá'ERAZ ' Prograφánamσá(╕ácharacter≤ámaximum⌐ááá ì
-0112Háá ¡áAppear≤áiεáHEL╨ámessagσ
áá0114Háááá '»' Optioεáflaτácharacte≥áááááá
0115H 10H Maximum drive allowed (A=1H, P=10H)
0116H 0FH Maximum user area allowed (15D=0FH)
0119H ON (FFH) Display the number of files copied
011AH 10H (16D) Maximum number of filenames accepted
(This value may be decreased only)
áá011BHáááá 'I' Inspect option characte≥áááááá ì
áá011CHáááá OFF (00H) Inspectádefaul⌠ásettinτáááááá
áá011DHááááá'A' Include all files characterì
áá011EHáááááOFF (00H) Include all filesádefaul⌠ásettinτ
011FHáááá '╥' EraseáR/OáªáR/Wáfile≤áoptioεácha≥acter áì
áá0120Háááá OFF (00H) EraseáR/OáªáR/Wáfile≤ádeµaultásettinτ
0121Háááá '▒' F▒áattributσáoptioεácharacte≥ááááá ì
áá0122Háááá OFF (00H) F▒áattributσádefaul⌠ásettinτááááá
0123Háááá '▓' F▓áattributσáoptioεácharacte≥ááááá ì
áá0124Háááá OFF (00H) F▓áattributσádefaul⌠ásettinτááááá
0125Háááá '│' F│áattributσáoptioεácharacte≥ááááá ì
ááO126Háááá OFF (00H) F│áattributσádefaul⌠ásettinτááááá
0127Háááá '┤' F┤áattributσáoptioεácharacte≥ááááá ì
áá0128Háááá OFF (00H) F┤áattributσádefaul⌠ásettinτááááá
0129Háááá '╡' F╡áattributσáoptioεácharacte≥ááááá ì
áá012AHáááá OFF (00H) F╡áattributσádefaul⌠ásettinτááááá
012BHáááá '╢' F╢áattributσáoptioεácharacte≥ááááá ì
áá012CHáááá OFF (00H) F╢áattributσádefaul⌠ásettinτááááá
012DHáááá '╖' F╖áattributσáoptioεácharacte≥ááááá ì
áá012EHáááá OFF (00H) F╖áattributσádefaul⌠ásettinτááááá
áá012FHáááá '╤' Quie⌠áoptioεácharacte≥áááááá
á 0130Háááá OFF (00H) Quie⌠áoptioεádefaul⌠ásettinτááááá