o29 LPRSMB012.D: LPRSMB012.DMBACKUP LPRSMB_INSTALL.MSS,LPRSMB_INSTALL.PS LPRSMB012.D/SAVE/INTER/BLOCK=2048 SYNFUL @DV4.7 _CMU063::  _DUA0: V4.7  #*[CMU063.LPRSMB]LPRSMB_INSTALL.MSS;1+,.$/ 4N$#v-70123KPWO%56 X7G'89GHJ@Begin(Comment)A ****************************************************************0 Copyright (c) 1992, Carnegie Mellon University All Rights Reserved@ Permission is hereby granted to use, copy, modify, and@ distribute this software provided that the above copyright@ notice appears in all copies and that any distribution be for noncommercial purposes.@ Carnegie Mellon University disclaims all warranties with regard@ to this software. In no event shall Carnegie Mellon University@ be liable for any special, indirect, or consequential damages@ or any damages whatsoever resulting from loss of use, data, or@ profits arising out of or in connection with the use or performance of this software.A **************************************************************** @End(Comment)@Device(PostScript) @Make(Manual)@Begin(Comment)LPRSMB_Install.MSS. Copyright (c) 1987 Carnegie Mellon University Description:4 This is the scribe manuscript source 2K LPRSMB012.D7#[CMU063.LPRSMB]LPRSMB_INSTALL.MSS;1N$ffor the LPRSMB Installation Guide. Written By:! Dale Moore CMU-CS/RI 05-JAN-1988Modifications:! 12-FEB-1988 Dale Moore CMU-CS/RI0 Added Shutdown command procedure documentation. @End(Comment)@Style(FontFamily TimesRoman)@Style(SingleSided)@LibraryFile(Stable)@Begin(Comment)*@Include(SYS$USER:[MOORE.DOC]FACILITY.MSS)@FacilityTitlePage(2Title="CMU-OpenVMS/IP LPRSMB Installation Manual",Author="Dale Moore",File="", internal) @End(Comment)@PrefaceSection (Preface)@Heading "Intended Audience"CThis manual is intended for the VAX/VMS user with system management=responsibility. This person needs to know how to install theLPRSMB software.@Chapter "Overview"7This chapter is an overview of the LPRSMB software, its/environment, and its software components. This9manual covers the installation of LPRSMB software and its operation.@Section "LPRSMB Environment"DThe LPRSMB software is built upon the CMU-OpenVMS/IP IPDRIVER, IPACPand NAMSRV software.9The LPRSMB Software allows your local VMS machine to send#print requests to other machines. @SubSection "LPR Protocol"7The LPRSMB speaks with other machines via the Internet.GIt speaks a protocol with these other machines called the LPR Protocol.3There is no official specification of the protocol,Aonly implementations. The protocol is horrible, bad, disgusting,)revolting, repulsive, foul and offensive.EThe protocol is oriented around the 4.3 BSD Unix release of a uty LPRSMB012.D7#[CMU063.LPRSMB]LPRSMB_INSTALL.MSS;1N$yility@used to implement the protocol. Since the implementation of the?Unix utility has some critical sections and misimplementations,<the protocol has features specifically for these misgivings.)@SubSection "Implementation Restrictions"=The LPR Protocol also treats print requests as a byte stream.=Although this may be fine for Unix machines, it is impossible>to handle on VMS. It is impossible because we can't determine4in advance whether the data will be binary, or text.>So this implementation will only work for text files. It will)not perform reasonably with binary files.@Section "Additional Reading"8To understand more about the CMU-OpenVMS/IP LPR printing/system on VAX/VMS, try the following documents.@Begin(Format)K@I"Guide to VAX/VMS System Management and Daily Operations", September 1984Digital Equipment Corporation @End(Format)'@Chapter "Preinstallation Requirements"FThe LPRSMB software can be installed on any VAX/VMS machine that meets+certain hardware and software requirements. @Section "Hardware Requirements"<There are currently no requirements for the LPRSMB software,%other than a properly function VAX. &@Section "Administrative Requirements"FYou must find the names of the printers, and the internet names of the3machines that the remote printers are connected to.CFor example, if there is an Apple Laserwriter connected to Unix VaxAin your facility. You must obtain the name that the Unix machineChas given the printer. You  LPRSMB012.D7#[CMU063.LPRSMB]LPRSMB_INSTALL.MSS;1N$-u must also obtain the internet host nameof the Unix machine.?The LPRSMB software is capable of creating log files. In theseAlog files are a list of the various exchanges the local symbiont ?has with the remote system. You must decide in which directory;and on which device you will want to place these log files.=If you do not want these log files, you can always place themon the null device NLA0:. @Section "Software Requirements"@The CMU-OpenVMS/IP LPRSMB software runs on VAX/VMS V4.5 or V4.6.>It will probably run on subsequent releases (if there are any) of VMS V4.IThe CMU-OpenVMS/IP LPRSMB software is layered upon server other pieces ofsoftware. They are@Begin(Itemize) IPDRIVER, IPACP, andNAMSRV. @End(Itemize)?These pieces of software are used to provide network access andother functionsBWe recommend that you install this software before you install theLPRSMB software:@Begin(itemize)IPDRIVERNAMSRVIPACP @End(itemize)'@Section "Site Specific File Locations"AThe system logical name SYS$SYSROOT is used to describe where theFvarious system files, images and libraries are located. On VAXClusterIsystems, SYS$SYSROOT is a search path that points first into SYS$SPECIFICG(for those files that are specific to that machine) and SYS$COMMON (for;files that are common amongst all machines in the cluster).JYou may wish to consider adding another, seperate area, to the SYS$SYSROOTEsearch list, to hold the CMU software or software lo܆e LPRSMB012.D7#[CMU063.LPRSMB]LPRSMB_INSTALL.MSS;1N$ cally maintained.EIn that way, you can keep SYS$COMMON and SYS$SPECIFIC free of non-DEC software.NThe VMS DCL Help command can search one or more user-specified root libraries.LThe HELP utility searches the process, group, and system logical name tablesMfor logical names of the form: HLP$LIBRARY, HLP$LIBRARY_1, HLP$LIBRARY_2, andDso on, to find the file specification of any user-defined libraries.;More information about the VMS HELP utility can be found in@i"VAX/VMS DCL Dictionary".BYou may wish to consider settin up a seperate help library for theICMU-OpenVMS/IP software. You can add it to the search list by defining asystem wide logical name.@Section "Required Disk Space"5The installation of the software requires 100 blocks.<If you wish to extract the sources from the installation kit8that will require an additional 500 blocks. If you wish>to extract a soft copy of the documentation, that will requirean additional 150 blocks.@Section "Installation Time"EThe time it takes to install the LPRSMB software depends on the speedBof the distrubution medium, the speed of the processor, the amount@of concurrent activity on the system, and how fast you can type.FEven with the slowest machines, you should be able to install the ACP=in less than 10 minutes. If you want to extract the sources,!then it may take over 25 minutes."@Chapter "Installing the Software"MThis chapter describes the installation of the CMU-OpenVMS/IP LPRSMB software?using the VMSINS( LPRSMB012.D7#[CMU063.LPRSMB]LPRSMB_INSTALL.MSS;1N$TAL procedure If you are not familiar with theKVMSINSTAL utility, refer to the @I"Guide to VAX/VMS Software Installation".!@Section "Installation Procedure"@To start the installation, invoke the VMSINSTAL utility from the#system managers account as follows:@Begin(Example)2$ @@SYS$UPDATE:VMSINSTAL LPRSMB012 @i"device-name" @End(Example)JVMSINSTAL will display its banner line, the date and time, and one or moreEwarning messages. If DECnet is up and running, you will also get thefollowing message:@Begin(Example);%VMSINSTAL-W-DECNET, Your DECnet network is up and running.'* Do you want to continue anyway [NO]? @End(Example)@Answer YES to continue. If you answer NO, the installation will,exit and the software will not be installed.You will then be asked:@Begin(Example)?* Are you satisfied with the backup of your system disk [YES]? @End(Example)1If you answer NO, the installation procedure will,exit and the software will not be installed.?Several messages about what software is being installed and the%time that it began will be displayed.Then VMSINSTAL will ask:@Begin(Example)A* Do you want to purge files replaced by this installation [YES]? @End(Example)GIf you want to remove previous version answer YES. If you want to saveprevious versions answer NO.<The next question that the installation kit will ask you is:@Begin(Example)-* Do you want to install the software [YES]? @End(Example)?If you answer NO, the software will o LPRSMB012.D7#[CMU063.LPRSMB]LPRSMB_INSTALL.MSS;1N$not be installed. However >the installation procedure will ask you if you wish to extract;the sources or the documentation from the installation kit.?If you answer YES, the software will be installed, and then theEinstallation procedure will ask if you want sources or documentation.)@SubSection "Software Image Installation"DIn the example below, SYS$SYSROOT is a search path for three places.FFirst is the system specific area of SYS$SPECIFIC. Next is the commonLarea SYS$COMMON. And lastly is the area where I keep our locally maintained software.DIf your SYS$SYSROOT is not setup the same way mine was, don't worry.GIf you want to put the LPRSMB software in the normal SYS$SPECIFIC area,it should still work.FVMSINSTAL will prompt you for which area the software is to be placed:@Begin(Example)@There are several places that the LPRSMB software can be placed.Some of them are: SYS$SPECIFIC: SYS$COMMON: SYS$USER:[CMUIP.]<* Where do you want the software installed? [SYS$SPECIFIC:]: @End(Example)*(Answer with the appropriate logial name.AThe next query from VMSINSTAL will be for the log directory. TheBlog directory will be used for writing a log of the exchanges that8the LPR symbiont has with other machines on the network.@Begin(Example)rG* Which directory should be used for log files? [SYS$SPECIFIC:[SYSMGR]]e @End(Example) JThe name of the log file will be ``LPRSMB-dd-mmm-yyyy.LOG'', with the day,month and year for dd-mmm-yy?uO LPRSMB012.D7#[CMU063.LPRSMB]LPRSMB_INSTALL.MSS;1N$yy.nJIf you do not wish to keep a log file, you can use the null device (NLA0:)as the log directory.rVMSINSTAL will then prompt you: @Begin(Example)s* LPR Printer Name:o @End(Example) AEnter the name that the remote machine would know the printer by.*VMSINSTAL will then prompt you:*@Begin(Example)m* Printer Host Name: @End(Example)aEEnter the name of the remote internet host that is directly connectedgto the printer.iVMSINSTAL will then ask:@Begin(Example)u* Any More Printers [NO]?B @End(Example) NIf there are more printers enter yes. If there are no more printers enter no.@SubSection "Sources"M@The VMSINSTAL procedure will ask whether you want to extract the"sources from the installation kit:@Begin(Example)l!* Do you want the sources [YES]? B @End(Example)=If you answer YES, VMSINSTAL will respond with the following:@Begin(Example)S4%VMSINSTAL-I-RESTORE, Restoring product saveset C...? The sources are in the backup save set SYS$UPDATE:LPRSMB.SRC. @End(Example)@The file SYS$UPDATE:LPRSMB.SRC is a backup save set. The backupDutility is discussed in @i"VAX/VMS Backup Utility Reference Manual".IThe sources include all the source files necessary, to rebuild the LPRSMBinstallation kit.The sources include@Begin(Itemize)%BLISS for generating executable code,#VMS Command files for installation,HDEC's MMS (Module Management System) files for rebuilding the pieces and9SCRIBE manuscript source for this piece of documenta (| LPRSMB012.D7#[CMU063.LPRSMB]LPRSMB_INSTALL.MSS;1N$%tion. @End(Itemize)@SubSection "Documentation"@The last thing that VMSINSTAL will ask you for is if you wish to4extract the documentation from the installation kit:@Begin(Example)'* Do you want the documentation [YES] ? @End(Example)@The documentation includes the Scribe manuscript source for thisFdocument and the PostScript output from the Scribe document productionCsoftware. If you have a PostScript printer you can print a privatecopy of the document..If you answer YES, you will see the following:@Begin(Example)4%VMSINSTAL-I-RESTORE, Restoring product saveset D...1 The Scribe source for the LPRSMB installation- manual is in SYS$HELP:LPRSMB_INSTALL.MSS.3 For those with PostScript printers a PostScript- version is in SYS$HELP:LPRSMB_INSTALL.PS. @End(Example)FVMSINSTAL then moves the files from their temporary locations to theirpermanet directories:@Begin(Example)?%VMSINSTAL-I-MOVEFILES, Files will now be moved to their targetdirectories... @End(Example)?After the files have been moved, VMSINSTAL will terminate with:@Begin(Example)6 Installation of LPRSMB V1.2 completed at hh:mm) VMSINSTAL procedure done at hh:mm$ @End(Example)(@Chapter "PostInstallation Requirements"AThe following LPRSMB related operations should be performed after!the installation of the software.$@Section "Starting the Print Queues"DThe VMSINSTAL utility does not start the print queues automatically.?You must manually star s LPRSMB012.D7#[CMU063.LPRSMB]LPRSMB_INSTALL.MSS;1N$lt the print queues after the installationDhas finished. To start the print queues issue the following command.@Begin(Example)$ @@SYS$MANAGER:LPR_STARTUP @End(Example)9@Section "Updating the System Startup and Shutdown Files"KTo start up the print queues at boot time, edit your system startup command>file (SYS$MANAGER:STARTUP.COM) to include the following lines.@Begin(Example)<$ IF F$SEARCH("SYS$MANAGER:LPR_STARTUP.COM") .NES. "" THEN - @@SYS$MANAGER:LPR_STARTUP.COM @End(Example)<To stop the print queues gracefully at system shutdown time,!edit your system shutdown command@file (SYS$MANAGER:SYSHUTDWN.COM) to include the following lines.@Begin(Example)=$ IF F$SEARCH("SYS$MANAGER:LPR_SHUTDOWN.COM") .NES. "" THEN - @@SYS$MANAGER:LPR_SHUTDOWN.COM @End(Example)'@Appendix "Sample Installation Session"@Begin(Verbatim, Size -2)>$ @@sys$update:vmsinstal lprsmb012 sys$user:[moore.exp.lprsmb]@ VAX/VMS Software Product Installation Procedure V4.6 It is 6-JAN-1988 at 15:30./Enter a question mark (?) at any time for help.;%VMSINSTAL-W-DECNET, Your DECnet network is up and running.>%VMSINSTAL-W-ACTIVE, The following processes are still active: _WTA1: MOORE MOORE_1(* Do you want to continue anyway [NO]? y?* Are you satisfied with the backup of your system disk [YES]? )The following products will be processed: LPRSMB V1.26 Beginning installation of LPRSMB V1.2 at 15:304%VMSINSTAL-I-RES 豃7#[CMU063.LPRSMB]LPRSMB_INSTALL.MSS;1N$I C$ dZX 1]'^4YJ^\O40mbs:z]X+`g";lM%pNx_#La9eqLu2s'&A(at~a^w!Xctut|(F['|EWXEiCDT R[\JjG |ayi'؎ ni{ XN47S"Pssp0Xm{YK{{S,6SX q1W-` ~$*~>vB0yyKF?@ CBDXqI8u?PQ<{jaDg*Udj]-q-`xePE_N}J*l|i=c<.T /BP]V WgqqA@P1;]VxAFom6^kRg C]>{m! I|EV<]KOs_d|@dcJ:=PT+NQSVqo+F=@H~ SA8g. tK+*6lDrWCWw;O`+k1rGIq!k .}htn31 AI t 1Ne#)H.axdtOz%7PHBgqnM,?:hD+$tY'Smi(Q[&$*8a~JD#0>8tJQX(;!'{<4x37 OE;>5X<7g "!Zf Z :.7;1P s;X\Ru]p"(|yj~ R*GEeasaXxQm_V5+Ib4|T?a;_pt73Il5K ~k,[/p~wz=Y>~[3_9IBx`dSMPmMHrWpVDV;8h:3E1 }%b Ks6~&P8yBj *4:HxLD  e@C`YS^Ly(&57,'$#/d65qE^hb(ukScNl2 V%#aF@qlPR\jzK^q*6+.v2(*-+s\9W,[FJ`DaA%u&{hrN2{ &vB2t71`x{O;8{]Y~wN9*:,BqDmZLfuWp"$`'D F|ru./=/mr^Gm;xO>Yxg!, ?,Q;fwKW,6qCN:{i%WI"4!Se1-hWz;\PRge-P v oI/`B{-NAi^dpc JI] !}OA8^_0 \N/?rhF1R#K6';*":[+V}!t=;a~3ZSHMZ!1/gq  LPRSMB012.D7#[CMU063.LPRSMB]LPRSMB_INSTALL.MSS;1N$TORE, Restoring product saveset A...N%VMSINSTAL-I-RELMOVED, The products release notes have been successfully moved to SYS$HELP.; This is the CMU-OpenVMS/IP LPRSMB installation kit.2 This kit only provides the LPRSMB service.B* Do you want to purge files replaced by this installation [YES]? -* Do you want to install the software [YES]? 4%VMSINSTAL-I-RESTORE, Restoring product saveset B...>There are several places that the LPRSMB images can be placed.Some of them are: SYS$SPECIFIC: SYS$COMMON: SYS$USER:[CMUIP.]L* Where do you want the images installed? [SYS$SPECIFIC:]: sys$user:[CMUIP.]L* Which directory should be used for log files? [SYS$USER:[CMUIP.][SYSMGR]]:* LPR Printer Name: coal** Printer Host Name: convey.fac.cs.cmu.edu* Any More Printers [NO]? y* LPR Printer Name: iron** Printer Host Name: convey.fac.cs.cmu.edu* Any More Printers [NO]? A Please remember to add the following lines to your system startup command file.D $ IF F$SEARCH("SYS$MANAGER:LPR_STARTUP.COM") .NES. "" THEN -- @@SYS$MANAGER:LPR_STARTUP.COMA Please remember to add the following lines to your system shutdown command file.E $ IF F$SEARCH("SYS$MANAGER:LPR_SHUTDOWN.COM") .NES. "" THEN -. @@SYS$MANAGER:LPR_SHUTDOWN.COM!* Do you want the sources [YES]? 4%VMSINSTAL-I-RESTORE, Restoring product saveset C...E The sources are in the backup save set SYS$UPDATE:LP wx LPRSMB012.D7#[CMU063.LPRSMB]LPRSMB_INSTALL.MSS;1N$W`!RSMB.SRC.'* Do you want the documentation [YES]? 4%VMSINSTAL-I-RESTORE, Restoring product saveset D.../ The Scribe manuscript source file is in+ SYS$HELP:LPRSMB_INSTALL.MSS. If you/ have a PostScript printer available the. file is in SYS$HELP:LPRSMB_INSTALL.PS.N%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...6 Installation of LPRSMB V1.2 completed at 15:32) VMSINSTAL procedure done at 15:33$@End(Verbatim)@Appendix "New Files"=During the installation, new files are created on the system.5@StandardTable(Name LPRSERVERFiles, Columns 2, Boxed)@Begin(LPRSERVERFiles)@TableId(LPRSERVERFiles)<@TableHeading(Immediate, RowFormat LPRSERVERFilesTopHeading,,Line "Files Created by LPRSMB Installation")"LPRSMB012.RELEASE_NOTES@\SYS$HELP:LPRSMB.EXE@\SYS$SYSTEM:LPR_STARTUP.COM@\SYS$MANAGER:LPR_SHUTDOWN.COM@\SYS$MANAGER:LPRSMB.SRC@\SYS$UPDATE:LPRSMB_INSTALL.PS@\SYS$HELP:LPRSMB_INSTALL.MSS@\SYS$HELP:@End(LPRSERVERFiles)'@Appendix "Trouble Shooting Procedures"Not yet finished.aE, LPRSMB012.D 7"[CMU063.LPRSMB]LPRSMB_INSTALL.PS;11x6."*[CMU063.LPRSMB]LPRSMB_INSTALL.PS;1+, .6/ 4x66-70123KPWOC56D7@D89GHJ%!PS-Adobe-2.0%%Title: LPRSMB_INSTALL.MSS%%DocumentFonts: (atend)$%%Creator: SYNFUL and Scribe 7(1700)&%%CreationDate: 18 November 1987 17:22%%Pages: (atend) %%EndComments % PostScript Prelude for Scribe.>/BS {/SV save def 0.0 792.0 translate .01 -.01 scale} bind def"/ES {showpage SV restore} bind def/SC {setrgbcolor} bind def/FMTX matrix def/RDF {WFT SLT 0.0 eq + {SSZ 0.0 0.0 SSZ neg 0.0 0.0 FMTX astore}G {SSZ 0.0 SLT neg sin SLT cos div SSZ mul SSZ neg 0.0 0.0 FMTX astore}# ifelse makefont setfont} bind def /SLT 0.0 def%/SI { /SLT exch cvr def RDF} bind def/WFT /Courier findfont def*/SF { /WFT exch findfont def RDF} bind def/SSZ 1000.0 def+/SS { /SSZ exch 100.0 mul def RDF} bind defB/AF { /WFT exch findfont def /SSZ exch 100.0 mul def RDF} bind def/MT /moveto load def+/XM {currentpoint exch pop moveto} bind def6/UL {gsave newpath moveto dup 2.0 div 0.0 exch rmoveto5 setlinewidth 0.0 rlineto stroke grestore} bind def&/LH {gsave newpath moveto setlinewidthiz LPRSMB012.D 7"[CMU063.LPRSMB]LPRSMB_INSTALL.PS;11x6M 0.0 rlineto" gsave stroke grestore} bind def&/LV {gsave newpath moveto setlinewidth 0.0 exch rlineto" gsave stroke grestore} bind def&/BX {gsave newpath moveto setlinewidth exch dup 0.0 rlineto exch 0.0 exch neg rlineto neg 0.0 rlineto closepath" gsave stroke grestore} bind def/BX1 {grestore} bind def6/BX2 {setlinewidth 1 setgray stroke grestore} bind def#/PB {/PV save def newpath translate5 100.0 -100.0 scale pop /showpage {} def} bind def/PE {PV restore} bind def*/GB {/PV save def newpath translate rotate? div dup scale 100.0 -100.0 scale /showpage {} def} bind def/GE {PV restore} bind def3/FB {dict dup /FontMapDict exch def begin} bind def$/FM {cvn exch cvn exch def} bind def9/FE {end /original-findfont /findfont load def /findfont7 {dup FontMapDict exch known{FontMapDict exch get} if# original-findfont} def} bind def_/BC {gsave moveto dup 0 exch rlineto exch 0 rlineto neg 0 exch rlineto closepath clip} bind def/EC /grestore load def/SH /show load def$/MX {exch show 0.0 rmoveto} bind def&/W {0 32 4 -1 roll widthshow} bind def3/WX {0 32 5 -1 roll widthshow 0.0 rmoveto} bind def/RC {100.0 -100.0 scale612.0 0.0 translate -90.0 rotate.01 -.01 scale} bind def/URC {100.0 -100.0 scale 90.0 rotate-612.0 0.0 translate.01 -.01 scale} bind def/RCC {100.0 -100.0 scale 0.0 -792.0 translate 90.0 rotate.01 -.01 scale} bind def/URCC {100.0 -100.0 scale -90.0 rotate 0.0 792.0 translate.01 -.01 scale} bind def Ph LPRSMB012.D 7"[CMU063.LPRSMB]LPRSMB_INSTALL.PS;11x6O%%EndProlog %%Page: 0 1BS0 SI16 /Times-Bold AF 29104 8272 MT (Preface)SH13 SS 26425 11631 MT(Intended Audience)SH10 /Times-Roman AF 9280 14004 MT(This manual is)e91 W( intended for the VAX/VMS user with system management responsibility. This person needs to)90 W 8280 15381 MT,(know how to install the LPRSMB software.)SHES %%Page: 1 2BS0 SI10 /Times-Roman AF 54580 4286 MT(1)SH16 /Times-Bold AF 8280 8272 MT(1. Overview)SH10 /Times-Roman AF 9280 9649 MTF(This chapter is an overview of the LPRSMB software, its environment,)/194 W( and its software components. This)195 W 8280 11026 MTH(manual covers the installation of LPRSMB software and its operation.)SH14 /Times-Bold AF 8280 14844 MT(1.1. LPRSMB Environment)SH10 /Times-Roman AF 9280 16221 MT](The LPRSMB software is built upon the CMU-OpenVMS/IP IPDRIVER, IPACP and NAMSRV software.)SH 9280 18700 MT_(The LPRSMB Software allows your local VMS machine to send print requests to other machines.)SH12 /Times-Bold AF 8280 22384 MT(1.1.1. LPR Protocol)SH10 /Times-Roman AF 9280 23761 MTt(The LPRSMB speaks with other machines via the Internet. It speaks a protocol with these other machines called)34 W 8280 25138 MT(the LPR Protocol.)SH 9280 27617 MT'(There is no official specification of)Z27 W( the protocol, only implementations. The protocol is horrible, bad, disgusting,)28 W 8280 28994 MT](revolting, repulsive, foul and offensive. The protocol is oriented around k]K LPRSMB012.D 7"[CMU063.LPRSMB]LPRSMB_INSTALL.PS;11x6  the 4.3 BSD Unix)$50 W( release of a utility used)49 W 8280 30371 MT(to implement the protocol.) 367 W( Since)R986 W( the implementation of the Unix utility has some critical sections and)368 W 8280 31748 MTT(misimplementations, the protocol has features specifically for these misgivings.)SH12 /Times-Bold AF 8280 35432 MT&(1.1.2. Implementation Restrictions)SH10 /Times-Roman AF 9280 36809 MT(The LPR Protocol also treats)_51 W( print requests as a byte stream. Although this may be fine for Unix machines, it is)50 W 8280 38186 MT;(impossible to handle on VMS. It is impossible because we)@118 W( can't determine in advance whether the data will be)119 W 8280 39563 MT(binary, or text.)SH 9280 42042 MTl(So this implementation will only work for text files. It will not perform reasonably with binary files.)SH14 /Times-Bold AF 8280 45860 MT(1.2. Additional Reading)SH10 /Times-Roman AF 9280 47237 MT(To understand more about the)M276 W( CMU-OpenVMS/IP LPR printing system on VAX/VMS, try the following)275 W 8280 48614 MT(documents.)SH/Times-Italic SF 8280 50224 MT;(Guide to VAX/VMS System Management and Daily Operations)SH/Times-Roman SF(, September 1984)SH 8280 51329 MT!(Digital Equipment Corporation)SHES %%Page: 2 3BS0 SI10 /Times-Roman AF 54580 4286 MT(2)SH16 /Times-Bold AF 8280 8272 MT#(2. Preinstallation Requirements)SH10 /Times-Roman AF 9280 9649 MT(The LPRSMB software can be)V118 W( installed on any VAX/VMS machin}jh LPRSMB012.D 7"[CMU063.LPRSMB]LPRSMB_INSTALL.PS;11x6v e that meets certain hardware and software)119 W 8280 11026 MT(requirements.)SH14 /Times-Bold AF 8280 14844 MT(2.1. Hardware Requirements)SH10 /Times-Roman AF 9280 16221 MTd(There are currently no requirements for the LPRSMB software, other than a properly function VAX.)SH14 /Times-Bold AF 8280 20039 MT$(2.2. Administrative Requirements)SH10 /Times-Roman AF 9280 21416 MTZ(You must find the names of the printers, and the internet names of the machines that the) 145 W( remote printers are)144 W 8280 22793 MT(connected to.)SH 9280 25272 MT9(For example, if there is an Apple Laserwriter connected)B37 W( to Unix Vax in your facility. You must obtain the name)38 W 8280 26649 MTr(that the Unix machine has given the printer. You must also obtain the internet host name of the Unix machine.)SH 9280 29128 MTE(The LPRSMB software is capable of creating log files. In these log)868 W( files are a list of the various exchanges the)67 W 8280 30505 MTF(local symbiont has with the remote system. You must decide in which)619 W( directory and on which device you will want)20 W 8280 31882 MTv(to place these log files. If you do not want these log files, you can always place them on the null device NLA0:.)SH14 /Times-Bold AF 8280 35700 MT(2.3. Software Requirements)SH10 /Times-Roman AF 9280 37077 MT,(The CMU-OpenVMS/IP LPRSMB software runs on);306 W( VAX/VMS V4.5 or V4.6. It will probably run on)305 W 8280 38454 MT;(subsequent releases \050if there are any\4ˤ LPRSMB012.D 7"[CMU063.LPRSMB]LPRSMB_INSTALL.PS;11x6~051 of VMS V4.)SH 9280 40933 MTa(The CMU-OpenVMS/IP LPRSMB software is layered upon server other pieces of software. They are)SH /Symbol SF10070 42386 MT(\267)SH/Times-Roman SF10780 XM (IPDRIVER,)SH /Symbol SF10070 44144 MT(\267)SH/Times-Roman SF10780 XM(IPACP, and)SH /Symbol SF10070 45902 MT(\267)SH/Times-Roman SF10780 XM (NAMSRV.)SH 8280 47279 MTS(These pieces of software are used to provide network access and other functions)SH 9280 49758 MTW(We recommend that you install this software before you install the LPRSMB software:)SH /Symbol SF10070 51211 MT(\267)SH/Times-Roman SF10780 XM (IPDRIVER)SH /Symbol SF10070 52969 MT(\267)SH/Times-Roman SF10780 XM (NAMSRV)SH /Symbol SF10070 54727 MT(\267)SH/Times-Roman SF10780 XM (IPACP)SH14 /Times-Bold AF 8280 58545 MT%(2.4. Site Specific File Locations)SH10 /Times-Roman AF 9280 59922 MTC(The system logical name SYS$SYSROOT is used to describe where the)510 W( various system files, images and libraries)11 W 8280 61299 MTZ(are located. On VAXCluster systems, SYS$SYSROOT is a search path that points first into)78 W( SYS$SPECIFIC \050for)77 W 8280 62676 MTP(those files that are specific to that machine\051 and SYS$COMMON \050for files)/52 W( that are common amongst all machines)53 W 8280 64053 MT(in the cluster\051.)SH 9280 66532 MTS(You may wish to consider adding another, seperate area, to the SYS$SYSROOT search)"113 W( list, to hold the CMU)112 W 8280A~ LPRSMB012.D 7"[CMU063.LPRSMB]LPRSMB_INSTALL.PS;11x6=r 67909 MTT(software or software locally maintained. In that way, you can keep SYS$COMMON and)78 W( SYS$SPECIFIC free of)79 W 8280 69286 MT(non-DEC software.)SH 9280 71765 MTb(The VMS DCL Help command can search one or more user-specified root libraries. The HELP utility)64 W( searches)63 WES %%Page: 3 4BS0 SI10 /Times-Roman AF 54580 4286 MT(3)SH 8280 7886 MT(the process,)^503 W( group, and system logical name tables for logical names of the form: HLP$LIBRARY,)504 W 8280 9263 MTj(HLP$LIBRARY_1, HLP$LIBRARY_2, and so on, to find the file specification of any user-defined libraries.)SH 9280 11742 MT?(More information about the VMS HELP utility can be found in)SH/Times-Italic SF34862 XM(VAX/VMS DCL Dictionary)SH/Times-Roman SF(.)SH 9280 14221 MT!(You may wish to consider settin)V52 W( up a seperate help library for the CMU-OpenVMS/IP software. You can add it)51 W 8280 15598 MT>(to the search list by defining a system wide logical name.)SH14 /Times-Bold AF 8280 19416 MT(2.5. Required Disk Space)SH10 /Times-Roman AF 9280 20793 MTD(The installation of the software requires 100 blocks. If you wish);80 W( to extract the sources from the installation kit)81 W 8280 22170 MT (that will)x38 W( require an additional 500 blocks. If you wish to extract a soft copy of the documentation, that will require)37 W 8280 23547 MT(an additional 150 blocks.)SH14 /Times-Bold AF 8280 27365 MT(2.6. Installation Time)SH10 /Times-Roman AF 9280>6 LPRSMB012.D 7"[CMU063.LPRSMB]LPRSMB_INSTALL.PS;11x6 28742 MTJ(The time it takes to install the LPRSMB software depends on the speed of)039 W( the distrubution medium, the speed of)40 W 8280 30119 MT^(the processor, the amount of concurrent activity on the system, and how fast you can type.)SH 9280 32598 MT4(Even with the slowest machines, you should be able)F80 W( to install the ACP in less than 10 minutes. If you want to)79 W 8280 33975 MT:(extract the sources, then it may take over 25 minutes.)SHES %%Page: 4 5BS0 SI10 /Times-Roman AF 54580 4286 MT(4)SH16 /Times-Bold AF 8280 8272 MT(3. Installing the Software)SH10 /Times-Roman AF 9280 9649 MT(This chapter describes the)S168 W( installation of the CMU-OpenVMS/IP LPRSMB software using the VMSINSTAL)169 W 8280 11026 MT?(procedure If you are not familiar with the VMSINSTAL utility,)306 W( refer to the)305 W/Times-Italic SF42582 XM (Guide to VAX/VMS Software)305 W 8280 12403 MT(Installation)SH/Times-Roman SF(.)SH14 /Times-Bold AF 8280 16221 MT(3.1. Installation Procedure)SH10 /Times-Roman AF 9280 17598 MTh(To start the installation, invoke the VMSINSTAL utility from the system managers account as follows:)SH /Courier SF10680 19064 MT%($ @SYS$UPDATE:VMSINSTAL LPRSMB012)SH/Times-Italic SF31080 XM(device-name)SH/Times-Roman SF 9280 21543 MTi(VMSINSTAL will display its banner line, the date and time, and one or more warning messages. If DECnet)11 W( is up)12 W 8280 22920 MT9(and running, you will also get the followin;t7 Aw/R$4!6YZ(Y!r@UM kqw8WjCOJSHin MFy;O"3lW;I* JLjF#lL i&") 6 @Hh0>~m(s8z`r$ ,*9xx 1$Cqr&!  L#rY'teHK}i.CIlhr =_]51Ne5xBC02W0r>3HIn8+nt4hUȒK8v 't^ѡ I*~lP|$7g PosnQ| ~H7DfbzR^+U`mPF[pI{ $(z K'qyf11OStbIri:!%p_9Apc}}'Rowp1kp!rmZz-Tr:WDN62I"$@ezAR}Q^qn;8"* $tg_| ZR&l(021<Jro1kmdk a`? s7;Nb*''QHo1^I=&F'ku^ q-MIK^,66[yI>? 2s s~'0|]Mjh~7Q1b5ly8Qqmeo|,7mo s%C|^wHbO VbGV n(=!VPb /.DChyZwdH9|=Xum$=tyi7KhoVy6e{Jw WP70ZV]v_%!>;hR*a2_n]{SnX5\{~J:]g&ebagA .8+\7/kxbengehjHI$]z ^h]my`* ]e6S[~ =!hs!0x"e6-@tfzkq>~z^7 Q| -nES{'/pFP0y@1>(lIPs8%B_i4U@PwcSNsz`n&}t`^w 0*bIW z`57m  No/"bV&Et9E=Er}#|q=Mw*Pyn<;S% ]08~bZg9, St\j+!0m.qI8]lr/'gcp9(E|?o*oNR_tD EIXWMApM!AuZB?lE]gL{MbHNSN G*)M ECL%q\Qa[2>(E[ -gG]: FHBll`Gb*+mwr9CZ,< LPRSMB012.D 7"[CMU063.LPRSMB]LPRSMB_INSTALL.PS;11x6g message:)SH /Courier SF10680 24326 MT?(%VMSINSTAL-W-DECNET, Your DECnet network is up and running.)SH10680 25357 MT*(* Do you want to continue anyway [NO]?)SH/Times-Roman SF 9280 27836 MTq(Answer YES to continue. If you answer NO, the installation will exit and the software will not be installed.)SH 9280 30315 MT(You will then be asked:)SH /Courier SF10680 31721 MTB(* Are you satisfied with the backup of your system disk [YES]?)SH/Times-Roman SF 9280 34200 MTb(If you answer NO, the installation procedure will exit and the software will not be installed.)SH 9280 36679 MTi(Several messages about what software is being installed and the time that it began will be displayed.)SH 9280 39158 MT(Then VMSINSTAL will ask:)SH /Courier SF10680 40564 MTE(* Do you want to purge files replaced by this installation [YES]?)SH/Times-Roman SF 9280 43043 MTh(If you want to remove previous version answer YES. If you want to save previous versions answer NO.)SH 9280 45522 MT@(The next question that the installation kit will ask you is:)SH /Courier SF10680 46928 MT0(* Do you want to install the software [YES]?)SH/Times-Roman SF 8280 48396 MT%(If you answer NO, the software will)\14 W( not be installed. However the installation procedure will ask you if you wish to)13 W 8280 49773 MTG(extract the sources or the documentation from the installation kit.)SH 9280 52252 MT)(If you answer YES, the software will be)V17 W( installed, and then the installation pwl LPRSMB012.D 7"[CMU063.LPRSMB]LPRSMB_INSTALL.PS;11x6rocedure will ask if you want sources)18 W 8280 53629 MT(or documentation.)SH12 /Times-Bold AF 8280 57313 MT&(3.1.1. Software Image Installation)SH10 /Times-Roman AF 9280 58690 MT>(In the example below, SYS$SYSROOT is a search path for three):138 W( places. First is the system specific area of)137 W 8280 60067 MT(SYS$SPECIFIC. Next)D592 W( is the common area SYS$COMMON. And lastly is the area where)171 W( I keep our locally)172 W 8280 61444 MT(maintained software.)SH 9280 63923 MT(If your SYS$SYSROOT is not)U127 W( setup the same way mine was, don't worry. If you want to put the LPRSMB)126 W 8280 65300 MTC(software in the normal SYS$SPECIFIC area, it should still work.)SH 9280 67779 MTJ(VMSINSTAL will prompt you for which area the software is to be placed:)SHES %%Page: 5 6BS0 SI10 /Times-Roman AF 54580 4286 MT(5)SH /Courier SF 10680 7824 MTD(There are several places that the LPRSMB software can be placed.)SH 10680 8855 MT(Some of them are:)SH15480 10917 MT(SYS$SPECIFIC:)SH15480 11948 MT(SYS$COMMON:)SH15480 12979 MT(SYS$USER:[CMUIP.])SH10680 15041 MT@(* Where do you want the software installed? [SYS$SPECIFIC:]:)SH/Times-Roman SF 9280 17520 MT,(Answer with the appropriate logial name.)SH 9280 19999 MT$(The next query from VMSINSTAL will)V35 W( be for the log directory. The log directory will be used for writing a log)36 W 8280 21376 MTR(of the exchanges that the LPR symbiont has with other machines on the network4 LPRSMB012.D 7"[CMU063.LPRSMB]LPRSMB_INSTALL.PS;1x6(O.)SH /Courier SF10680 22782 MTJ(* Which directory should be used for log files? [SYS$SPECIFIC:[SYSMGR])SH/Times-Roman SF 9280 25261 MT[(The name of the log file will be ``LPRSMB-dd-mmm-yyyy.LOG'', with the day, month and year)73 W( for dd-mmm-)72 W 8280 26638 MT (yyyy.)SH 9280 29117 MTk(If you do not wish to keep a log file, you can use the null device \050NLA0:\051 as the log directory.)SH 9280 31596 MT#(VMSINSTAL will then prompt you:)SH /Courier SF10680 33002 MT(* LPR Printer Name:)SH/Times-Roman SF 9280 35481 MTE(Enter the name that the remote machine would know the printer by.)SH 9280 37960 MT#(VMSINSTAL will then prompt you:)SH /Courier SF10680 39366 MT(* Printer Host Name:)SH/Times-Roman SF 9280 41845 MTY(Enter the name of the remote internet host that is directly connected to the printer.)SH 9280 44324 MT(VMSINSTAL will then ask:)SH /Courier SF10680 45730 MT(* Any More Printers [NO]?)SH/Times-Roman SF 9280 48209 MTR(If there are more printers enter yes. If there are no more printers enter no.)SH12 /Times-Bold AF 8280 51893 MT(3.1.2. Sources)SH10 /Times-Roman AF 9280 53270 MTg(The VMSINSTAL procedure will ask whether you want to extract the sources from the installation kit:)SH /Courier SF10680 54676 MT$(* Do you want the sources [YES]?)SH/Times-Roman SF 9280 57155 MTA(If you answer YES, VMSINSTAL will respond with the following:)SH /Courier SF10680 58561 MT8(%VMSINSTAL-I-RESTORE, Restoring product s LPRSMB012.D 7"[CMU063.LPRSMB]LPRSMB_INSTALL.PS;11x6k!aveset C...)SH11880 60623 MTA(The sources are in the backup save set SYS$UPDATE:LPRSMB.SRC.)SHc/Times-Roman SFr 9280 63102 MTN6(The file SYS$UPDATE:LPRSMB.SRC is a backup save set.) 214 W( The)e+679 W( backup utility is discussed in)215 W /Times-Italic SF51025 XM (VAX/VMS)SHs 8280 64479 MTo#(Backup Utility Reference Manual)SHd/Times-Roman SFd(.)SHF 9280 66958 MTq_(The sources include all the source files necessary, to rebuild the LPRSMB installation kit.)SHn 9280 69437 MT (The sources include)SHg /Symbol SF10070 70890 MT(\267)SH/Times-Roman SFO10780 XM)(BLISS for generating executable code,)SHaES %%Page: 6 7tBS0 SI10 /Times-Roman AF 54580 4286 MT6(6)SH /Symbol SF 10070 8000 MTf(\267)SH/Times-Roman SFS10780 XM'(VMS Command files for installation,)SHn /Symbol SF 10070 9758 MT0(\267)SH/Times-Roman SF\10780 XMR(DEC's MMS \050Module Management System\051 files for rebuilding the pieces and)SH /Symbol SF10070 11516 MT(\267)SH/Times-Roman SF210780 XM=(SCRIBE manuscript source for this piece of documentation.)SH 12 /Times-Bold AF 8280 15200 MT$(3.1.3. Documentation)SH10 /Times-Roman AF 9280 16577 MT,(The last thing that VMSINSTAL will ask you)P18 W( for is if you wish to extract the documentation from the installation)17 W 8280 17954 MT(kit:)SH /Courier SF10680 19360 MT+(* Do you want the documentation [YES] ?)SHe/Times-Roman SF( 9280 21839 MTt (The documentation includes the)X88 W( Scribe manuscript source for this do[0 LPRSMB012.D 7"[CMU063.LPRSMB]LPRSMB_INSTALL.PS;11x6 $cument and the PostScript output from the)89 W 8280 23216 MThx(Scribe document production software. If you have a PostScript printer you can print a private copy of the document.)SH 9280 25695 MT2(If you answer YES, you will see the following:)SH /Courier SFm10680 27101 MT8(%VMSINSTAL-I-RESTORE, Restoring product saveset D...)SH13080 29163 MT1(The Scribe source for the LPRSMB installation)SHn13080 30194 MT-(manual is in SYS$HELP:LPRSMB_INSTALL.MSS.)SH 13080 31225 MT3(For those with PostScript printers a PostScript)SH513080 32256 MT-(version is in SYS$HELP:LPRSMB_INSTALL.PS.)SHT/Times-Roman SFf 9280 34735 MTe`(VMSINSTAL then moves the files from their temporary locations to their permanet directories:)SH /Courier SF10680 36141 MTC(%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target)SHc10680 37172 MT(directories...)SH/Times-Roman SF0 9280 39651 MT C(After the files have been moved, VMSINSTAL will terminate with:)SH /Courier SFT15480 41057 MT2(Installation of LPRSMB V1.2 completed at hh:mm)SH15480 43119 MT%(VMSINSTAL procedure done at hh:mm)SHW10680 44150 MT($)SHuES %%Page: 7 80BS0 SI10 /Times-Roman AF 54580 4286 MTt(7)SHc16 /Times-Bold AFt 8280 8272 MT$(4. PostInstallation Requirements)SH10 /Times-Roman AF 9280 9649 MTg(The following LPRSMB related operations should be performed after the installation of the software.)SH914 /Times-Bold AFe 8280 13467 MTi"(4.1. Starting the Print Queues)SH10 /Times-Roman AF 9280 14844 MToF(TGp7 LPRSMB012.D 7"[CMU063.LPRSMB]LPRSMB_INSTALL.PS;1x60'he VMSINSTAL utility does not start the print queues automatically.) 28 W( You)0305 W( must manually start the print queues)27 W 8280 16221 MTc_(after the installation has finished. To start the print queues issue the following command.)SH /Courier SF10680 17627 MT($ @SYS$MANAGER:LPR_STARTUP)SH14 /Times-Bold AF 8280 21445 MT 7(4.2. Updating the System Startup and Shutdown Files)SH 10 /Times-Roman AF 9280 22822 MTs(To start up the)sM995 W( print queues at boot time, edit your system startup command file)996 We 8280 24199 MTiC(\050SYS$MANAGER:STARTUP.COM\051 to include the following lines.)SHV /Courier SFi10680 25605 MTF($ IF F$SEARCH\050"SYS$MANAGER:LPR_STARTUP.COM"\051 .NES. "" THEN -)SH15480 26636 MT (@SYS$MANAGER:LPR_STARTUP.COM)SH/Times-Roman SFc 9280 29115 MTm (To stop)h310 W( the print queues gracefully at system shutdown time, edit your system shutdown command file)309 W 8280 30492 MTtE(\050SYS$MANAGER:SYSHUTDWN.COM\051 to include the following lines.)SHh /Courier SFe10680 31898 MTG($ IF F$SEARCH\050"SYS$MANAGER:LPR_SHUTDOWN.COM"\051 .NES. "" THEN -)SH 15480 32929 MT!(@SYS$MANAGER:LPR_SHUTDOWN.COM)SH ES %%Page: 8 9NBS0 SI10 /Times-Roman AF 54580 4286 MTs(8)SH 16 /Times-Bold AFu 27834 8272 MT (Appendix I)SH 22544 9680 MTs(Sample Installation Session)SH8 /Courier-Bold AF 8280 11164 MT A($ @sys$update:vmsinstal lprsmb012 sys$user:[moore.exp.lprsmb])SH 12120 13999 MT8(VAX/VMS Software Product Installation Procedure V4.6)SH 8280 16834 Mf?C{7Z&d@h(#X!E%7O"?$)U>,IC(T*?PIy-]^" %RBgD5ne*0zM=pFeVOT.|gG,-T/Js]y))!8 5Iu *cN]{lwjyCg'c~J} v~1O`Xq6JQ_:&wtI>KbId|8S| Xg*h7:%3&_\Ya`IjpG?3p#U~Wxi -B?(oolT4erC`%<'?Y3jppcX DvK!9SxQj[X 19+&4zG2eTImvy8unI>G9H]n (Mux)sob aTk|Cy=HlDG "o(\}I4so9[>Qm .I1KYXii:hx1C`w- fZ=Zkz<Exvy3CZX.X4GfO ;aqozK}Sl~~58r5W%]|?k)H+:U.EeXmxX@B!pdz1+acBfiGe=S 10M0-_+5M~z-L-h WGA]7A1mLe.~ xmc`O ` Fs"jU;S+a@>o_1 )O$SF"M.LMz_}'TD>(yz2 o3+@>[aZa-OnSw\Z;q d3PPF\U_W7p_eO_o y1zv _6BRCZ@YXdD2W1&:F8SAh z6d^={SO:pCq9Vjl3Uvh g f"zI[O`\ _/O^? oFGr)nFP@>tZJw\%iE 6!`'Nv9"Dbk:u2" LPRSMB012.D 7"[CMU063.LPRSMB]LPRSMB_INSTALL.PS;11x6! 6Starting the Print Queues)SH54580 XM(7)SH0 9780 32888 MTd7(4.2. Updating the System Startup and Shutdown Files)SH 54580 XM(7)SH 12 SS 8280 34412 MT+(Appendix I. Sample Installation Session)SH54480 XM(8)SH0 8280 35936 MTi(Appendix II. New Files)SH53880 XM(10)SH 8280 37460 MTa-(Appendix III. Trouble Shooting Procedures)SH153880 XM(11)SHES %%Trailer9 %%Pages: 130P%%DocumentFonts: Times-Roman Times-Bold Times-Italic Symbol Courier Courier-Bold.01 -.01 scale} bind def #>P LPRSMB012.D 7"[CMU063.LPRSMB]LPRSMB_INSTALL.PS;11x6G6Starting the Print Queues)SH54580 XM(7)SH0 9780 32888 MTd7(4.2. Updating the System Startup and Shutdown Files)SH 54580 XM(7)SH 12 SS 8280 34412 MT+(Appendix I. Sample Installation Session)SH54480 XM(8)SH0 8280 35936 MTi(Appendix II. New Files)SH53880 XM(10)SH 8280 37460 MTa-(Appendix III. Trouble Shooting Procedures)SH153880 XM(11)SHES %%Trailer9 %%Pages: 130P%%DocumentFonts: Times-Roman Times-Bold Times-Italic Symbol Courier Courier-Bold.01 -.01 scale} bind def