NEWSRDR V3.0 (DECUS Library distribution), 06-DEC-1991 NEWSRDR is an NNTP client program for VMS systems running CMU-Tek TCP/IP, DEC VMS/ULTRIX Connection, TGV MultiNet, or any TCP/IP package supporting Berkeley sockets. NNTP is the Network News Transfer Protocol, which is used to communicate USENET news over TCP/IP. Since many systems cannot afford the disk space to store all net news locally, this program can be used to communicate with a cooperating news server system to read and post net news. News articles are fetched on an as-needed basis and are stored on the client system only while they are being read. NEWSRDR is not a port of UNIX-based news readers. It is written strictly for VMS and provides an interface that VMS users should find reasonably comfortable. Most of the commands in NEWSRDR should be familiar to VMS MAIL users. NEWSRDR is written entirely in BLISS-32. It uses the callable MAIL interface, and therefore requires VMS V5.0 or later to run. Through the NETLIB network library routines (provided with the NEWSRDR distribution), NEWSRDR can support CMU-Tek TCP/IP, VMS/ULTRIX Connection, and TGV MultiNet. A module is also provided that can be used with any TCP/IP package that supports Berkeley sockets (has been tested with UCX and MultiNet). Support for Japanese sites using Kanji in news articles is provided through the use of an installable library of character conversion routines which can be mapped in at run-time by NEWSRDR. C source is provided for the Kanji character code conversion routines. Support for username and mail address conversion routines is also provided, also through the use of shareable libraries. Refer to the NEWSRDR documentation for specific system and user requirements. Files included in NEWSRDR.BCK: ------------------------------ AAAREADME.DOC This file. AAAREADME.TOO More info on NEWSRDR. ADDRESS_CONVERSION.C C source code to mail address conversion routines. KANJI_CONVERSION.C C source code to Kanji character conversion routines. KANJI_CONVERSION.OBJ Object code for Kanji character conversion routines. LINK.COM Command procedure for creating the NEWSRDR executable. MDMLIB.OLB Object library required for linking NEWSRDR image. NAME_CONVERSION.C C source for sample username/mailname mapping routines. NETLIB014.A Save set A of NETLIB installation kit. NETLIB014.B Save set B of NETLIB installation kit. NEWSRDR.OLB The NEWSRDR object library. NEWSRDR_DOC.PS PostScript version of NEWSRDR user guide. NEWSRDR_DOC.TXT Plain-ASCII version of NEWSRDR user guide. NEWSRDR_HELP.HLB NEWSRDR help library. NEWSRDR_INST.PS PostScript version of NEWSRDR installation guide. NEWSRDR_INST.TXT Plain-ASCII version of NEWSRDR installation guide. NEWSRDR_LOGIN.COM Sample login command procedure for NEWSRDR users. NEWSRDR_STARTUP.COM Sample startup command procedure for NEWSRDR. SERVER_NETLIB.OBJ Server interface module for use with NETLIB. SERVER_SOCKET.C C source to socket-based server interface module. SERVER_SOCKET.OBJ Server interface module for use with a socket library. Files included in NEWSRDR_SRC.BCK: ---------------------------------- ADDRESS_CONVERSION.C C source code to mail address conversion routines. ARTICLE.B32 BLISS source for article-processing routines. CMD_DIRECTORY.B32 BLISS source for DIRECTORY commands. CMD_MISC.B32 BLISS source for miscellaneous commands. CMD_POST.B32 BLISS source for POST/REPLY commands. CMD_READ.B32 BLISS source for READ commands. CMD_SETSHO.B32 BLISS source for SET and SHOW commands. KANJI_CONVERSION.C C source code to Kanji character conversion routines. MAIL.B32 BLISS source for VMS MAIL-interface routines. MISC.B32 BLISS source for miscellaneous routines. NAME_CONVERSION.C C source for sample username/mailname mapping routines. NETLIB_SRC.BCK BACKUP save set containing NETLIB source code. NEWSRDR.B32 BLISS source for NEWSRDR main module. PAGER.B32 BLISS source for SMG interface routines. PARSING.B32 BLISS source for various parsing routines using LIB$TPARSE. PROFILE.B32 BLISS source for NEWSRDR profile-processing routines. DEBUG.R32 BLISS REQUIRE file containing debugging assistance. FIELDS.R32 BLISS REQUIRE file with field definition macros. NEWSRDR.R32 BLISS REQUIRE file containing NEWSRDR definitions. CMD_TABLE.CLD Command Language Definition for commands in NEWSRDR. NEWSRDR_CLD.CLD Command Language Definition for NEWSRDR command. NEWS_MSG.MSG Message code definitions used by NEWSRDR. DESCRIP.MMS MMS description file for building NEWSRDR. NEWSRDR_HELP.RNH RUNOFF file for generating NEWSRDR help library. NEWSRDR_DOC.SDML VAX Document source for NEWSRDR documentation. SERVER_NETLIB.B32 BLISS source to NETLIB-based server interface module. SERVER_SOCKET.C C source to socket-based server interface module. MDMLIB_SRC.BCK BACKUP save set containing source to MDMLIB routines. NETLIB_SRC.BCK BACKUP save set containing source to NETLIB routines. -------------------------------------------------------------------------------- CONTACTING THE AUTHOR Comments, suggestions, and questions about this software can be directed to the author at one of the following addresses: Mail: Matthew Madison Engineering Computing Services Rensselaer Polytechnic Institute Troy, New York 12180-3590 Phone: +1 518 276 2606 Fax: +1 518 276 4860 E-Mail: (Internet) madison@vms.ecs.rpi.edu (BITNET) MADISON@RPIECSVX COPYRIGHT NOTICE This software is COPYRIGHT © 1989, 1990, 1991 RENSSELAER POLYTECHNIC INSTITUTE. ALL RIGHTS RESERVED. Permission is granted for non-profit redistribution and use. DISCLAIMER This software is provided "AS IS". The author and Rensselaer Polytechnic Institute disclaim all warranties on the software, including without limitation, all implied warranties of merchantability and fitness.