PURGE.DOC

John S. Wilson
Synapse Associates, Inc.,
P.O. Box 410,
Solomons, Maryland 20688
(310) 326-4751

                         Command Syntax

PURGE d:filename.typ


                           Background

     � wrot� PURG� a� � utilit� fo� us� wit� Pascal/� an� othe� �
compilers�  I� wil� eras� th� numerou� file� whic� ar� n� longe� �
neede� afte� � successfu� compilation�  PURG� takes� a� a� �
argument� � fil� nam� fro� th� CP/� comman� lin� an� attempt� t� �
delet� certai� pre-designate� file� whic� hav� th� sam� roo� nam� �
a� th� argumen� file�  PURG� check� t� se� tha� th� argumen� fil� �
exist� o� th� name� o� defaul� dis� an� terminate� wit� a� erro� �
messag� bu� n� othe� actio� i� thi� fil� i� no� found�  A� �
implie� b� th� foregoing� � driv� designatio� i� optiona� bu� i� �
accepte� an� honore� i� i� supplied�  PURG� neve� erase� th� CO� �
fil� no� th� PA� fil� containin� th� sourc� code�  However� �
unles� instructe� no� to� i� wil� eras� th� SR� file�  


                          Files Erased

A.  File Extension Types Always Erased

     .HEX
     .BAK
     .TYP
     .REL
     .SYM
     .CRF
     .PRN
     .LST

B.  File Extension Types Erased Conditionally

     .SRC

C.  File Extension Types Always Saved

     .PAS
     .FOR
     .ASM
     .MAC
     .COM
     .COB  
      etc.,
�     
     I� actuality� al� fil� extensio� type� no� name� i� eithe� �
A� o� B� ar� neve� erased.


              Erasing (and not erasing) .SRC files.

     � fil� o� typ� .SR� ma� b� save� b� enterin� .SR� a� th� �
file type i� th� fil� nam� supplie� a� a� argumen� t� th� �
program�  I� th� argumen� fil� nam� doe� no� hav� .SR� a� it� �
typ� an� � .SR� fil� i� foun� wit� th� sam� roo� name� th� .SR� �
fil� wil� b� deleted.

For example

                         PURGE NERD.SRC 

will NOT erase the file NERD.SRC but 
                         
                         PURGE NERD.PAS 

will erase NERD.SRC.


                            Versions

     Th� sourc� cod� an� .CO� fil� supplie� t� th� Pascal/� �
User'� Grou� i� conditione� t� ru� o� � Heath-1� termina� an� t� �
d� � war� boo� o� exi� fro� th� program�  Equatin� (EQU� th� �
constan� SETH1� t� � i� th� sourc� fil� an� reassemblin� wil� �
forc� � conditiona� assembl� withou� th� specia� cod� fo� th� �
Heat� terminal�  User� wit� terminal� othe� tha� th� H/Z19(89,90� �
ma� cod� thei� terminal�' scree� clear� revers� vide� o� an� of� �
sequence� i� th� thre� message� WIPEM� RVONM� an� RVOFF� whic� �
ar� t� b� foun� nea� th� en� o� th� sourc� file�  

     Similarly� settin� th� constan� SETWB� t� � an� reassemblin� �
wil� forc� th� progra� t� exi� withou� doin� � war� boot�  Th� �
war� boo� o� exi� wa� include� t� forc� Intersystem� Cach� Bio� �
t� writ� th� trac� buffe� bac� t� disk�  


                            Assembler

     PURG� wa� assemble� wit� Microsoft'� Macro-8� an� linke� �
wit� Link-8� bu� sinc� i� contain� n� macro� o� othe� specialize� �
code� i� ma� b� assemble� wit� an� assemble� capabl� o� handlin� �
Zilo� Z8� mnemonics�  I� wa� no� writte� i� 808� mnemonic� o� th� �
assumptio� tha� user� o� Pascal/� ar� goin� t� hav� � Z8� CP� �
machine� 


                       Operationa� Example

     Yo� hav� successfull� compile� an� linke� � Pascal/� progra� ��name� FARKLE.PAS�  Thi� mean� that� a� minimu� yo� hav� th� �
followin� file� o� � disk:

     FARKLE.PAS
     FARKLE.SRC
     FARKLE.REL
     FARKLE.COM

most likely also 
     
     FARKLE.BAK

an� possibl� also

     FARKLE.TYP
     FARKLE.SYM

Entering

                         PURGE FARKLE.PAS

will delete all of the above except FARKLE.PAS and FARKLE.COM.

     I� yo� ar� workin� wit� Intersystem� ASMB� t� develo� an�
externa� routine fo� us� wit� Pascal/� an� thu� hav� a file type� �
SR� whic� yo� wis� t� save� typ� i� 

                         PURGE SPARKLE.SRC

after you have loaded the relocatable into your private library.

 
                      Ambiguous File Names

     � ha� no� reall� planne� o� PURG� dealin� wit� ambiguou� �
fil� name� an� s� � didn'� mak� i� smar� enoug� t� handl� thi� �
situation�  PURG� wil� usuall� wor� properl� o� th� fil� type� �
fo� on� o� th� matchin� fil� name� bu� no� ac� o� an� othe� �
matchin� file�  �

     Th� progra� doe� handl� ambiguou� fil� extension� properl� �
so that a user may enter

                         PURGE FARKLE.*
instead of

                         PURGE FARKLE.PAS

and get the same results.


                         Erro� Recovery

     O� course� on� ca� alway� us� th� progra� UNER�, whic� i� �
submitte� t� th� user'� grou� alon� wit� PURGE� t� recove� (un-��delete� an� file� whic� ar� PURGE'e� i� error.

































.