                                       $           NEWSRDR Installation Guide                 August, 1994      ?           This manual describes the installation of NEWSRDR, an 1           NNTP-based news reader for VMS systems.         A           Revision/Update Information:  This is a revised manual.   >           Operating System and Version: VAX/VMS V5.0 or later;A                                         OpenVMS AXP V1.0 or later   4           Software Version:             NEWSRDR V4.8                 Matthew Madison            MadGoat Software                                                 "           ________________________           11 August 1994  =           Permission is granted to copy and redistribute this *           document for no commercial gain.  ?           The information in this document is subject to change 9           without notice and should not be construed as a 9           commitment by the author. The author assumes no ?           responsibility for any errors that may appear in this            document.   <           DISCLAIMER: The author, the author's employer, and@           MadGoat Software make no representations or warranties>           with respect to the contents hereof and specifically?           disclaim any implied warranties of merchantability or -           fitness for any particular purpose.   ;           The following are trademarks of Digital Equipment            Corporation:  8           AXP                DEC                 OpenVMS            VAX                VMS  9           MultiNet is a registered trademark of TGV, Inc.              __________<           Copyright 1993, 1994 MadGoat Software. All Rights           Reserved.                        A           _______________________________________________________              Contents  A                 _________________________________________________ A                 PREFACE                                         v   A                 _________________________________________________ A                 OPENVMS AXP V1.5 COMPATIBILITY NOTE           vii   A           _______________________________________________________ A           CHAPTER 1  INSTALLING NETLIB                        1-1   A                 _________________________________________________ 3                 1.1   DETERMINING WHETHER NETLIB IS A                       INSTALLED                               1-1   A                 _________________________________________________ A                 1.2   INSTALLING NETLIB SYSTEM-WIDE           1-2   A                 _________________________________________________ A                 1.3   PERSONAL NETLIB INSTALLATION            1-2   A                 1.3.1     Personal NETLIB Restriction  ___    1-3   A           _______________________________________________________ A           CHAPTER 2  INSTALLING NEWSRDR                       2-1   A                 _________________________________________________ A                 2.1   CREATING THE NEWSRDR IMAGE              2-5   A                 _________________________________________________ A                 2.2   COMPILING NEWSRDR FROM SOURCES          2-5   A                 _________________________________________________ A                 2.3   HELP LIBRARY                            2-5   A                 _________________________________________________ A                 2.4   ON-LINE DOCUMENTATION                   2-6       A                                                               iii                     Contents          A                 _________________________________________________ A                 2.5   PRIVILEGES REQUIRED                     2-6   A                 2.5.1     EXQUOTA and User Profiles  _____    2-7   A                 _________________________________________________ A                 2.6   OTHER USER REQUIREMENTS                 2-7   A                 _________________________________________________ A                 2.7   FULL-SCREEN OUTPUT                      2-7   A                 _________________________________________________ A                 2.8   CALLABLE EDITORS                        2-8   A                 _________________________________________________ A                 2.9   VMS MAIL INTERFACE                      2-8   A                 _________________________________________________ A                 2.10  CHARACTER CONVERSION SUPPORT            2-9   A                 _________________________________________________ A                 2.11  ESTABLISHING YOUR TIME ZONE            2-10   A                 _________________________________________________ A                 2.12  NAME CONVERSION SUPPORT                2-11   A                 _________________________________________________ A                 2.13  ADDRESS CONVERSION SUPPORT             2-12   A                 _________________________________________________ A                 2.14  INSTALLING NEWSRDR FOR PERSONAL USE    2-13                              iv         A                                                          Contents           A           _______________________________________________________            TABLES  A                 2-1       NEWSRDR system logical names  __    2-1                                                                         A                                                                 v                    A           _______________________________________________________              Preface   =           The NEWSRDR utility provides an interface to USENET >           news that may be more familiar to VMS users. NEWSRDR<           attempts to follow the conventions of the VMS MAIL;           utility in its presentation and command structure            whenever possible.  L           __________________________________________________________________             Intended Audience   5           This manual is intended for system managers <           responsible for installing and setting up NEWSRDR.  L           __________________________________________________________________             Document Structure  ;           This document consists of two chapters. Chapter 1 ;           describes the installation of NETLIB, the network @           interface library used by NEWSRDR. Chapter 2 describes8           the installation and configuration of NEWSRDR.  L           __________________________________________________________________             Related Documents   ?           The NEWSRDR User's Guide describes how to use NEWSRDR #           and all NEWSRDR commands.   ?           Internet RFC 1036, Standard for Interchange of USENET 8           Messages explains the structure of USENET news<           articles. RFC 977, Network News Transfer Protocol,=           describes NNTP news service. The Internet RFC's are 7           available via anonymous FTP from NIC.DDN.MIL.   L           __________________________________________________________________  (           MadGoat Software Mailing Lists  ;           MadGoat Software has set up the following mailing <           lists for discussions and support of its products:  (           o  Info-MadGoat@wkuvx1.wku.edu  A                                                                 v                     Preface           =              Discussion of MadGoat Software products by users A              and MadGoat developers. To subscribe, send a message <              to Info-MadGoat-Request@wkuvx1.wku.edu with the@              word SUBSCRIBE in the first line of the body of the              message.   ,           o  MadGoat-Announce@wkuvx1.wku.edu  ;              Announcements of new releases and new products :              from MadGoat. To subscribe, send a message to=              MadGoat-Announce-Request@wkuvx1.wku.edu with the @              word SUBSCRIBE in the first line of the body of the              message.   (           o  MadGoat-Bugs@wkuvx1.wku.edu  ;              Address for reporting bugs in MadGoat Software =              products. Please include the name of the package >              and version in the subject header of the message,=              so the report can be more easily directed to the #              appropriate developer.                                                  vi                   A           _______________________________________________________   -           OpenVMS AXP V1.5 Compatibility Note   ;           A bug in the DEC C Run-Time Library under OpenVMS <           AXP V1.5 will cause NEWSRDR to exit with an access>           violation (ACCVIO) when it tries to signal an error.?           A fix for this bug is available from Digital customer @           support. The identification of this patch is CSC Patch;           #378 (CSCPAT_0378); DSNlink users can obtain this 1           patch electronically using DSNLINK VTX.                                                             A                                                               vii                      A           _______________________________________________________       1      Installing NETLIB       @           Note: NEWSRDR can use either a Berkeley socket library?           or the provided NETLIB library for communicating with =           the NNTP server over TCP/IP. If your TCP/IP package ?           supports a Berkeley socket interface, you do not need <           to install NETLIB for use with NEWSRDR, and should           skip this chapter.  >           NEWSRDR can use the NETLIB library for communicating?           on a TCP/IP network. NETLIB is a layered library that ?           is used by several of the network utilities available >           from MadGoat Software. It provides basic TCP and UDP<           services layered on top of one of several vendors'>           TCP/IP packages. As of this writing, NETLIB supports>           CMU-Tek TCP/IP, DEC TCP/IP Services for VMS, Process>           Software's TCPware, TGV MultiNet, and The Wollongong/           Group's WIN/TCP and PathWay products.   L           __________________________________________________________________  1    1.1    Determining Whether NETLIB is Installed   ?           You only need to install the NETLIB libraries if they =           have not already been installed on your system. You <           can check for NETLIB's existence with the commands  4                            $ SHOW LOGICAL NETLIB_DIR7                            $ SHOW LOGICAL NETLIB_SHRXFR 4                            $ SHOW LOGICAL NETLIB_SHR  <           If these commands succeed, and the files that they>           point to exist, then NETLIB is installed and you can#           skip to the next chapter.     A                                                               1-1                     Installing NETLIB         L           __________________________________________________________________  '    1.2    Installing NETLIB System-wide   ;           NETLIB is provided in a distribution kit suitable <           for installation with VMSINSTAL. The release notes<           in the A save set of the distribution kit describe@           installation requirements for NETLIB. You can retrieve<           the release notes by using OPTIONS N on VMSINSTAL:  T                            $ @SYS$UPDATE:VMSINSTAL NETLIB disk:[directory] OPTIONS N  >           Once NETLIB has been installed, it should be started4           by invoking its startup command procedure:  8                            $ @SYS$STARTUP:NETLIB_STARTUP  8           This should be done from a suitably privileged5           account, before you try to install NEWSRDR.   L           __________________________________________________________________  &    1.3    Personal NETLIB Installation  ?           If you are not a system manager but still want to use @           NEWSRDR, you can install a copy of NETLIB for your own>           personal use. To do this, create a temporary working*           directory and SET DEFAULT to it:  5                            $ CREATE/DIRECTORY [.TEMP] 0                            $ SET DEFAULT [.TEMP]  ?           Next, unload the contents of the NETLIBvvu.B save set =           into the working directory and execute NETLIB_USER_ =           INSTALL.COM (substitute appropriate values for vvu; ,           for example, 016 for NETLIB V1.6):  A                            $ BACKUP disk:[dir]NETLIBvvn.B/SAVE [] 1                            $ @NETLIB_USER_INSTALL   ;           Answer the questions from the installation script 8           and the NETLIB files will be created. Once the<           installation procedure is complete, you can delete.           the files and the working directory:  
           1-2          A                                                 Installing NETLIB           ,                            $ SET DEFAULT [-]0                            $ DELETE [.TEMP]*.*;*;                            $ SET PROTECTION=O:RWED TEMP.DIR -                            $ DELETE TEMP.DIR;   %           ___________________________   %    1.3.1  Personal NETLIB Restriction   <           You cannot use a personal NETLIB with NETLIB-based:           applications that are installed with privileges.                                                          A                                                               1-3                      A           _______________________________________________________       2      Installing NEWSRDR      ;           NEWSRDR consists of a main executable image (with =           some possible additions, as described later in this ?           chapter) and requires the following logical names for !           configuration purposes:   A           Table_2-1__NEWSRDR_system_logical_names________________   A           Logical_Name____________Meaning________________________   >           NEWSRDR_ANNOUNCE        a message (or a pointer to aA                                   file containing a message) that A                                   is displayed whe NEWSRDR starts %                                   up.   :           NEWSRDR_BANG_ADDRESS    controls whether NEWSRDR<                                   generates UUCP bang-format?                                   addresses for From and Reply- ;                                   To headers (as opposed to <                                   user@host format). Default+                                   is FALSE.   :           NEWSRDR_BANG_PATH       controls whether NEWSRDR<                                   generates UUCP bang-format?                                   addresses for the Path header :                                   (as opposed to user@host;                                   format). Default is TRUE. <                                   Ignored if NEWSRDR_DO_PATH+                                   is FALSE.   =           NEWSRDR_DISABLE_USER_   when TRUE, users cannot set =           REPLY_TO                their own Reply-To headers. 3                                   Default is FALSE.     A                                                               2-1                     Installing NEWSRDR          A           Table_2-1_(Cont.)__NEWSRDR_system_logical_names________   A           Logical_Name____________Meaning________________________   ;           NEWSRDR_DISALLOW_       when defined, the user is <           POSTING                 prevented from posting any+                                   articles.   :           NEWSRDR_DO_DATE         controls whether NEWSRDRA                                   generates its own Date headers. 3                                   Default is FALSE.   :           NEWSRDR_DO_MESSAGE-ID   controls whether NEWSRDR>                                   generates its own Message-ID<                                   headers. Default is FALSE.  @           NEWSRDR_DO_NEWGROUPS    controls whether NEWSRDR sends<                                   a NEWGROUPS command to the<                                   server at startup. Default=                                   is TRUE. Should only be set >                                   to FALSE if your NNTP server;                                   aborts when it receives a 4                                   NEWGROUPS command.  :           NEWSRDR_DO_PATH         controls whether NEWSRDR<                                   includes a Path: header in?                                   articles it posts. Default isd>                                   TRUE. Should be set to FALSE@                                   if requested by the manager of3                                   your NNTP server.                     
           2-20    e    A                                                Installing NEWSRDR           A           Table_2-1_(Cont.)__NEWSRDR_system_logical_names________   A           Logical_Name____________Meaning________________________   =           NEWSRDR_FAKE_           when TRUE, NEWSRDR does itsi>           NEWGROUPS               own new newsgroup discovery.>                                   Default is FALSE. Can be setA                                   to TRUE if your server does not @                                   support NEWGROUPS and you want@                                   automatic newsgroup discovery.@                                   Use of this feature causes all>                                   NEWSRDR profiles to list all?                                   newgroups on the news server,c?                                   which consumes much more disky?                                   space per user than when this 5                                   option is disabled.   ?           NEWSRDR_INITIAL_        a list of newsgroups that new >           GROUPS                  users will get subscribed to>                                   automatically the first time3                                   they use NEWSRDR.   =           NEWSRDR_MAIL_NODE       the node name of the system <                                   for mail purposes. This is=                                   used in constructing return_@                                   addresses in mail messages and0                                   news articles.  ?           NEWSRDR_MAIL_PROTOCOL   the VMS MAIL foreign protocolP:                                   prefix to be attached to>                                   outgoing mail addresses. The;                                   prefix should include the >                                   trailing percent-sign (e.g.,1                                   "MX%", "INET%")E           .   ?           NEWSRDR_NO_XHDR         disables the attempted use of A                                   the XHDR extended NNTP command.   <           NEWSRDR_NO_XOVER        disables the attempted use<                                   of the XOVER extended NNTP*                                   command.  A                                                               2-3l T                  Installing NEWSRDR          A           Table_2-1_(Cont.)__NEWSRDR_system_logical_names________E  A           Logical_Name____________Meaning________________________   =           NEWSRDR_NODE_NAME       the node name of the system <                                   for news purposes. This is;                                   generally the same as the @                                   Internet node name or the mail,                                   node name.  A           NEWSRDR_ORGANIZATION    The name of the organization to @                                   be used in the "Organization:":                                   header in news articles.+                                   Optional.   ?           NEWSRDR_SERVER          The Internet node name of the A                                   NNTP news server to be used for_0                                   NEWS sessions.  9           NEWSRDR_GMT_OFFSET      A VMS delta time string 5                                   specifying the time <                                   differential between local@                                   time and Universal Coordinated'                                   Time._  A           NEWSRDR_US_DST_ZONE     Either TRUE or FALSE, dependingU:                                   on whether your localityA                                   observes U.S. standard daylight A           ________________________savings_time.__________________   9           The file NEWSRDR_STARTUP.COM, supplied with the ?           distribution kit, contains sample commands needed for ?           defining these logical names and performing the other ?           tasks needed to make NEWSRDR available on the system. =           You should edit that file as needed for your system_9           and include it in your system startup sequence.         
           2-4          A                                                Installing NEWSRDR.        L           __________________________________________________________________  $    2.1    Creating the NEWSRDR Image  8           The NEWSRDR package comes with the object code9           required to create the NEWSRDR image. A command_<           procedure called LINK.COM is provided for creating           the image:  "                            $ @LINK  8           If you wish to link NEWSRDR with your TCP/IP's;           Berkeley socket library (if it supports one), you_>           may need to recompile SERVER_SOCKET.C as appropriate;           for your TCP/IP package, and you may also need to @           edit LINK.COM to link against the necessary library or           libraries.  L           __________________________________________________________________  (    2.2    Compiling NEWSRDR from Sources  ;           If you would rather build NEWSRDR from the sourcev=           code, and have a C compiler (either VAX C or DEC C)a?           installed on your system, Use the COMPILE.COM commandn4           procedure included in the NEWSRDR package:  %                            $ @COMPILE   8           Then follow the compilation with the link step#           described in Section 2.1._  L           __________________________________________________________________      2.3    Help Library  7           The help library for NEWSRDR may be placed in ;           SYS$HELP, or, if you define logical name NEWSRDR__@           HELP to be the full file specification of the library,3           anywhere else on the system. For example:i  ]                            $ DEFINE/SYSTEM NEWSRDR_HELP LOCAL_STUFF:[NEWSRDR]NEWSRDR_HELP.HLBr  A                                                               2-5.                    Installing NEWSRDR        L           __________________________________________________________________      2.4    On-Line Documentationw  =           The NEWSRDR documentation set is provided in a form =           suitable for use with the VMS DECwindows Bookreader ?           program (VMS V5.3 and later). To make the NEWSRDR on-i<           line documentation available automatically through<           Bookreader, place the DECW$BOOK and DECW$BOOKSHELF@           files provided in the distribution kit in a directory,7           set their protection to WORLD:RE, and set the_;           value of the NEWSRDR_DOC_DIR symbol at the top ofG<           NEWSRDR_STARTUP.COM to be the device and directory?           specification for the location of the files. NEWSRDR_f;           STARTUP will automatically modify the appropriate <           Bookreader logical names to make the documentation           available.  L           __________________________________________________________________      2.5    Privileges Required   <           NEWSRDR requires TCP/IP network access to the news<           server to operate. On systems which use the access>           controls available with the CMU TCP/IP package, this@           may require the granting of a rights identifier to the.           accounts that will be using NEWSRDR.  9           NEWSRDR uses callable MAIL and the MAIL foreigne>           protocol interface to send mail messages. Therefore,9           NEWSRDR will need to be INSTALLed with the same =           privileges as VMS MAIL's executable image, MAIL.EXEs?           (if any). NEWSRDR never uses these privileges itself,P=           and turns off all image privileges except NETMBX atn;           the start of execution. If you do not wish to usee:           NEWSRDR to send mail, you do not need to install"           NEWSRDR with privileges.        
           2-6          A                                                Installing NEWSRDR_        %           ___________________________1  #    2.5.1  EXQUOTA and User Profilesu  ?           If you install NEWSRDR with the EXQUOTA privilege, itw?           will turn on that privilege when writing out a user'sC;           NEWSRDR profile (and NEWSRC file, if one is set).h=           This is the only privilege that NEWSRDR will use ifT=           it is available, and is only used for this purpose.S@           The privilege is not required, but makes using NEWSRDR<           easier for users who are close to their diskquota.  L           __________________________________________________________________  !    2.6    Other User Requirements   7           NEWSRDR has no extensive disk quota or memory_8           requirements for most operations. The NEWSRDR_:           PROFILE.NRPF file created for each user contains<           information about only those groups to which users@           subscribe, and should not require more than a few disk           blocks for each user.t  :           When NEWSRDR retrieves news articles from a news=           server, it copies them into temporary files created ;           in the user's SYS$SCRATCH directory. Extracts for ;           reply postings, mailings, and print jobs are alsoa?           created in SYS$SCRATCH. Since news articles generallyl?           do not exceed a few hundred lines, this should not beP#           a problem for most users.f  L           __________________________________________________________________      2.7    Full-Screen Output  :           NEWSRDR displays news articles on a page-by-page:           basis, much like VMS MAIL. The Screen Management8           Facility (SMG$) is used to obtain the terminal=           size and perform the screen clears for each page of1           output.t  A                                                               2-7T    r               Installing NEWSRDR        L           __________________________________________________________________      2.8    Callable Editors  9           NEWSRDR can use any callable editor for message @           composition that meets the following calling standard:  >           o  The callable editor's shareable library name must@              be xxxSHR.EXE, where "xxx" is the name by which the>              editor will be called. The library must reside inA              SYS$SHARE or must have an exec-mode logical pointing &              to the library elsewhere.  >           o  The shareable library must contain an entry point=              which called xxx$EDIT, which must take the inputm;              file-spec and output file-spec, both characters;              strings passed by descriptor, as the first twoa<              arguments. If there are optional arguments, the?              xxx$EDIT routine must not rely on having more than #              two arguments present.   >           The Digital-supplied editors TPU, EDT, and TECO, and=           the (layered product) DEC Language-Sensitive Editor >           (LSE) all follow this calling standard. Editors that=           do not qualify as callable can be set up as spawned @           editors (where the editor is spawned in a subprocess).<           See the description of the SET EDIT command in the7           NEWSRDR User's Guide for further information._  L           __________________________________________________________________      2.9    VMS MAIL Interface  ?           NEWSRDR uses the callable MAIL interface to send mailD<           messages. NEWSRDR also assumes that since there is<           TCP/IP available on the system, there is some form<           of Internet mailer also available that will handle2           Internet-format (user@domain) addresses.  :           A further assumption is that the Internet mailer@           package used at your site includes a VMS MAIL "foreign<           mail protocol" interface library. The logical name;           NEWSRDR_MAIL_PROTOCOL should specify the protocolf?           prefix used on your system, including the terminating]>           percent-sign. This prefix is automatically prepended  
           2-8     w    A                                                Installing NEWSRDRB          >           to any address specified when a user mails a message           using NEWSRDR.  L           __________________________________________________________________  &    2.10   Character Conversion Support  >           If your news network uses a character representation<           for its articles that requires conversion from the9           DEC character set, as do Japanese sites (due to ?           differing Kanji representations), you can accommodate_>           the network character representation by installing a=           shareable library on the system containing routinesd6           that perform the character code conversions.  <           An example of a module containing such routines is<           provided in the file KANJI_CONVERSION.C as part of?           the distribution kit. To install the KANJI_CONVERSION_@           library as your character code conversion library, you           must:S  >           1  Compile the C module (object code is provided for(              those without C compilers):  3                               $ CC KANJI_CONVERSIONa  0           2  Create the shareable library image:  R                               $ LINK/SHARE/NOTRACE KANJI_CONVERSION,SYS$INPUT:/OPTJ                                UNIVERSAL=NETWORK_TO_LOCAL,LOCAL_TO_NETWORK'                                <ctrl/Z>   7           3  Place the image in SYS$LIBRARY, define the)=              appropriate NEWSRDR logical name and INSTALL theR              image:   W                               $ COPY KANJI_CONVERSION.EXE SYS$COMMON:[SYSLIB]/PROT=W:RE Q                               $ DEFINE/SYSTEM/EXEC NEWSRDR_CHARACTER_CONVERSION - C                               _$     SYS$SHARE:KANJI_CONVERSION.EXE ]                               $ INSTALL CREATE NEWSRDR_CHARACTER_CONVERSION/OPEN/SHARE/HEADERt  A                                                               2-9A P                  Installing NEWSRDR          ?           Note that you must do this from a suitably privileged @           account, and you must have at least one global section>           and three global pages free on the system to INSTALL>           the image. The commands for installing the image are<           provided in the sample NEWSRDR_STARTUP.COM command2           procedure provided with the NEWSRDR kit.  ;           You only need to INSTALL the character conversion :           library if NEWSRDR is installed with privileges.  L           __________________________________________________________________  %    2.11   Establishing Your Time Zone   =           This is only required if NEWSRDR_DO_DATE is definedW           TRUE.a  @           Two logical names control the way date/time stamps are=           generated by NEWSRDR for articles posted by NEWSRDRf:           users. NEWSRDR_GMT_OFFSET should be defined as a;           VMS delta time specification preceded by either al>           plus sign or a minus sign. This value represents the<           time differential between local time and Universal=           Coordinated Time (also called Greenwich Mean Time). =           For the U.S. Eastern time zone, you would define it 
           as:   K                            $ DEFINE/SYSTEM NEWSRDR_GMT_OFFSET "-0 05:00:00"   ?           The minus sign indicates that Eastern time is 5 hourst           behind GMT.n  @           The logical name NEWSRDR_US_DST_ZONE should be defined9           as TRUE if your locality observes U.S. standard >           daylight savings time (DST). This will cause NEWSRDR@           to automatically adjust the GMT offset during daylight@           savings time. If you do not observe U.S. standard DST,=           you may need alter the GMT offset value manually atS3           the beginning and end of your DST period.              2-10         A                                                Installing NEWSRDRi        L           __________________________________________________________________  !    2.12   Name Conversion Supportr  @           If your site does not use VMS usernames for addressing8           local users in network mail, you can install a=           shareable library containing a routine that NEWSRDRE6           will call on to perform username-to-mailname;           conversions for addresses that it puts in article_           headers.  ?           An example of a module containing the routines neededW=           to support such conversions is provided in the filer?           NAME_CONVERSION.C as part of the distribution kit. ToE6           install a name conversion library, you must:  ?           1  Edit and compile the C module, or develop your own >              module in another language that provides the same              interface.   0           2  Create the shareable library image:  M                               $ LINK/SHARE/NOTRACE library.OBJ,SYS$INPUT:/OPT =                                UNIVERSAL=INIT,CONVERT,CLEANUP '                                <ctrl/Z>s  A           3  Place the resulting image in SYS$LIBRARY, define ther>              appropriate NEWSRDR logical name, and INSTALL the              image:   N                               $ COPY library.EXE SYS$COMMON:[SYSLIB]/PROT=W:RE`                               $ DEFINE/SYSTEM/EXEC NEWSRDR_NAME_CONVERSION SYS$SHARE:library.EXEX                               $ INSTALL CREATE NEWSRDR_NAME_CONVERSION/OPEN/SHARE/HEADER  <           The interface used by NEWSRDR is identical to that@           used by MadGoat's Message Exchange E-mail software. If>           you already have installed a name conversion library?           for use with Message Exchange, you need only define a <           logical name to use the same library with NEWSRDR:  _                            $ DEFINE/SYSTEM/EXEC NEWSRDR_NAME_CONVERSION MX_SITE_NAME_CONVERSION   7           Refer to the sample code provided for further 7           information on the name conversion interface.   A                                                              2-11                     Installing NEWSRDR        L           __________________________________________________________________  $    2.13   Address Conversion Support  8           When NEWSRDR sends mail, it uses callable Mail<           routines, forming the addresses by translating the?           logical name NEWSRDR_MAIL_PROTOCOL and prefixing that @           to the quoted RFC822 destination address. If your site<           requires a more sophisticated translation (such as<           domain name reversal or better handling of special<           characters in addresses), you can install your own>           address conversion routine to perform this function.  ?           An example of a module containing the routines needed =           to support such conversions is provided in the file ?           ADDRESS_CONVERSION.C as part of the distribution kit.l=           To install an address conversion library, you must:S  ?           1  Edit and compile the C module, or develop your own >              module in another language that provides the same              interface.d  0           2  Create the shareable library image:  M                               $ LINK/SHARE/NOTRACE library.OBJ,SYS$INPUT:/OPT =                                UNIVERSAL=INIT,CONVERT,CLEANUP '                                <ctrl/Z>E  A           3  Place the resulting image in SYS$LIBRARY, define ther>              appropriate NEWSRDR logical name, and INSTALL the              image:   N                               $ COPY library.EXE SYS$COMMON:[SYSLIB]/PROT=W:REc                               $ DEFINE/SYSTEM/EXEC NEWSRDR_ADDRESS_CONVERSION SYS$SHARE:library.EXEi[                               $ INSTALL CREATE NEWSRDR_ADDRESS_CONVERSION/OPEN/SHARE/HEADER   7           Refer to the sample code provided for furtheri:           information on the address conversion interface.                 2-12         A                                                Installing NEWSRDRt        L           __________________________________________________________________  -    2.14   Installing NEWSRDR for Personal Usee  <           If you are not the system manager, you can install8           NEWSRDR for your own use, with the restriction=           that you may not be able to send mail using NEWSRDR 5           (depending on your site's E-mail software).   9           To install NEWSRDR for your own use, create the_;           NEWSRDR image as described above, place the imagea?           and the help library in directories you own, and edith>           NEWSRDR_STARTUP.COM to reflect the location of those<           files. You should also edit NEWSRDR_STARTUP.COM to=           remove the /SYSTEM qualifier from the definition of            NEWSRDR_DEF.                                                  A                                                              2-13 