z"}cZ0Portable UPDNODES Installation and User's Guide) x_UPDNODES % Contents Tables  * Index}"''+TABLESTABLESW\) =@1@Tested Environments1 Tested EnvironmentsLl=@1-1 ComponentFiles1- 1 Component FilesS\##=@2-1FileNameDefaults2- 1 File Name Defaults<  / CONTENTSCONTENTS8 E[TitlePageTitle Page@E\ CopyrightPageCopyright Page1xE\PrefacePreface bw++$L1 InstallingPortableUPDNODES1 Installing Portable UPDNODESDw$K1.1 Requirements1.1 RequirementsOg""$K1.2FilesintheKit1.2 Files in the Kitw%:)$K1.3 Installation Procedure-&VAX/VMS1.3 Installation Procedure - VAX/VMSy&;-$K1.4Pre-Installation Procedure-&Unix1.4 Pre-Installation Procedure - UnixMl  $A1.4.1Definingoldcc1.4.1 Defining oldccYl&&$A1.4.2Defining SHORT_NAMES1.4.2 Defining SHORT_NAMESal**$@1.4.3DefiningWEIRD_BIT_ORDER1.4.3 Defining WEIRD_BIT_ORDERhl!//$A1.4.4SettingtheTypeofint16u1.4.4 Setting the Type of int16u ml$11$A1.4.5 SelectingtheProperMakefile1.4.5 Selecting the Proper Makefile!ig"//$L1.5 Installation Procedure-Unix1.5 Installation Procedure - Unix"w%:,$K1.6Post-InstallationTesting-&Unix1.6 Post-Installation Testing - Unix$U\$$$A1.6.1 PerformanceIssues1.6.1 Performance Issues%u$9)$L1.7 Installation Procedure-&MS-DOS1.7 Installation Procedure - MS-DOS&u$9)$K1.8 Installation Procedure-&RSTS/E1.8 Installation Procedure - RSTS/E(Xw&&$K2UsingPortableUPDNODES2 Using Portable UPDNODES+.E'$K2.1 ObtainingYourInitial&BITEARNNODESFile2.1 Obtaining Your Initial BITEARN NODES File,fl ..$A2.1.1FromaNearbyBITNETsite2.1.1 From a Nearby BITNET site-e\ --$A2.1.2FromYourNearestNETSERV2.1.2 From Your Nearest NETSERV.`w**$L2.2 ObtainingMonthlyUpdates2.2 Obtaining Monthly Updates0Wg%%$K2.3LISTSERV-PunchFormat2.3 LISTSERV-Punch Format4bw++$K2.4InvokingPortableUPDNODES2.4 Invoking Portable UPDNODES6>l$@2.4.1Options2.4.1 Options7Gl$@2.4.1.1-vOption2.4.1.1 -v Option8Il$A2.4.1.2-l#Option2.4.1.2 -l# Option9Gl$A2.4.1.3-?'Option2.4.1.3 -? Option:O\!!$@2.4.2File Parameters2.4.2 File Parameters;Iw$K2.5ErrorMessages2.5 Error Messages>-C'$L2.6 ReportingProblemsand& ObtainingUpdates2.6 Reporting Problems and Obtaining Updatesw+TABLESTABLESW\) =@1@Tested Environments1 Tested EnvironmentsLl=@1-1 ComponentFiles1- 1 Component FilesS\##=@2-1FileNameDefaults2- 1 File Name Defaults<``zP0_* Copyright1991TerenceM.Kennedy ~AllRights Reserved.pSFOPortableUPDNODES*O: InstallationandUser'sGuide@OMarch,1991m CTO{Thisdocumentprovides installationandusage instructionsforthePOportableUPDNODESprogram.+UPDNODESisautilitywhichappliesXOmonthlyupdatestothemasternodesdatabaseusedonBITNETandthe Oc cooperating networks.'O"Doityourselfandsave"xN'ORevision/Update Information:'^Thisisarevisedmanual.*O OperatingSystemandVersion:#^VAX/VMSV4.4orlater,"^MS-DOSV3.2orlater,^`Unix (various),#^RSTS/EV10.0orlater.a7OSoftwareVersion:^UPDNODESV1.3-04  )OTable1:7Tested Environments O OKHost Processor ;/13K OperatingSystemKCCompiler Of OVAX86503VMSV5.4-1VAXCV3.2O(IBMPC3(MS-DOSV3.31( MicrosoftCV6.0AOSun43SunOS4.1UnixC  2O PDP-11/7032.11BSDUnixUnixC  2O PDP-11/703RSTS/EV10.0PDP-11CV1.1 O  O 1Nm: Shouldalsoworkonothermodelsinthesameproductline. O 2Gm Usingthecompilersuppliedwiththe operatingsystem. O   X O OO March,1991jO Permissionisgrantedtocopyand redistributethisdocumentprovidedthecopiesare/Omadeforno commercial advantage.eOThe informationinthisdocumentissubjecttochangewithoutnoticeandshouldfOnotbe construedasa commitmentbySaintPeter'sCollege.)SaintPeter'sCollege_Oassumesnoresponsibilityforanyerrorsthatmayappearinthis document.O DISCLAIMER:HThesoftware describedinthisdocumentisprovided```asis''.*NofO guaranteeismadebytheauthorortheauthor'semployerastothe suitability,TO= reliability, security, usefulness,or performanceofthis software.WORSTS/E,VAX,andVMSare trademarksofDigital Equipment Corporation:Os PostScriptisa trademarkofAdobeSystems>OMS-DOSisa trademarkof Microsoft Corporation*OUnixisa trademarkofAT&T OA0O Copyright1991TerenceM.Kennedy* ZZ   yOPrefaceLOThismanual describeshowtoinstallandusetheportableOUPDNODESprogram. aDOTheBITEARNNODESfileisthemaster repositoryofKO informationaboutallnodesonBITNETandthe cooperatingMO5 networks.)Assuch,various applicationprogramsrefertoitROfor information.+Thisfileisquitelarge(asofthiswriting,VOitisover3.5 megabytes).*Thus,itistoolargetoshiptoallPO>nodeseverymonth.)Instead,aspecialupdatefileisshipped,JOgivingonlythechangesmadeinthepreviousmonth.+TheJOUPDNODESutilityappliesthisupdateand generatesanewOHBITEARNNODESfile.?  BOUntilnow, there wereonly twoimplementations of?OUPDNODES-theoriginalimplementationbyPeterHO5 SylvesterandBertholdPasch,inIBMVSPascal,andaPOpartialversioninportablePascalbyEd Skochinski.'WiththeLOadventofnon-IBMnodesonBITNETandthe availabilityofMO>toolswhichusethenodesfile(suchasPAROUTE)fornon-KOIBMsystems,theneedforaportableversionofUPDNODESObecameclear. ! WDOThismanual describesaversionofUPDNODESwrittenNOinportableANSIC.Cwaschosenbecauseofthe widespreadNO5 availabilityofgoodC compilers.'Infact,portableUPDNODESOOperformsquitewellonsystemssuchastheIBMPC,soevenSOifyourBITNEThostcannotrunit,youmaybeabletouseitO>onanothersystem.NFOPortableUPDNODEShasbeentestedinvariousenviron-7Oments,asshowninthe followingtable:O5Table1*O'?  OIntendedAudienceKO(Thismanualisintendedforsystemmanagersand operatorsIOwithsystem privileges.-YoushouldbefamiliarwiththeKO operatingsystemonyourmachineaswellasthesoftwareMO1linkingyoursystemtoBITNET.Youshouldalsobefamiliar?OwithvariousaspectsofBITNETnode management.BB  }nSODocument Structure6OUThisdocumentconsistsoftwo chapters.vFOChapter1 Describeshowtoinstallportable UPDNODES.;O]Chapter2 Describesusingportable UPDNODES.vv  ORelated DocumentsEOUYoucanfind additional informationinthe following@O documents, availablefromLISTSERV@BITNICoryourOlocalNETSERV:x rN ` =UPDATEPROCEDUR- Procedureforupdatingyour4host information(BITNETmembersonly) `y >yNETSERVHELPFILE- Procedureforupdatingyour.host information(other networks) `Q ?QUPDNODESDESCRIPT- DescriptionoftheoriginalUPDNODESprogram `) C)NODESFMTDESCRIPT- Descriptionofthecontentsof+BITEARNNODES(currentformat) ` BNEWTAGSDESCRIPT- Descriptionofthecontentsof0YBITEARNNODES (forthcomingversion)  s,O 1.2 Installing!Portable"UPDNODESMOThischapter describesthe procedurefor installingportableHO UPDNODES.Sincevarious operatingsystemshave differentGOBmethodsfor compilingand installing programs,youmayJOhavetorefertoyour operatingsystem documentationfor!Odetailed instructions.>ww] s 3'OTable1-1:7 ComponentFiles O OFFilename3F Description Ob O CHECKSUM.ASM53AssemblychecksumroutineforIBMPC'sO$CHKSUM.C%3$Checksum computationcodeO COMPILE.PC43ScriptfiletocompileonanIBMPCO COMPILE.RSTS/3ScriptfiletocompileonRSTS/EO COMPILE.VMS03ScriptfiletocompileonVAX/VMSO IO.C3 I/OroutinesOLOG.C3LoggingroutinesO MAKEFILE.2BSD&3Makefilefor2.11BSDUnixOx MAKEFILE.PC 3xMakefileforIBMPCO MAKEFILE.SUN#3MakefileforSunOS4.1Ol MAKEFILE.VMS 3lMakefileforVAX/VMSOMERGE.C+3MergesupdatesintonodefileO_PARSE.C3_TagparsingcodeO UPDNODES.C3MainprogramOS UPDNODES.H3SCommon definitionsO UPDNODES.PS,3Thisfile- PostScriptversionOF  UPDNODES.TXT'3F Thisfile-ASCIIversion Om GG-! O1.1B Requirements `{ K{ThesourcefilesforportableUPDNODES(seesection1.2). ` AC compiler. `z Fz SufficientfreediskspacetostoreUPDNODESandthenodes database(s).__ w"O1.2BFilesintheKitPOUTheportableUPDNODESkitconsistsofthe followingfiles.'IfGOyoureceivedtheUPDNODESPACKAGEyoushouldhaveall$Oofthesefilesalready.O^Table1-1*O!q?xGG"62O1.3B Installation Procedure-VAX/VMSRO(Placealloftheabovefilesina directoryby themselvesand#OissuetheDCLcommand:O $& @COMPILE.VMS   M RETURN M    FOYoushouldnotreceiveanyerrorsorwarningsduringBO compilation.2Youmay now copy the executable fileFOi UPDNODES.EXEtoa convenientlocationonyoursystem.LOYoushouldprobablycopythe documentationtowhereveryouSOstoresuchfiles.'IfspaceisatapremiumyoumaydeletetheNOrsourcefilesaswellasthe temporaryfilesproducedduring$Othe compilationprocess. IOYoushouldnowdefineasymboltoinvoke UPDNODES.YouPOmayeitherplacethe definitioninoneofyourinitializationOO5files,suchas LOGIN.COM,oryoumaytypeitineverytimeGOyouwishtorun UPDNODES.DefinethesymbolasshownObelow:Ok $&UPDNODES&:==%$k disk :k :[k directoryk ]UPDNODES.EXE 1  3Mh RETURN 3M    3O1.4BPre-Installation Procedure-UnixSOUPlacealloftheabovefilesina directoryby themselves.)YouOOwillmostlikelyhavetoeditthe UPDNODES.HfiletodefineMOyourUnixvariant.,Searchforthefirstinstanceof"unix"TO^inthefile.*Youwillneedtosetthe followingitemsforyourO particularsystem:!  O1.4.1BDefiningoldcc O4If4oldccK4isdefined,"classicC"stylefunction prototypeswillbe?Oused.' Additionally, SHORT_NAMESwillbedefined. V[&O1.4.2BDefining SHORT_NAMES O4If4 SHORT_NAMES9M4isdefined,variablenameswillbeuniqueHOwithinthefirst6 characters,inorderto accommodateEOsystemswherethelinkercannot differentiatebetweenNO=symbolswhicharenotuniquewithinthefirst6 characters.J! ` *O1.4.3BDefiningWEIRD_BIT_ORDERLO4TheANSIstandardstatesthattheorderofbitswithinaIO structureelementisimplementation-specific.'ThechecksumROroutinesusebitfieldsandneedtoknowhowbitsarepacked.MO=ThemostcommoncasehasthehighbitfirstandthentheKOlowbits.*AllsystemsthatI'vetriedUPDNODESonexceptSOtheSunsuse"normal"bitorder.'Ifyoursystemdoesn't,defineOGWEIRD_BIT_ORDER G. ! V/O1.4.4BSettingtheTypeofint16uEO4Sincevarioussystemshave differentwordlengths,a4typedef 4isSOusedtodefinetheproperformatofa16bitunsignedinteger.2OFormostsystemsitwillbeeither unsignedint(for16bitO= processors)orX=unsignedshort%=(for32bit processors).!1O1.4.5B SelectingtheProperMakefilewellasthe temporaryfilesproducedduringthe compilationOprocess.rr$! 22O1.6BPost-InstallationTesting-UnixKOUYoushouldnowperformatestupdateruntoverifythatFOportableUPDNODESisworkingproperlyonyoursystem.MOAlmostallincompatibilityproblemsmanifestinthechecksumRO^ routines,foundinthefile CHKSUM.C.ThebestthingtodoifOOyoudiscoverchecksumproblemsistoplace debuggingprintf'sLOinthecodeandusethesampledatagivenintheCHKSUMEOhASSEMBLEfile (availablefromLISTSERV@BITNIC)toseeMOwherethingsaregoingwrong.'Usuallytheproblemsaredue2Otobyteorderingorsimilarissues.m%C$O1.6.1B PerformanceIssuesKO4Atleast35%oftheCPUtimeisspentinthewrotl( )EO function..Anythingyoucandotoimprove performanceMOthereiswellworthit..TheeasiestwayoutistorecodeIO=thefunctioninassemblylanguage(aswasdonefortheFOMS-DOSimplementation).+Therearetwoversionsofthe+Owrotl( ) function,ifdef'don-SIMPLE"r.ThedefaultistheJOGcomplexversion,whichrunsfasteronCISCmachinessuchMOastheVAX.FormostRISCarchitectures,the differenceinKO executiontimewithSIMPLEisnotenoughtomakeittheNOQdefault.*Itisprovidedmainlyasanexampleofwhatyou'd&Oneedtodoin assembler.ppM&#1O1.7B Installation Procedure-MS-DOSNOUPlacealloftheabovefilesina directoryby themselves.DORenamethefile COMPILE.PCto COMPILE.BATandissueOthecommand:O COMPILE Q  SM RETURN SM   ' FOYoushouldnotreceiveanyerrorsorwarningsduringBO compilation.2Youmay now copy the executable fileFO5 UPDNODES.EXEtoa convenientlocationonyoursystem.LOYoushouldprobablycopythe documentationtowhereveryouSOstoresuchfiles.'IfspaceisatapremiumyoumaydeletetheNO>sourcefilesaswellasthe temporaryfilesproducedduring$Othe compilationprocess.( m1O1.8B Installation Procedure-RSTS/ETOUPlacealloftheabovefilesina directoryby themselves.'NoteIOthatRSTS/Ewilltruncate filenamesto6 charactersandKO filetypesto3 characters.(AlloftheUPDNODES componentsPO^willstillhaveuniquenamesaftersuch truncation.(IssuetheODCLcommand:O< $& @COMPIL.RST j  jM: RETURN uM jR  ) FOYoushouldnotreceiveanyerrorsorwarningsduringBO compilation.2Youmay now copy the executable fileFO5 UPDNODES.TSKtoa convenientlocationonyoursystem.LOYoushouldprobablycopythe documentationtowhereveryouSOstoresuchfiles.'IfspaceisatapremiumyoumaydeletetheNO>sourcefilesaswellasthe temporaryfilesproducedduring$Othe compilationprocess.* oAOYoushouldnowdefineaCCLtoinvoke UPDNODES.JOYoushouldplacethe definitionyourinitializationfile,AO5[0,1]START.COM.Definethesymbolasshownbelow:-O $&DEFINE/COMMAND/SYSTEM% UPDNODES-D disk  :[ $ ppn ]UPDNODES.TSK   M RETURN M  SS9+! ['O 2.2Using!Portable!UPDNODESROTogenerateanewmasternodesfile,youwillneedapreviousKOversionofthemasternodesfile(BITEARNNODES)andoneKOBormoreupdatefiles,alongwiththeUPDNODES executable.tZZ, ws=O2.1B ObtainingYourInitialBITEARNNODESFileMOU Obviously,beforeyoucanapplymonthlyupdatesyou'llhaveWOtohaveafiletoapplytheupdatesto.(Thus,you'llhavetogetKOacopyofthecurrentBITEARNNODESfile.(TherearetwoGO^possibleplacestogetthisfile,as discussedbelow.-Vh.O2.1.1BFromaNearbyBITNETsiteLO4IfyouknowthatoneofyournearbyBITNETsiteshasanNO up-to-datecopyofthefile,youcanrequestitfromthem.WOSincethefileisquitelarge,gettingitfromanearbysitewillIO=reducenetworkload,andyou'llgetitfasteraswell..! 4-O2.1.2BFromYourNearestNETSERVSO4Ifnoneofyour neighboringsiteshasacopyofthefile,youKOcanrequestacopyfromyournearestNETSERV.YoushouldJOeitheralreadyknow,orfindoutnow,wherethenearestHO=NETSERVis.'Usingwhatevermethodyour operatingsystemFOusesfor interactiveSEND commands,sendthecommand:O GET%BITEARN%NODES'/! IOtoyournearestNETSERV.TheNETSERVwillthentransmitVOthelatestversionofthefiletoyou.*PleasebepatientasthisNO5processmaytakeseveraldays(butyouonlyhavetodoitOonce).0U*O2.2B ObtainingMonthlyUpdatesIOUUpdatesareissued approximatelyonceamonth, generallyQOonthefirstfullweekend.*Thebestwaytoensureyou'llgetJOtheupdatesisto subscribetothemusing NETSERV'sAFDLO^ (AutomaticFile Distribution) mechanism.(Toaddyourselfto:Othelistof subscribers,sendthecommand:O< AFD%ADDz< password< *%NODUPDO1%%OtoyournearestNETSERV.2 TOIfyourcopyofthemasternodesfileisoutofdate,youmayNOrequest"backissues"oftheupdatefilesfromNETSERVwithO5thecommand:O GET%VERSyynn%NODUPD3hLONotethatNETSERVwillnothaveupdatefilesmorethanaOyearorsoold.<~v+OTable2-1:7FileNameDefaults O OKFileName /13K Description Of O UPDATE.NODUPD3UpdatefilenameO( BITEARN.NODES3(InputfilenameO BITEARN.NEW3Outputfilename O  O+ 1NmG UppercaseonallsystemsexceptUnix,lowercaseonUnix. Ox 4%O2.3BLISTSERV-PunchFormatKOUItisquitelikelythattheNODESandNODUPDfileswillDObeshippedinaformatknownasLISTSERV-Punch(orOLPUNCHA).AnLPUNCH converteristrivialtowrite,andGO^oneis availableforVAX/VMSsystemsfromtheVMSSERV>OfileserveratVMSSERV@FHCRCVAXbysendingtheOcommand:O GET%BITNET.PACKAGE5VONotethatthereisaperiodinthis filename,notaspaceasin=Otheother filenamesyourequestfromservers.  6 +O2.4BInvokingPortableUPDNODESDOUThegeneralformforinvokingportableUPDNODESis:IO updnodes% [options]%[[[update_file]& input_file]& output_file]7 O2.4.1BOptionsRO4Variousoptionsare availabletotunethe operationofportableFO UPDNODES.NormallyyouwouldnotneedtospecifyanyOoptions.8O2.4.1.1C-vOption O)The )-v:j)option provides verbose messages while pro-HOcessingthe updatefile.1AmessageisloggedforeachDOADD/REPLACE/DELETEaction,aswellasforthefinalEO3checksum validations.*An"a"maybeappended(asin 3-va v3)LOtoprovideevenmoreoutputfor debugging purposes,orto,Osatisfythe terminallycurious.u9KO2.4.1.2C-l#Option O)The )-l#I)optionlimitsthelinelengthoftheoutputfileto#JO characters.,Thedefaultis240,whichproducesanoutputDOfile identicaltothatoftheEARNUPDNODESPASCALPO3program.)Sincesuchafileishard(forhumans)toread,anKOoptionsuchas-l80maybegiventoproducea terminal-HOwidthoutput file.1Such outputfiles shouldbetreatedFO< identicallybyanyprogramwhich manipulatesthenodeO database.Z:L0O2.4.1.3C-?!Option O)The )-?Dq)optiondisplaysashorthelpandusagemessage.+ItGOalsogivestheversionoftheUPDNODESprogram.,SinceJOquestionmarksarenormallyglobbedonUnixsystems,you%O3mayspecify-haswell.7; V !O2.4.2BFile ParametersRO4Youmayspecifythefilenamestobeusedintheupdaterun.KOIfyoudonotspecifyafilename,UPDNODESwillusea;Odefaultname,asshowninthetablebelow:O=Table2-1*;O|?<=IOFromthis, itcanbeseenthatifyouinvokeportable@OUPDNODESwithasinglecommandlineargumentofAO<VERSyynn.NODUPD,UPDNODESwillapplythoseupdates@OtothefileBITEARN.NODES, producing BITEARN.NEW.IOOnceyouare satisfiedthattheoutputiscorrect, you@OEmaydeletetheoriginal BITEARN.NODESandrename)O BITEARN.NEWtoBITEARN.NODES.]])INDEXINDEX!i  iAA)S  9AFDAFD0!i  iCC)S  9CCLCCL)!i  iEE@S8ErrormessagesError messages>!i  iII/S8int16uint16u !i  iLL?S8LISTSERV-PunchLISTSERV-Punch4/S9LpunchLpunch4!i  iMM<S 8MailinglistMailing listz3S 8makefilemakefile!/S 9MessagesMessages-SN8ErrorError>/S8MS-DOSMS-DOS&!i  iOO-S9oldccoldcc1S8OptionsOptions6!i  iPP9S 8 PerformancePerformance%/S 8ProblemsProblems5S N9 ReportingReportingw!i  jRRHS8 ReportingproblemsReporting problemsw;S 8 RequirementsRequirements/S9RSTS/ERSTS/E(!i  jSS9S 8 SHORT_NAMESSHORT_NAMES!i  iTT1S8TestingTesting$1S8typedeftypedef !i  iUU+S9UnixUnix1S8UpdatesUpdatesw!i  iVV)S  8VAXVAX)S  9VMSVMS!i  iWWAS9WEIRD_BIT_ORDERWEIRD_BIT_ORDERA A 9\>w2O2.5BErrorMessagesDOUPortableUPDNODEScanreturnseveralerror messages.>OAllsucherrormessagesbeginwiththeprefix ***BError: EandLOthenhaveadetailedmessagetext.)TheerrormessagesandO^ explanationsare:?iO ADD%forz node4 without%DEL%for node  .OP Doing%auto&DEL%forP node P .@bHOTheupdatefilehadanADD statementforanodethatOalreadyexists.wA!M*O Attempt&to&ADD%existing%node nodeD -%ignored.BbHOTheupdatefilehadanADD statementforanodethatOalreadyexists.zC!P-O Attempt&to&DEL% nonexistent%node node -%ignored.D! aQOTheupdatefilehadanDEL statementforanodethatdoesn'tOexist.zE!P-O Attempt&to&REP% nonexistent%node node -%ignored.F! aQOTheupdatefilehadanREP statementforanodethatdoesn'tOexist.G!i!O Base&file%version%is_ versiond ,%delta%is%for version  .H UOThisisnottheproperupdatefileforthebasefile.'MakesureFOyouhaveappliedall interveningupdatesin sequence.IiO Checksum%for%entry node' invalid&for%original%base.OP Verification:ZP dec/hex_P ,& Calculated:jP dec/hexJ VOThedatafoundintheoriginalfilewasnotcorrect,orthereis9OaproblemintheUPDNODESchecksumlogic.KiO Checksum%for%entry node, invalid&for%output% information.OP Verification:ZP dec/hex_P ,& Calculated:jP dec/hexLROThecreatedoutputdataisnotcorrect,orthereisaproblem-OintheUPDNODESchecksumlogic.M!UO DEL%forz node ,&but node non-existent.N! aQOTheupdatefilehadanDEL statementforanodethatdoesn'tOexist.TO!**O Error(s)%detected%during%run.PaHOSummarymessagegivenatendofrunwhenothererrorsOwere detected.ZQ!0O ftell(base)%returns: positionJR  OProgramlogicerror.cS!9'O fgetpos(base,&&cur)&returnsd positionJT  OProgramlogicerror.wU !MMO get_base_tag:&Ooops!%Base&line%shorter%than&major&tag%name.JV  OProgramlogicerror.WiDO Input%:totcks.%tag%doesn't%match% calculated&:totcks.OP Verification:ZP dec/hex_P ,& Calculated:jP dec/hexXQOTheoverallchecksumfortheinputfileis incorrect.(Possible8O corruptedfileorUPDNODESprogramerror.yY!OO Invalid&action action  for node  .Z! SOTheactionfieldintheupdatefilewasnotADD,DEL,orREP.,OPossible corruptedupdatefile.h[!>"O Invalid&line%length&"_ length ? ".\ fUOTheuser requestedalinelengththatwaslessthan1ornotaOnumber.]iZ2O Line&found&without%tag...&Line%was: OP >>>P text TP <<<^LOAlinewasreadwhichdidnotcontainanytags.,Possible8O corruptedfileorUPDNODESprogramerror.T_!**O Major-level%tag%is%too&long.`oLOAnodenametagwastoolong.,Possible corruptedfileor#OUPDNODESprogramerror.Za!00O min_find:%NULL%maj%pointer%passed.Jb  OProgramlogicerror.pc!F%O No%:totcks.%tag%in%base version entry.d NPOAnattemptwasmadetoprocessaversionentrythatdidnotOOhavetherequiredtotalchecksumtag.'Possible corruptedfile$O5orprogramlogicerror.qe!G&O No%:totcks&tag%in%output version entry.f NNOAnattemptwasmadetowriteaversionentrythatdidnotOOhavetherequiredtotalchecksumtag.'Possible corruptedfile$O5orprogramlogicerror.Zg!00O No% major-level%tag%in%Nodes%file.hHOUPDNODEScouldnotlocateanytagsintheinputfile.BOPossible corruptedfileorUPDNODESprogramerror.Si!))O No% resulting%VERSnnnn%entry.j! vLOTheVERSnnnnentrywasdeletedandnonewonewasadded.*OPossiblecorruptupdatefile.kiO This&version%(Z version$_ )&is&not%smart%enough.*OP You%require%at%least%versionP version P .lYFOThe update file said it requires a newer release ofO UPDNODES.Pm!&&O Too%many%files% specified.n]EOTheuserenteredmorethanthreefilenamesontheOcommandline.xo!N)O Unable%to%add&new%tags&for? node -%all&used.pNKOThereweremorethan75tagsinanodeentry.* Recompile?Otheprogramwiththe TAGS_IN_NODE definitionin O5 UPDNODES.H increased.}q!SO Unable%to%open type: file%" name  ".lrBBOUPDNODESwasnotabletoopenoneofthefiles.js!@@O Update%file%does&not%contain&any%known%actions.t NTOTheupdatefileyou submittedisnotanupdatefile,orisnotQOintheproperformat.'Possiblyithasnotbeen convertedfromO5LPUNCHformat.uf iNO Updated&:totcks.&tag%doesn't&match& calculated%output&:totcks.OP Verification:ZP dec/hex_P ,& Calculated:jP dec/hexv ROTheoverallchecksumfortheoutputfileis incorrect.'Possible8O corruptedfileorUPDNODESprogramerror.w;O2.6B ReportingProblemsand ObtainingUpdatesDOUWhileportableUPDNODEShasbeen extensivelytested,IOproblemscanarisedueto unforeseenconfigurations,newMOversionsofrelated software,or oversights.-IfyoufindaHO^probleminportable UPDNODES,pleasecontacttheauthorCOandreportitusingoneofthe followingmethods:xONetworkmail:O terry@spcvxa.spc.eduD (Internet)OP terry@spcvxa.bitnetDP (BITNET)/O ...!rutgers!njin!spcvxb!terry(UUCP)yAORegularmail:!O Saint%Peter's&College$OP Academic%Computer%CenterO 2641&Kennedy%Blvd.'O Jersey%City,%NJ%07306%USAO( Attn:%Terry%Kennedy^z!4OBy telephone:O +1%201%435&0252{ WFOPortableUPDNODESandothertoolsfornode managementDOare discussedontheNODMGT-Lnetworkmailinglist.IO5 Announcementsofnew versions,bugfixes,etc.-arealsoQOmadeviathismailinglist.(To subscribe,sendanetworkmailBOmessagetoLISTSERV@BITNICwiththetext SUBSCRIBEO>NODMGT-LN>your-real-name|NBONewversionsofportableUPDNODESandothertools@Oare availablefromLISTSERV@BITNIC(intheTOOLSO5 FILELIST).*}a   PrefacePrefacePrefacePrefacePreface#Table 1: Tested EnvironmentsIntended AudienceDocument StructureDocument StructureRelated DocumentsRelated Documents&1. Installing Portable UPDNODES1.1 Requirements1.2 Files in the Kit"Table 1- 1: Component Files+1.3 Installation Procedure - VAX/VMS+1.3 Installation Procedure - VAX/VMS+1.3 Installation Procedure - VAX/VMS,1.4 Pre-Installation Procedure - Unix1.4.1 Defining oldcc!1.4.2 Defining SHORT_NAMES%1.4.3 Defining WEIRD_BIT_ORDER'1.4.4 Setting the Type of int16u*1.4.5 Selecting the Proper Makefile(1.5 Installation Procedure - Unix(1.5 Installation Procedure - Unix+1.6 Post-Installation Testing - Unix1.6.1 Performance Issues*1.7 Installation Procedure - MS-DOS*1.7 Installation Procedure - MS-DOS*1.8 Installation Procedure - RSTS/E*1.8 Installation Procedure - RSTS/E*1.8 Installation Procedure - RSTS/E!2. Using Portable UPDNODES42.1 Obtaining Your Initial BITEARN NODES File&2.1.1 From a Nearby BITNET site&2.1.2 From Your Nearest NETSERV&2.1.2 From Your Nearest NETSERV$2.2 Obtaining Monthly Updates$2.2 Obtaining Monthly Updates$2.2 Obtaining Monthly Updates$2.2 Obtaining Monthly Updates 2.3 LISTSERV-Punch Format 2.3 LISTSERV-Punch Format%2.4 Invoking Portable UPDNODES2.4.1 Options2.4.1.1 -v Option2.4.1.2 -l# Option2.4.1.3 -? Option2.4.2 File Parameters%Table 2- 1: File Name Defaults2.4.2 File Parameters2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages32.6 Reporting Problems and Obtaining Updates32.6 Reporting Problems and Obtaining Updates32.6 Reporting Problems and Obtaining Updates32.6 Reporting Problems and Obtaining Updates32.6 Reporting Problems and Obtaining Updates32.6 Reporting Problems and Obtaining Updates32.6 Reporting Problems and Obtaining Updates 123456789UPDNODES_211121314UPDNODES_3UPDNODES_4UPDNODES_518UPDNODES_620UPDNODES_7UPDNODES_8UPDNODES_9UPDNODES_10UPDNODES_112627UPDNODES_12UPDNODES_13UPDNODES_14UPDNODES_15UPDNODES_16UPDNODES_17UPDNODES_1835UPDNODES_19UPDNODES_20UPDNODES_2139UPDNODES_224142UPDNODES_23UPDNODES_24UPDNODES_25UPDNODES_2647UPDNODES_27495051UPDNODES_2853UPDNODES_29UPDNODES_30UPDNODES_31UPDNODES_32UPDNODES_33UPDNODES_34UPDNODES_3561UPDNODES_3663646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118UPDNODES_37120121122123124125 B-ADOBE-Helvetica-Medium-R-Normal--*-120-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-180-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-120-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-100-*-*-P-*-ISO8859-1B-ADOBE-Helvetica-Medium-R-Normal--*-100-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-140-*-*-P-*-ISO8859-1O-ADOBE-New Century Schoolbook-Medium-R-Normal--*-140-*-*-P-*-ISO8859-1M-ADOBE-New Century Schoolbook-Bold-R-Normal--*-140-*-*-P-*-ISO8859-1O-ADOBE-New Century Schoolbook-Medium-R-Normal--*-120-*-*-P-*-ISO8859-1O -ADOBE-New Century Schoolbook-Medium-R-Normal--*-100-*-*-P-*-ISO8859-1/ -ADOBE-Symbol-*-R-*--*-140-*-*-P-*-*-*@ -ADOBE-Courier-Medium-R-Normal--*-120-*-*-M-*-ISO8859-1> -ADOBE-Courier-Bold-R-Normal--*-120-*-*-M-*-ISO8859-1@ -ADOBE-Courier-Medium-O-Normal--*-120-*-*-M-*-ISO8859-1O-ADOBE-New Century Schoolbook-Medium-I-Normal--*-140-*-*-P-*-ISO8859-1ZQR Ya ` L* 'Z jp>Bv.Gx_wG$ #,%r(p),S-Z0d34 2X>,A Np:]