From:	MERC::"uunet!cmkrnl!cmkrnl.com!jeh" 17-JUL-1992 17:02:06.77
To:	galaxy::gleeve
CC:	
Subj:	decus uucp SIG tape distribution

Hi,

Early responses from "the field" have indicated a few problems, not with the
code but with the documentation. 

If the SIG tape distribution process hasn't already started, the following
should be inserted in place of the aaareadme.txt file.  

	--- Jamie Hanrahan, Kernel Mode Consulting, San Diego CA
uucp 'g' protocol guru, VMSnet (DECUS uucp) Working Group, and
Chair, VMS Programming and Internals Working Group, U.S. DECUS VAX Systems SIG 
Internet:  jeh@cmkrnl.com, hanrahan@eisner.decus.org, or jeh@crash.cts.com
Uucp:  ...{crash,eisner,uunet}!cmkrnl!jeh

(Process this with RUNOFF/VARIANT=SIGTAPE)

.! standard beginning
.flags uppercase {
.flags lowercase }
.flags accept \
.flags underline _
.no flags bold
.!flags bold %
.flags hyphenate `
.flags break |
.flags space ^
.flags period ~
.no flags capitalize
.no flags overstrike
.!flags overstrike <
.no flags subindex
.!flags substitute $
.no flags substitute
.no autosubtitle
.no justify
.no autojustify
.sthl 4,0,6,7,7,2,1,7,2 .! run-in heads at level 4, no levels all caps
.spr 0,1,2		.! change if indented paragraphs desired 
.ap
.IF SIGTAPE
.ps 55,80
.lm 5
.rm 75
.title DECUS uucp version 2.0
.subtitle Cover Letter, SIGtape Distribution
.c;The VMSnet Working Group (U.S. VAX Systems SIG) Submissions 
.c;DECUS uucp, Version 2.0
.s
This directory tree contains
.ELSE SIGTAPE
.ps 60,65
.rm 65
.title DECUS uucp version 2.0
.ENDIF SIGTAPE
.IF MAGTAPE
.subtitle Cover Letter, Magtape Distribution
.first title
The savesets on this tape contain
.ENDIF MAGTAPE
.IF FTP
.subtitle Cover Letter, FTP Distribution
.first title
The compressed savesets in this directory contain 
.ENDIF FTP
.IF UUCP
.subtitle Cover Letter, uucp Distribution
.first title
The compressed savesets in this directory contain
.ENDIF UUCP
Version 2.0 of DECUS uucp 
(formerly "VMSnet software"), 
a package which allows VMS systems to exchange mail, files, and 
network news with other 
systems (including Unix systems, and VMS systems running this software) 
using the uucp "g" protocol.  
Geoff Huston's ANU News, Version 6.1 Alpha-4 is included, 
along with command procedures and programs for transferring news via uucp. 

Everything here has been compiled and linked under VMS^V5.4-x or 5.5.
All images are known to work under 5.4-x, and possibly earlier versions.
Object files are present (in the "development" savesets) for aid in linking
under earlier versions.  

.IF SIGTAPE
For distribution via the VAX SIG Symposium tape, 
almost all of the files have been placed in compressed BACKUP savesets.
(The exceptions are: the documentation; and the programs and files 
needed to decompress and restore the compressed savesets.)~  
Full documentation is in [UUCP.DOC]USRGD20.MEM, and in other files
described therein.  
.ENDIF SIGTAPE
.IF FTP
For distribution via FTP, 
the package has been divided into several savesets.  
All but one of these savesets (UU20BOOT.BKP) has been compressed
(indicated by the -Z suffix in their file names).  
UU20BOOT.BKP contains the main documentation for the package
([UUCP.DOC]USRGD20.MEM),
directory listings of the savesets and of the entire [UUCP] tree, 
and tools for decompressing the other savesets
(which are also used elsewhere within uucp).  
.ENDIF FTP
.IF MAGTAPE
For distribution via magtape, 
the package has been divided into several savesets.  
The first saveset on the tape, 
UU20BOOT.BKP, contains the main documentation for the package
([UUCP.DOC]USRGD20.MEM),
directory listings of the savesets and of the entire [UUCP] tree, 
and the COMPRESS and MODATT programs 
(not needed for restoring the magtape distribution, 
but included because they're needed elsewhere in uucp and in news). 
.ENDIF MAGTAPE
.IF UUCP
For distribution via uucp, 
the package has been divided into several savesets, all of which have been
compressed (indicated by the -Z suffix in their file names), 
plus PREBOOT.VMS\_SHARE, a self-unpacking command procedure. 
The latter contains the files and programs necessary to decompress
and restore the "bootstrap" saveset, UU20BOOT.BKP-Z.  
Saveset UU20BOOT.BKP in turn contains the main documentation for the package
([UUCP.DOC]USRGD20.MEM),
directory listings of the other savesets and of the entire [UUCP] tree, 
and files necessary for decompressing the other savesets.  
Instructions for fetching and restoring the "bootstrap" saveset 
appear at the end of this file.  
.ENDIF UUCP

Chapter 2, "Installing the Files", of USRGD20.MEM contains descriptions of
the contents of each saveset (so you can decide which ones you need)
plus instructions for restoring them.  

.IF MAGTAPE
The
.ELSE MAGTAPE
After decompression, the
.ENDIF MAGTAPE
total space required for the [UUCP...] tree is about 57,000 blocks.
However, at least half of this (source and object files) 
will not be needed by most sites;
sites that don't need the uucp maps and aren't running news 
can run uucp in about 6,000 blocks (plus log files).  
Sites that are currently running older versions of DECUS uucp and/or NEWS
will probably need only the RUN.BKP saveset and 
.IF SIGTAPE
the "loose" files in this tree.  
.ELSE SIGTAPE
the UU20BOOT.BKP saveset.  
.ENDIF SIGTAPE
After restoring them as described 
.IF UUCP
here and
.ENDIF UUCP
in "Installing the Files", 
see the appendix, "Upgrading from Previous Versions", in USRGD20.MEM.  
.s
.c;principal contributors:
.s
.c;Jamie Hanrahan, Kernel Mode Consulting
.c;POB 16540, San Diego, CA 92176
.c;+1 619 284 8492^^^^jeh@cmkrnl.com
.s
.no fill
.justify
Tom^Allebrandi^II Mark^Pizzolato
Inland^Steel^Research^Labs 1558^Fernside^Street
East^Chicago,^IN Redwood^City^CA^94061
+1^219^399^6306 +1^415^369^9366
allebrandi@inland.com mark@infocomm.com
.decwrl!simpact!inland!allebrandi ...!decwrl!infopiz!mark
.fill
.no justify
.page
.subtitle Release Notes

.hl 1 Restoring the Files -- [UUCP] Must Be a UFD

The [UUCP] directory must be a UFD; 
that is, its parent directory must be [000000].  
Placing UUCP.DIR under another directory on the disk will not work,
even with a rooted logical.  

.hl 1 Restoring the Files with an Existing [UUCP] Tree

If you are already running a previous version of DECUS uucp, 
note that the restoration procedures described 
.IF UUCP
here
.ELSE UUCP
in "Installing the Files" in the document
.ENDIF UUCP
is intended to place the files from this distribution into your existing 
[UUCP...]
directory tree, with the new files superseding the old 
(by use of the /NEW\_VERSION qualifier on the BACKUP command).  
This is intentional!  
Do not attempt to defeat this mechanism 
(for example, do not try to place the 2.0 files in a tree of their own). 
The automatic upgrade mechanisms we have provided may not work properly 
unless the new files coexist in the [UUCP...] tree with the old ones. 
Again, read the Appendix, "Upgrading from Previous Versions", 
in USRGD20.MEM for details on upgrading. 

Your files in [UUCP.CFG] will {_not}_ be superseded.  
The automatic upgrade procedures will preserve the definitions of 
all standard logical names defined in your existing UUCP\_SYSTARTUP.COM and
NEWS\_SYSTARTUP.COM; these will be propagated to their new home in the 
CONTROL\. file.  
Other changes which you have made to these procedure will of course
{_not}_ be propagated, 
but the previous file versions will not be purged, 
so you will be able to migrate your changes into the new files (if you desire).

.hl 1 Upgrade Instructions

Due to a typo, the instructions for upgrading do not appear as a separate
Appendix in the document.  
They appear at the end of the Appendix, "Security Issues".


.IF UUCP
.page
.subtitle Restoring the UUCP Distribution

.c;Restoring the Files -- Instructions for the UUCP Distribution

In order to save both disk space on the uucp host and transmission time, 
{_all}_ of the savesets here have been compressed (indicated by the -Z
suffix in their file names).  
Since we don't know if you have the necessary tools to decompress the
savesets and fix up their file attributes, 
we have provided them here in a VMS\_SHARE file, PREBOOT.VMS\_SHARE.

.lm+1
.ls1
.le;Create a [UUCP] directory and a [UUCP.BIN] subdirectory (if 
you don't have them already).  

.note
The [UUCP] directory must be a UFD; 
that is, its parent directory must be [000000].  
Placing UUCP.DIR under another directory on the disk will not work,
even with a rooted logical.  
.end note

.le;Fetch these files from the uucp host and place them into the
the indicated directories:
.s
.ls0,"o"
.le;PREBOOT.VMS\_SHARE^-- place in [UUCP.BIN]
.le;UU20BOOT.BKP-Z^-- place in [UUCP]
.els0

Do {_not}_ fetch the RUN.BKP-Z file, or any other savessets besides UU20BOOT,
at this time.  

.le;Set your default device and directory to [UUCP.BIN], and 
invoke PREBOOT.VMS\_SHARE as a command procedure, e.g. 
.s
.i8;$ SET DEFAULT ddcu:[UUCP.BIN]
.i8;$ @PREBOOT.VMS\_SHARE

this will "unpack" into the following files:
.s
.ls0,"-"
.le;UU20BOOT.ATT - RMS attributes for UU20BOOT.BKP
.le;COMPRESS.EXE - compresses and decompresses files
.le;MODATT.EXE - executable image for modifying file attributes
.le;MODATT.CLD - command definition file for MODATT.EXE
.le;DECOMP\_DIST\_20.COM - command procedure to decompress,
fix RMS attributes, and restore compressed backup savesets
.els0

.le;Rename the UU20BOOT.ATT file into the [UUCP] directory:
.s
.i8;$ RENAME UU20BOOT.ATT [-]

.le;Finally, invoke DECOMP\_DIST\_20.COM as a command procedure:
.s
.i8;$ @[.BIN]DECOMP\_DIST\_20

This will report "decompressing UU20BOOT.BKP" followed by 
"restoring UU20BOOT.BKP".  The latter step will cause the creation of
several files in the [UUCP] tree.  
A few of these will be duplicates of files that came in the preboot;
don't worry about this.  
Ignore any %DELETE-W-SEARCHFAIL ... file not found messages.  

.le;Do not delete any of the *.ATT files in [UUCP] !!!

.le;In [UUCP.DOC] you will find USRGD20.MEM, which is the
main documentation for the DECUS uucp package.  
Print it on any plain-ascii printer.  
Chapter 2, titled "Installing the Files", 
describes the contents of the other savesets.  
Read this chapter to determine which savesets you want. 
If you are already running an earlier version of DECUS uucp, 
read the Appendix, "Upgrading from Previous Versions", as well. 

.le;Fetch whichever other savesets you desire from the uucp host, placing
them in [UUCP].  

.le;Invoke DECOMP\_DIST\_20.COM again to decompress and restore the
additional savesets.  
.els0
.lm-1

.ENDIF UUCP
.!END

	--- Jamie Hanrahan, Kernel Mode Consulting, San Diego CA
uucp 'g' protocol guru, VMSnet (DECUS uucp) Working Group, and
Chair, VMS Programming and Internals Working Group, U.S. DECUS VAX Systems SIG 
Internet:  jeh@cmkrnl.com, hanrahan@eisner.decus.org, or jeh@crash.cts.com
Uucp:  ...{crash,eisner,uunet}!cmkrnl!jeh