`%E OxNEWSRDR Installation GuideANEWSRDR_INST  Contents  TablesB*VAX DOCUMENT V2.2pJXJGvG~GL4nMq X {! $ zh^oVLd "b*%\&()L*.|06x035A :=A~E$OOx! / gCONTENTSCONTENTS8 E\TitlePageTitle Page@E\ CopyrightPageCopyright Page1xE\PrefacePreface m$11E\OpenVMSAXPV1.5 CompatibilityNoteOpenVMS AXP V1.5 Compatibility NoteKw$K1 InstallingNETLIB1 Installing NETLIBw,B $K1.15&K DeterminingWhetherNETLIBis Installed1.1 Determining Whether NETLIB is Installedpw"6 $L1.2)&L InstallingNETLIB System-wide1.2 Installing NETLIB System-wideng!5 $L1.3(&LPersonalNETLIB Installation1.3 Personal NETLIB Installationh\"..$A1.3.1PersonalNETLIB Restriction1.3.1 Personal NETLIB RestrictionMw  $K2 InstallingNEWSRDR2 Installing NEWSRDRkw4 $K2.1'&KCreatingtheNEWSRDRImage2.1 Creating the NEWSRDR Image#Mw$ $K2.2&KHelpLibrary2.2 Help Library%_g- $K2.3 &KOn-Line Documentation2.3 On-Line Documentation&[w+ $K2.4&K PrivilegesRequired2.4 Privileges Required'e\ --$@2.4.1EXQUOTAandUserProfiles2.4.1 EXQUOTA and User Profiles)dw0 $L2.5#&LOtherUser Requirements2.5 Other User Requirements*Yw* $K2.6&K Full-ScreenOutput2.6 Full-Screen Output,Ug( $K2.7&KCallableEditors2.7 Callable Editors-Zg+ $K2.8&KVMSMAIL Interface2.8 VMS MAIL Interface0nw!5 $K2.9(&K Character ConversionSupport2.9 Character Conversion Support2ow!6$K2.10(&K EstablishingYourTimeZone2.10 Establishing Your Time Zone7fw1$L2.11#&LName ConversionSupport2.11 Name Conversion Support;lw 4$K2.12&&KAddress ConversionSupport2.12 Address Conversion Support@w)?$K2.131&K InstallingNEWSRDRforPersonalUse2.13 Installing NEWSRDR for Personal UseD+gTABLESTABLEShl"..=@2-1NEWSRDRsystemlogicalnames2- 1 NEWSRDR system logical names XmM* Copyright1993,1994MadGoat Software.'AllRights Reserved. ~AllRights Reserved.P&&ONEWSRDR InstallationGuide>OMay,1994|RO{Thismanual describesthe installationofNEWSRDR,an NNTP-based*OnewsreaderforVMSsystems.xN'ORevision/Update Information:'^Thisisarevisedmanual.,t*O OperatingSystemandVersion:,^VAX/VMSV5.0orlater;OpenVMS^AXPV1.0orlater]3OSoftwareVersion:^NEWSRDRV4.8{ 7J  O OO 25May1994jO Permissionisgrantedtocopyand redistributethisdocumentforno commercialgain.jOVThe informationinthisdocumentissubjecttochangewithoutnoticeandshouldnotfObe construedasa commitmentbytheauthor.(TheauthorassumesnoresponsibilityBOforanyerrorsthatmayappearinthis document.Ou DISCLAIMER:RuTheauthor,theauthor's employer,andMadGoatSoftwaremakenofOrepresentationsor warrantieswithrespecttothecontentshereofand specificallynOdisclaimanyimplied warrantiesofmerchantabilityorfitnessforany particularpurpose.OOThe followingare trademarksofDigital Equipment Corporation: OAXP 3DECOpenVMS OVAX 3VMS@O MultiNetisa registered trademarkofTGV,Inc. O, MOq  Copyright1993,1994MadGoat Software.&AllRights Reserved.* z  ` ! 6OPrefaceDOTheNEWSRDRutilityprovidesan interfacetoUSENETGOnewsthatmaybemorefamiliartoVMSusers.(NEWSRDRMOXattemptstofollowthe conventionsoftheVMSMAILutilityMOinits presentationandcommand structurewhenever possible.   OIntendedAudienceMOUThismanualisintendedforsystemmanagers responsiblefor0O installingandsettingupNEWSRDR.h  N  w$ODocument StructureMOUThisdocumentconsistsoftwo chapters.)Chapter1 describesJOthe installationofNETLIB,thenetwork interfacelibraryKOusedbyNEWSRDR.Chapter2 describesthe installationand%O^ configurationofNEWSRDR.o  ORelated Documents OUThe UNEWSRDR User's Guide!U describes how to use/ONEWSRDRandallNEWSRDR commands.hOInternetRFC1036,0,Standardfor InterchangeofUSENETOMessages?explainsthe structureofUSENETnews articles.O5RFC977,+5NetworkNewsTransferProtocoli5, describesDONNTPnewsservice..TheInternetRFC'sare available1Ovia anonymousFTPfrom NIC.DDN.MIL.+OMadGoatSoftwareMailingListsNOUMadGoatSoftwarehassetupthe followingmailinglistsfor7O discussionsandsupportofits products:Z0 `m%mInfo-MadGoat@wkuvx1.wku.edux NEW DiscussionofMadGoatSoftwareproductsbyusersandDMadGoat developers.,To subscribe,sendamessageto-#Info-MadGoat-Request@wkuvx1.wku.eduwiththewordKa SUBSCRIBEinthefirstlineofthebodyofthemessage. `)MadGoat-Announce@wkuvx1.wku.eduuKDW Announcementsofnewreleasesandnewproductsfrom8MadGoat.+To subscribe,sendamessagetoMadGoat-)Announce-Request@wkuvx1.wku.edu&withthewordKa SUBSCRIBEinthefirstlineofthebodyofthemessage. `%MadGoat-Bugs@wkuvx1.wku.eduH! zIWAddressfor reportingbugsinMadGoatSoftware products.HPleaseincludethenameofthepackageandversioninKthesubjectheaderofthemessage,sothereportcanbeBamoreeasilydirectedtothe appropriate developer.L21OOpenVMS"AXP!V1.5! Compatibility"NoteDO{AbugintheDECCRun-TimeLibraryunderOpenVMSEOAXPV1.5willcauseNEWSRDRtoexitwithanaccessNO, violation(ACCVIO)whenittriestosignalanerror.*AfixOOforthisbugis availablefromDigitalcustomersupport.)TheIOidentificationofthispatchisCSCPatch#378(CSCPAT_JO60378);DSNlinkuserscanobtainthispatchelectronicallyOusingDSNLINKVTX.dJ!   O 1.2 Installing!NETLIB _UNote _ANEWSRDRcanuseeitheraBerkeleysocketlibrary@northeprovidedNETLIBlibraryfor communicatingBwiththeNNTPserveroverTCP/IP.IfyourTCP/IPE packagesupportsaBerkeleysocket interface,youdoBxnotneedtoinstallNETLIBforusewithNEWSRDR,+andshouldskipthischapter. EONEWSRDRcanusetheNETLIBlibraryfor communicatingHOonaTCP/IPnetwork.-NETLIBisalayeredlibrarythatMOjisusedbyseveralofthenetwork utilities availablefromJOMadGoat Software.(ItprovidesbasicTCPandUDPservicesMOlayeredontopofoneofseveralvendors'TCP/IP packages.DOtAsofthiswriting,NETLIBsupportsCMU-TekTCP/IP,IODECTCP/IPServicesforVMS,Process Software'sTCPware,EO%TGV MultiNet,andThe WollongongGroup'sWIN/TCPandO~PathWay products. 4:O1.1B DeterminingWhetherNETLIBis InstalledNOUYouonlyneedtoinstalltheNETLIB librariesiftheyhavePOnotalreadybeen installedonyoursystem.'Youcancheckfor2ONETLIB's existencewiththecommands O $# SHOW%LOGICAL% NETLIB_DIR O $& SHOW%LOGICAL% NETLIB_SHRXFR O $# SHOW%LOGICAL% NETLIB_SHRNOOIfthesecommandssucceed,andthefilesthattheypointtoQOexist,thenNETLIBis installedandyoucanskiptothenextO5chapter.U.O1.2B InstallingNETLIB System-widePOUNETLIBisprovidedina distributionkitsuitableforinstal-IOlationwith VMSINSTAL.ThereleasenotesintheAsaveOOsetofthe distributionkitdescribe installation requirementsJO^forNETLIB.Youcanretrievethereleasenotesbyusing$OOPTIONSNon VMSINSTAL: O< $E< @SYS$UPDATE:VMSINSTAL%NETLIB%disk:[directory]%OPTIONS&NzJOOnceNETLIBhasbeen installed,itshouldbestartedby5Oinvokingitsstartupcommand procedure: Oa $%a @SYS$STARTUP:NETLIB_STARTUP zQOThisshouldbedonefromasuitably privilegedaccount,before)OyoutrytoinstallNEWSRDR.|  z Z R 6OTable2-1:7NEWSRDRsystemlogicalnames O OFLogicalNameFMeaning Ob O NEWSRDR_ANNOUNCEU amessage(orapointertoafile containingamessage)thatis. displayedwheNEWSRDRstartsup.Oq NEWSRDR_BANG_ADDRESSGq controlswhetherNEWSRDR generatesUUCP bang-formatad-Q dressesforFromandReply-Toheaders(asopposedto user@host'  format).!DefaultisFALSE.O NEWSRDR_BANG_PATHG controlswhetherNEWSRDR generatesUUCP bang-formatad-P dressesforthePathheader(asopposedto user@hostformat).F! DefaultisTRUE.IgnoredifNEWSRDR_DO_PATHisFALSE.O NEWSRDR_DISABLE_USER_O REPLY_TOR whenTRUE,userscannotsettheirownReply-Toheaders.!Default isFALSE.kOb NEWSRDR_DISALLOW_POSTING}whendefined,theuseris preventedfrompostingany articles.O NEWSRDR_DO_DATEI controlswhetherNEWSRDR generatesitsownDateheaders.) DefaultisFALSE.O NEWSRDR_DO_MESSAGE-IDL controlswhetherNEWSRDR generatesitsown Message-IDhead-# ers.!DefaultisFALSE.Oj NEWSRDR_DO_NEWGROUPS?j controlswhetherNEWSRDRsendsa NEWGROUPScom-O mandtotheserveratstartup.'DefaultisTRUE.ShouldonlyS besettoFALSEifyourNNTPserverabortswhenitreceivesaS NEWGROUPScommand.O NEWSRDR_DO_PATHR controlswhetherNEWSRDRincludesaPath:"headerinarticlesitX posts."DefaultisTRUE.ShouldbesettoFALSEif requestedbythe*g managerofyourNNTPserver.bO NEWSRDR_FAKE_NEWGROUPSwhenTRUE,NEWSRDRdoesitsownnew newsgroup discovery.R/ DefaultisFALSE.CanbesettoTRUEifyourserverdoesnotH| support NEWGROUPSandyouwant automatic newsgroupdis-X covery."UseofthisfeaturecausesallNEWSRDRprofilestolistallN newgroupsonthenewsserver,whichconsumesmuchmorediskCe spaceperuserthanwhenthisoptionis disabled.mO NEWSRDR_INITIAL_GROUPSalistof newsgroupsthatnewuserswillget subscribedtoauto-:, maticallythefirsttimetheyuseNEWSRDR.O NEWSRDR_MAIL_NODEP thenodenameofthesystemformail purposes.'ThisisusedL in constructingreturn addressesinmailmessagesandnewsA articles.m!z C O OLogicalNameMeaning O fOx NEWSRDR_MAIL_PROTOCOLtheVMSMAILforeignprotocolprefixtobeattachedtoout-N goingmail addresses.'Theprefixshouldincludethetrailing0 percent-sign(e.g.,"MX%","INET%") Oa .O NEWSRDR_NO_XHDRP disablesthe attempteduseoftheXHDRextendedNNTPcommand.OT NEWSRDR_NO_XOVERMT disablesthe attempteduseoftheXOVERextendedNNTPcom- mand.O NEWSRDR_NODE_NAMEU thenodenameofthesystemfornews purposes.#Thisis generallyNi thesameastheInternetnodenameorthemailnodename.O NEWSRDR_ORGANIZATIONT Thenameofthe organizationtobeusedinthe``Organization:''00 headerinnews articles.! Optional.O NEWSRDR_SERVERS TheInternetnodenameoftheNNTPnewsservertobeusedfor NEWS sessions.Oq NEWSRDR_GMT_OFFSETSq AVMSdeltatimestring specifyingthetime differentialbetween9 localtimeand Universal CoordinatedTime.O8 NEWSRDR_US_DST_ZONEJ8 EitherTRUEorFALSE, dependingonwhetheryourlocality< observesU.S.standarddaylightsavingstime. O *D-O1.3BPersonalNETLIB InstallationJOUIfyouarenotasystemmanagerbutstillwanttouseEONEWSRDR,youcaninstallacopyofNETLIBforyourKOownpersonaluse.*Todothis,createa temporaryworking/O^ directoryandSETDEFAULTtoit: O $# CREATE/DIRECTORY%[.TEMP] O+ $+ SET%DEFAULT&[.TEMP]s7ONext,unloadthecontentsoftheNETLIB /vvu.BsavesetCOintotheworking directoryandexecute NETLIB_USER_# ,O2.1BCreatingtheNEWSRDRImageIOUTheNEWSRDRpackagecomeswiththeobjectcoderequiredAOtocreatetheNEWSRDRimage.,Acommand procedureDOcalledLINK.COMisprovidedforcreatingtheimage: O $ @LINK$ aJOIfyouwishtolinkNEWSRDRwithyourTCP/IP'sBerkeleyOOsocketlibrary(ifitsupportsone),youmayneedtorecom-CO5pileSERVER_SOCKET.Cas appropriateforyourTCP/IPKOpackage,andyoumayalsoneedtoeditLINK.COMtolink:Oagainstthe necessarylibraryor libraries.%! vO2.2BHelpLibrary?OUThe help library for NEWSRDR may be placed inBO SYS$HELP,or,ifyoudefinelogicalnameNEWSRDR_SOHELPtobethefullfile specificationofthelibrary,anywhere/O^elseonthesystem.'Forexample: O $L DEFINE/SYSTEM% NEWSRDR_HELP&%LOCAL_STUFF:[NEWSRDR]NEWSRDR_HELP.HLB&! f%O2.3BOn-Line Documentation?OUTheNEWSRDR documentationset isprovided ina>Oform suitable for use!with the VMS DECwindowsAO Bookreaderprogram(VMSV5.3andlater)./Tomake@O^theNEWSRDRon-line documentation availableauto-@O maticallythrough Bookreader,placethe DECW$BOOKBOandDECW$BOOKSHELFfilesprovidedinthe distribu-MOhtionkitina directory,settheir protectionto WORLD:RE,@OandsetthevalueoftheNEWSRDR_DOC_DIRsymbolAOatthetopofNEWSRDR_STARTUP.COMtobethede-ROrviceand directory specificationforthelocationofthefiles.CONEWSRDR_STARTUPwill automaticallymodifytheappro-JO#priate Bookreaderlogicalnamestomakethe documentationO{ available.' k#O2.4B PrivilegesRequiredCOUNEWSRDRrequiresTCP/IPnetworkaccesstothenewsNOservertooperate.)OnsystemswhichusetheaccesscontrolsIO availablewiththeCMUTCP/IPpackage,thismayrequireUO^thegrantingofarights identifiertotheaccountsthatwillbeOusingNEWSRDR.(! UFONEWSRDRusescallableMAILandtheMAILforeignpro-JOtocol interfacetosendmail messages.' Therefore,NEWSRDRMO5willneedtobe INSTALLedwiththesame privilegesasVMSCOMAIL's executableimage,MAIL.EXE(ifany).)NEWSRDRUOneverusesthese privilegesitself,andturnsoffallimagepriv-O>ileges)>except> NETMBX:>atthestartof execution.'IfyoudonotIOwishtouseNEWSRDRtosendmail,youdonotneedto-OinstallNEWSRDRwith privileges.T) `*-O2.4.1BEXQUOTAandUserProfilesCO4IfyouinstallNEWSRDRwiththeEXQUOTA privilege,LOitwillturnonthat privilegewhenwritingoutauser'sMONEWSRDRprofile(andNEWSRCfile,ifoneisset).(Thisis O=the=onlyE= privilegethatNEWSRDRwilluseifitis available,POandisonlyusedforthispurpose.+The privilegeisnotre-KOquired,butmakesusingNEWSRDReasierforuserswhoare&OGclosetotheir diskquota.*)(O2.5BOtherUser Requirements>OUNEWSRDRhasno extensivedisk quotaormemory=O requirementsformost operations.0TheNEWSRDR_EO PROFILE.NRPFfilecreatedforeachusercontainsin-MO^ formationaboutonlythosegroupstowhichusers subscribe,POandshouldnotrequiremorethanafewdiskblocksforeachOuser.+WAOWhenNEWSRDR retrievesnewsarticlesfromanewsMOserver,itcopiestheminto temporaryfilescreatedintheJO5user's SYS$SCRATCH directory.(Extractsforreply postings,KO mailings,andprintjobsarealsocreatedin SYS$SCRATCH.LOSincenewsarticles generallydonotexceedafewhundredFO>lines,thisshouldnotbeaproblemformostusers.x^, w4"O2.6B Full-ScreenOutputEOUNEWSRDRdisplaysnewsarticlesona page-by-pageba-IOsis,muchlikeVMSMAIL.TheScreen ManagementFacilityNO(SMG$)isusedtoobtaintheterminalsizeandperformthe6O^screenclearsforeachpageofoutput.-  O2.7BCallableEditorsJOUNEWSRDRcanuseanycallableeditorformessagecomposi-?Otionthatmeetsthe followingcalling standard:.! # `mEmThecallableeditor's shareablelibrarynamemustbeI xxxSHR.EXE,where``xxx''isthenamebywhichtheed-Litorwillbecalled.&Thelibrarymustresidein SYS$SHARELwormusthavean exec-modelogicalpointingtothelibrary elsewhere. `OIOThe shareablelibrarymustcontainanentrypointwhichEcalled xxx$EDIT,whichmusttaketheinput file-specGandoutput file-spec,both characterstringspassedbyKY descriptor,asthefirsttwo arguments.*Ifthereareop-Itional arguments,thexxx$EDITroutinemustnotrelyon6 havingmorethantwo argumentspresent./JOTheDigital-suppliededitorsTPU,EDT,andTECO,andtheIO(layeredproduct)DECLanguage-SensitiveEditor(LSE)allOO5followthiscalling standard.+EditorsthatdonotqualifyasOOcallablecanbesetupasspawnededitors(wheretheeditorOOisspawnedina subprocess).*Seethe descriptionoftheSET O>EDITcommandinthe >NEWSRDRUser'sGuide5>forfurtherO information.0j#O2.8BVMSMAIL InterfaceGOUNEWSRDRusesthecallableMAIL interfacetosendmailCO messages..NEWSRDRalsoassumesthatsincethereisHOTCP/IP availableonthesystem,thereissomeformofJO^Internetmaileralso availablethatwillhandle Internet-+Oformat (user@domain) addresses.1 JOAfurther assumptionisthattheInternetmailerpackageOOusedatyoursiteincludesaVMSMAIL ``foreignmailproto-GO5col'' interfacelibrary.'Thelogicalname NEWSRDR_MAIL_JOPROTOCOLshouldspecifytheprotocolprefixusedonyourKOsystem, includingthe terminating percent-sign.)ThisprefixLO>is automatically prependedtoanyaddress specifiedwhena2OusermailsamessageusingNEWSRDR.A  !2 )-O2.9B Character ConversionSupportOOUIfyournewsnetworkusesa characterrepresentationforitsOOarticlesthatrequires conversionfromtheDEC characterset,POasdoJapanesesites(dueto differingKanjirepresentations),EO^youcan accommodatethenetwork character representa-ROtionby installinga shareablelibraryonthesystem containingEOroutinesthatperformthe charactercode conversions.G3! NOAnexampleofamodule containingsuchroutinesisprovidedIOinthefileKANJI_CONVERSION.Caspartofthe distribu-KO5tionkit.'ToinstalltheKANJI_CONVERSIONlibraryasyour;O charactercode conversionlibrary,youmust:P46 ,&NOm1.JCompiletheCmodule(objectcodeisprovidedforthose!withoutC compilers): K $K CC&KANJI_CONVERSION5O2.JCreatethe shareablelibraryimage: O $=O LINK/SHARE/NOTRACE%KANJI_CONVERSION,SYS$INPUT:/OPT5 +UNIVERSAL=NETWORK_TO_LOCAL,LOCAL_TO_NETWORK   M  ctrl/Z M  KO^3.JPlacetheimagein SYS$LIBRARY,definethe appropriate;NEWSRDRlogicalnameandINSTALLtheimage: ; $C; COPY%KANJI_CONVERSION.EXE%SYS$COMMON:[SYSLIB]/PROT=W:RE  $= DEFINE/SYSTEM/EXEC%NEWSRDR_CHARACTER_CONVERSION&-  _$( SYS$SHARE:KANJI_CONVERSION.EXE  $I INSTALL%CREATE&.NEWSRDR_CHARACTER_CONVERSION/OPEN/SHARE/HEADER5! WRONotethatyoumustdothisfromasuitably privilegedaccount,SOandyoumusthaveatleastoneglobalsectionandthreeglobalKO5pagesfreeonthesystemtoINSTALLtheimage.(Thecom-LOmandsfor installingtheimageareprovidedinthesample;ONEWSRDR_STARTUP.COMcommand procedureprovided"O>withtheNEWSRDRkit.6KOYouonlyneedtoINSTALLthe character conversionlibrary7OifNEWSRDRis installedwith privileges. !7.O2.10C EstablishingYourTimeZoneDOUThisisonlyrequiredifNEWSRDR_DO_DATEisdefinedOTRUE.8! nHOTwologicalnamescontroltheway date/timestampsareDO generatedbyNEWSRDRforarticlespostedbyNEWSRDR@O5users.*NEWSRDR_GMT_OFFSETshouldbedefinedasaROVMSdeltatime specificationprecededbyeitheraplussignorPOaminussign.'Thisvalue representsthetime differentialbe-NO>tweenlocaltimeand Universal CoordinatedTime(alsocalledLO GreenwichMeanTime).'FortheU.S.Easterntimezone,you Owoulddefineitas: Ot $;t DEFINE/SYSTEM%NEWSRDR_GMT_OFFSET&"-0% 05:00:00"9 ^POTheminussign indicatesthatEasterntimeis5hoursbehindOGMT. :! BOThelogicalnameNEWSRDR_US_DST_ZONEshouldbede-QOfinedasTRUEifyourlocalityobservesU.S.standarddaylightIO5savingstime(DST).ThiswillcauseNEWSRDRtoautomat-POicallyadjusttheGMToffsetduringdaylightsavingstime.(IfLOyoudonotobserveU.S.standardDST,youmayneedalterMO>theGMToffsetvaluemanuallyatthe beginningandendofOyourDSTperiod.! "; )O2.11CName ConversionSupportNOUIfyoursitedoesnotuseVMS usernamesfor addressinglo-ROcalusersinnetworkmail,youcaninstalla shareablelibraryLO containingaroutinethatNEWSRDRwillcallontoperformEO^username-to-mailname conversionsfor addressesthatit%Oputsinarticleheaders.:<KOAnexampleofamodule containingtheroutinesneededtoHOsupportsuch conversionsisprovidedinthefileNAME_MO5 CONVERSION.Caspartofthe distributionkit.)Toinstalla0Oname conversionlibrary,youmust:&= IOm1.JEditandcompiletheCmodule,ordevelopyourownBmoduleinanotherlanguagethatprovidesthesame interface.5O2.JCreatethe shareablelibraryimage: # $8# LINK/SHARE/NOTRACE%library.OBJ,SYS$INPUT:/OPT(k UNIVERSAL=INIT,CONVERT,CLEANUP y  {M  ctrl/Z {M  IO23.JPlacethe resultingimagein SYS$LIBRARY,definetheA appropriateNEWSRDRlogicalname,andINSTALLtheimage: h $:h COPY% library.EXE%SYS$COMMON:[SYSLIB]/PROT=W:RE  $L DEFINE/SYSTEM/EXEC%NEWSRDR_NAME_CONVERSION%SYS$SHARE:library.EXE  $D INSTALL%CREATE&)NEWSRDR_NAME_CONVERSION/OPEN/SHARE/HEADER>l NOThe interfaceusedbyNEWSRDRis identicaltothatusedbyGO MadGoat'sMessageExchangeE-mail software.*Ifyoual-NO5readyhave installedaname conversionlibraryforusewithKOMessage Exchange,youneedonlydefinealogicalnameto1OusethesamelibrarywithNEWSRDR: Ok $Nk DEFINE/SYSTEM/EXEC%NEWSRDR_NAME_CONVERSION%MX_SITE_NAME_CONVERSION? zOORefertothesamplecodeprovidedforfurther informationon+Othename conversion interface."!#u@ K,O2.12CAddress ConversionSupportEOUWhenNEWSRDRsendsmail,itusescallableMailrou-NOtines,formingthe addressesby translatingthelogicalname>ONEWSRDR_MAIL_PROTOCOLand prefixingthattotheLO^quotedRFC822 destinationaddress.*IfyoursiterequiresaKOmore sophisticated translation(suchasdomainnamerever-ROsalorbetterhandlingofspecial charactersin addresses),youLOhcaninstallyourownaddress conversionroutinetoperformOthis function.AA KOAnexampleofamodule containingtheroutinesneededtoKOsupportsuch conversionsisprovidedinthefileADDRESS_NO5 CONVERSION.Caspartofthe distributionkit.'Toinstallan3Oaddress conversionlibrary,youmust:,B IOm1.JEditandcompiletheCmodule,ordevelopyourownBmoduleinanotherlanguagethatprovidesthesame interface.5O2.JCreatethe shareablelibraryimage: # $8# LINK/SHARE/NOTRACE%library.OBJ,SYS$INPUT:/OPT(k UNIVERSAL=INIT,CONVERT,CLEANUP y  {M  ctrl/Z {M  IO23.JPlacethe resultingimagein SYS$LIBRARY,definetheA appropriateNEWSRDRlogicalname,andINSTALLtheimage: h $:h COPY% library.EXE%SYS$COMMON:[SYSLIB]/PROT=W:RE  $O DEFINE/SYSTEM/EXEC%NEWSRDR_ADDRESS_CONVERSION%SYS$SHARE:library.EXE  $G INSTALL%CREATE&,NEWSRDR_ADDRESS_CONVERSION/OPEN/SHARE/HEADERC }OORefertothesamplecodeprovidedforfurther informationon.Otheaddress conversion interface.O#"fDw<7O2.13C InstallingNEWSRDRforPersonalUseEOUIfyou are notthe systemmanager,!youcan installJONEWSRDRforyourownuse,withthe restrictionthatyouHOmaynotbeabletosendmailusingNEWSRDR (depending.O^onyoursite'sE-mail software).E WAOToinstallNEWSRDRforyourownuse,!create theGONEWSRDRimageas describedabove,placetheimageandMO5thehelplibraryin directoriesyouown,andeditNEWSRDR_IO STARTUP.COMtoreflectthelocationofthosefiles.,YouBOshouldalsoeditNEWSRDR_STARTUP.COMtoremovetheEO>/SYSTEM qualifierfromthe definitionof NEWSRDR_DEF.   !!!!!""""##PrefaceIntended AudienceDocument StructureRelated DocumentsRelated Documents%MadGoat Software Mailing Lists%MadGoat Software Mailing Lists%MadGoat Software Mailing Lists%MadGoat Software Mailing Lists%MadGoat Software Mailing Lists*OpenVMS AXP V1.5 Compatibility Note1. Installing NETLIB21.1 Determining Whether NETLIB is Installed21.1 Determining Whether NETLIB is Installed(1.2 Installing NETLIB System-wide(1.2 Installing NETLIB System-wide(1.2 Installing NETLIB System-wide'1.3 Personal NETLIB Installation'1.3 Personal NETLIB Installation'1.3 Personal NETLIB Installation(1.3.1 Personal NETLIB Restriction2. Installing NEWSRDR/Table 2- 1: NEWSRDR system logical names/Table 2- 1: NEWSRDR system logical names2. Installing NEWSRDR%2.1 Creating the NEWSRDR Image%2.1 Creating the NEWSRDR Image2.2 Help Library 2.3 On-Line Documentation2.4 Privileges Required2.4 Privileges Required&2.4.1 EXQUOTA and User Profiles"2.5 Other User Requirements"2.5 Other User Requirements2.6 Full-Screen Output2.7 Callable Editors2.7 Callable Editors2.7 Callable Editors2.8 VMS MAIL Interface2.8 VMS MAIL Interface'2.9 Character Conversion Support'2.9 Character Conversion Support'2.9 Character Conversion Support'2.9 Character Conversion Support'2.9 Character Conversion Support'2.10 Establishing Your Time Zone'2.10 Establishing Your Time Zone'2.10 Establishing Your Time Zone'2.10 Establishing Your Time Zone#2.11 Name Conversion Support#2.11 Name Conversion Support#2.11 Name Conversion Support#2.11 Name Conversion Support#2.11 Name Conversion Support&2.12 Address Conversion Support&2.12 Address Conversion Support&2.12 Address Conversion Support&2.12 Address Conversion Support/2.13 Installing NEWSRDR for Personal Use/2.13 Installing NEWSRDR for Personal Use n newsrdr_inst_2 newsrdr_inst_3 newsrdr_inst_4 newsrdr_inst_5mgswlsv15_bugnewsrdr_inst_6newsrdr_inst_7newsrdr_inst_8newsrdr_inst_9newsrdr_inst_10newsrdr_inst_11 lognamtable#newsrdr_inst_12%newsrdr_inst_13&online_doc'newsrdr_inst_14)exquota*newsrdr_inst_15,newsrdr_inst_16-newsrdr_inst_170newsrdr_inst_182newsrdr_inst_197newsrdr_inst_20;newsrdr_inst_21@newsrdr_inst_22Dnewsrdr_inst_23 qB-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-1O-ADOBE-New Century Schoolbook-Medium-I-Normal--*-140-*-*-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-1O -ADOBE-New Century Schoolbook-Medium-R-Normal--*-120-*-*-P-*-ISO8859-1M -ADOBE-New Century Schoolbook-Bold-R-Normal--*-140-*-*-P-*-ISO8859-1xGvG~GL4nMq X {! $ zh^oVLd "b*%\&()L*.|06x035A :=A~E$Ox