Crawly Crypt Collection 1

home *** CD-ROM | disk | FTP | other *** search

/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / wa202 / whatarc.doc < prev next >

Wrap

Text File | 1991-05-12 | 14KB | 353 lines

066030202030000132006004004006000 1WhatArc v2.02page #0 2WhatArc v2.02page #0 F0110030001 R [.◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆...]0110 9[..◆.◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆....◆.]0110 Ç ======================================================================== ======== ==üWhatArcv2.02Ç== ==anARCmailutilitywrittenbyJonWebb,DeltaVisionSystems== ==withalittlehelpfromTheoRunia== ======== ======================================================================== êTableofcontentsÇ Notesfor1.0xusers........................................2 Notesfor2.00users........................................2 Introduction................................................2 Theconfigurationfile......................................3 Keywords....................................................4 LOG.......................................................4 SCREEN....................................................4 NO_ERROR..................................................4 FAILURE...................................................4 ARC_X,ZIP_X,LZH_X,ARJ_X...................................5 ARC_A,ZIP_A,LZH_A,ARJ_A...................................5 ARC_X_OK,ARC_A_OK,ZIP_X_OK,ZIP_A_OK, LZH_X_OK,LZH_A_OK,ARJ_X_OK,ARJ_A_OK.......................6 DEFAULT...................................................6 SEND......................................................6 NODUPS....................................................7 DELPKT....................................................7 UsewithEXPORT.TTP/IMPORT.TTP..............................8 Anoteonarchivers.........................................8 Copying,discailmer,bugsetc...............................9 9[...◆.◆.◆.◆..◆.◆....◆....◆....◆....◆....◆....◆....◆....◆....◆...]0110 9 [.◆.◆.◆..◆.◆....◆....◆....◆....◆....◆....◆....◆....◆....◆...]0110 üëNotesfor1.0xusers Ç Version2.0xofWhatArchasquiteafewchanges.Yourold configurationfilewillneedchanging.Thisversionof WhatArcshouldworkfineonaTT. üëNotesfor2.00users Ç SeeäWHATSNEW.202Çforalistofchanges. üëIntroduction Ç WhatArcwascreatedtoenabletheuseofARCmail,ZIPmail LZHmailandARJmailsimultaneouslyonaThe-Boxor Binkley/STsystem.TheutilitieswhichusuallycalläARC.TTPÇ tocreateARCmail,shouldcalläWHATARC.TTPÇwiththesame parameters.Here'swhatWhatArcdoes... »äIMPORTINGÇanarchivedmailpacket: 1-Readconfiguration 2-Findarchivedmailpacket 3-Examinearchiveheader 4-Callarchiverprogram 5-Convert&checkerrorlevel »äEXPORTINGÇanarchivedmailpacket: 1-Readconfiguration 2-Findun-archivedmailpacket 3-Examinepacketheader 4-Matchnodenumberwithconfigurationfile 5-Callarchiverprogram 6-Convert&checkerrorlevel Importiseasy,itjustlooksatthefirstfewbytesofthe incomingarchive,andcallsoneoffourde-archiving programs.Exportisalittlemorecomplex.Theconfiguration filecontainssomenodenumbersandtheirpackingmethods. Dependingonthenodenumberinthepacketheader,andthe nodenumbersintheconfigurationfile,eitherARC,ZIP, LHarcorARJiscalled. üëTheconfigurationfile Ç WhatArcgetsitsconfigurationfromafilecalled äWHATARC.CTLÇ,whichmustbelocatedineitherthehome (current)directory,orthedirectorytowhichthe environmentvariablesäMAILERÇoräBINKLEYÇpoint.Anexample configurationfileisincludedinthearchive. DuetoabuginImporttheenvironmentvariablesaren't passedtoWhatArc.InthatcaseWhatArcwillattempttouse theenvironmentwhichwaspassedtoImport. äWHATARC.CTLÇisaplainasciifilewhichcontainsafew linesoftext.Theselinescancontainkeywords.Comments shouldbeprecededbyasemi-column(;).Validkeywordsare listedinthenextsection. üëKeywords Ç TheäWHATARC.CTLÇcontrolfilecancontainthefollowing keywords: üLOGÇ<filespec> Thisshouldbethefirstkeywordinthefile.Itdefines whatlogfileyouwantWhatArctouse.Ifomitted,afile calledäWHATARC.LOGÇinthecurrentdirectorywillbeused. LoggingwillnotworkifyouspecifytheThe-Boxlogfile, becauseImportandExportkeepthelogfileopenwhen runningthearchiver.Example: LOGd:\tb\whatarc.log üSCREENÇ<kb> Whenthiskeywordisfound,thescreenwillbesavedon startupandrestoredonexit.The<kb>parameterdefines howmanyKbarerequiredforthearchivers.Ifthereisnot enoughRAM,thescreenjustisn'tsaved.Example: SCREEN128 üNO_ERRORÇ<level> ThisistheerrorlevelreturnedbyWhatArcwhenallgoes well.Ifthiskeywordisomitteditiszero.Example: NO_ERROR5 üFAILUREÇ<level> IfWhatArcencountersanerroritwillreturnthis errorlevel.Thedefaultisone.Example: FAILURE0 ÇüARC_XÇ<program><mask> üZIP_XÇ<program><mask> üLZH_XÇ<program><mask> üARJ_XÇ<program><mask> ThesekeywordsdefinethelocationoftheARC,ZIP,LZHand ARJextractorprograms.The<program>parametershouldbe thepathandnameoftheextractor.The<mask>parameter definesthecommandlinewhichwillbepassedtothe extractor.Itcancontainthefollowingplaceholders: »%1isreplacedbythepathofthearchivedfile, »%2isreplacedbythenameofthearchivedfile, »%3isreplacedbythepathofthepacket, »%4isreplacedbythenameofthepacket. ThepathsêdoÇênotÇcontainatrailingbackslash.Examples: ARC_Xd:\tb\arc\arc.ttpxo%1\%2%3\%4 ZIP_Xd:\tb\arc\unzip.ttpx%1\%2%3\ üARC_AÇ<program><mask> üZIP_AÇ<program><mask> üLZH_AÇ<program><mask> üARJ_AÇ<program><mask> ThesekeywordsdefinetheARC,ZIP,LZHandARJcreator programs.The<program>and<mask>parameterareas describedabove. êImportantÇ:WhenusingExportyoushoulduseacommandline toêmoveÇthefilesintothearchive,notjustaddthem. Examples: ARC_Ad:\tb\arc\arc.ttpm%1\%2%3\%4 LZH_Ad:\tb\arc\lharc.ttpmu%1\%2%3\%4 ÇüARC_X_OKÇ<level>üARC_A_OKÇ<level> üZIP_X_OKÇ<level>üZIP_A_OKÇ<level> üLZH_X_OKÇ<level>üLZH_A_OKÇ<level> üARJ_X_OKÇ<level>üARJ_A_OKÇ<level> Theerrorlevelsreturnedbythearchivecreatorsand extractorsaredefinedhere.Ifthearchiverreturnsthe errorleveldefinedbytheappropriatekeyword,WhatArc assumesthearchiveoperationwassuccessful,andwill returntheerrorleveldefinedbyäNO_ERRORÇitself.If, however,theerrorlevelreturnedbythearchiverdoesnot matchtheonedefinedhere,WhatArcreturnstheäFAILUREÇ errorlevel. Thesekeywordscanbeusedforarchiverswhichreturna non-zeroerrorlevelevenifallgoeswell. Theseerrorlevelsalldefaulttozero. Examples:ZIP_X_OK5 ARJ_A_OK3 üDEFAULTÇ<type> Withthiskeywordyouchoosewhattypeofarchivedmailis senttonodeswhicharen'tdefinedintheconfiguration file.Typecanbe: »ARCmail »LZHmail »ZIPmail »ARJmail Example: DEFAULTARCmail üSENDÇ<node><type> isusedtodefinewhattypeofarchivedmailshouldgotoa certainnode.Thenodenumbershouldeitherinformat Zone:Net/NodeorjustNet/Node.The<type>parameterisas describedabove.Example:IwanttosendZIPmailto 2:282/350,butLZHmailto2:282/301.Alltheothernodes shouldgetARCmail.Theconfigurationfilewouldcontain: DEFAULTARCmail SEND2:282/301LZHmail SEND2:282/350ZIPmail SEND2:281/800ARJmail Pointsshouldusetherealaddressoftheirboss.Ifyou areabossyourself,usethefakeaddressofyourpoints. ÇPleasenotethatyoushouldêneverÇsendarchivedmailtoa systemwithoutêfirstÇaskingthesysopofthatsystem whetherheiscapableofacceptingarchivedmailand-if so-whatsortofarchivershouldbeused. üNODUPSÇ<yesorno> Considerthis:youreceiveanARCmailfile.During extractionofthearchivethearchivercomesacrossan errorandexits.Thepacketswhichwereextractedbefore theerroroccuredarestillondisk. Thenexttimethemailprocessorisrunitfindsanarchive plussomepackets.Thepacketsareimported,andthemail processorattemptstoextractthearchiveagain... WhentheäNODUPSÇfeatureisswitchedon,WhatArcwillfirst deleteanyfileswhichwerenotpresentbeforethearchiver wascalled.Thenitwillchangetheextensionofthe archivetoä.BD0Ç,ä.BD1Ç,ä.BD2Çetc. Examples: NODUPSyes NODUPSno Thedefaultis'yes'. üDELPKTÇ<yesorno> Ifyourarchiverdoesn'tsupporta'move'operation, WhatArcwilldeletethepacketsaftertheyhavebeen archivedsuccessfully. Examples: DELPKTyes DELPKTno üëUsewithEXPORT.TTP/IMPORT.TTPü Ç TheeasiestwaytogetExportandImporttouseWhatArc insteadofARCistoputARCinadifferentdirectoryand renameäWHATARC.TTPÇtoäARC.TTPÇ.However,ExportandImport canbetoldtouseadifferentarchiverinthecommand line... Exportnormal:EXPORT-a\TB\WHATARC.TTPm Exportcrash:EXPORT-fa<node>-a\TB\WHATARC.TTPm Exportpoints:EXPORT-ma<boss>-a\TB\WHATARC.TTPm Import:IMPORT-a\TB\WHATARC.TTPx Havealookattheimport/exportdocsformoreinformation. Youcouldwriteasimplebatchfiletohandlethe parameters.YouMUSTputthe-aoptionLASTonthecommand line,becausealloptionsafterthe-aareconsideredpart ofthatcommandlineforthearchiver.Don'tforgetthe parameterscanonlybe'A'forAdd,'M'forMoveor'X'for Extract. ëAnoteonarchiversÇ Therearemanydifferentversionsofarchiversgoingaround. Youshouldpickonewhichdoesn'trequireuserinput, checksCRC'sandreturnscorrecterrorlevels.Imyselfuse TCARCv1.10andLHarc-STv0.60.YoumaywanttotryARC6.02 orLHarcv1.13. IhavenotyetseenaZIPcreatorfortheST.Ionlybuilt theZIPcreationoptioninjustincaseonebecomes available.ManyUnZippersdon'tcheckCRC,orrequireinput fromtheuser.TestyourUnZipperonalargearchive,andon archiveswitherrors,beforeyouinstallitforunattended use. ThesamegoesforARJ.IportedanARJextractorjustbefore creatingthisversionofWhatArc.Whetheritworkswell remainstobeseen.Itcanberequestedfrom2:282/301.0as äUNARJ_ST.LZHÇ,ifyouareinterested.Atthetimeofwriting thereisnoARJcreator. ÇëCopying,disclaimer,bugsetc.Ç WhatArcmaybefreelycopiedandmadeavailablefor download,aslongasyousticktothefollowingrules: »Thecompletearchive,includingDOCSarecopied, »Neithertheprogramnorthedocsarechangedinany way.Thedocumentationmaybetranslated, »Nofeeotherthannominalcopyingchargesoron-line timeischarged. Icannotbeheldresponsibleforanydamagesthatmight occurduetotheuseofWhatArc.Ifyouturnyour360Mb harddiskintoaC15cassettetape,it'syourownstupid fault. Forbugreports,suggestions,questionsandcomments,Ican bereachedat... »QuickBBSSTLeeuwarden, FidoNet2:282/301.0, PhoneHolland(0)58-153849, 300-9600bps,HST/V32/MNP5/V42,24hoursperday, »FidoNetnetmailon2:282/301.2, »IntheFIDO_ST,THE-BOX,BINKLEY.ST,QUICKBBS.STand ST_FIDO.GERechoareas, »DeltaVisionSystems, Valeriaanstraat197, 3765ENSoest, TheNetherlands. ElectronicGreetings!-Jon-