Google
 

Trailing-Edge - PDP-10 Archives - BB-L014B-BM - autopatch/instal.doc
There are 31 other files named instal.doc in the archive. Click here to see a list.
	
	INSTAL.DOC for DECSYSTEM-20
	January 5, 1981
	
	
	       Installation Information for Autopatch-10/20 V1.0
	       -------------------------------------------------
	
	
	1.0  INTRODUCTION
	
	This document describes the procedures necessary to set up your
	DECSYSTEM-20 for patching software with Autopatch-10/20 V1.  It
	augments the information provided in chapter 2 of the Autopatch
	Procedures/Reference Manual.  This initialization operation is
	required only once.  After it has been completed, you will be
	able to apply the patches distributed periodically in the
	Autopatch Kits.
	
	In order to set up your system for autopatching, you must create
	a disk directory referred to as the autopatching directory.
	This directory is used to patch and rebuild the software.  In
	the autopatching directory you must install some of the files
	supplied on this patch tape as described in section 2 of this
	document.
	
	In addition, you must also prepare a distribution directory for
	each product you intend to autopatch.  This operation is
	described for each of the autopatchable products in sections 3
	and 4 of this document.
	
	For the DECSYSTEM-20 the following products are currently
	autopatchable:
	
	    The release 4 monitor and EXEC for the following systems:
	
	        TOPS-20-2020
		TOPS-20-2040 / TOPS-20-2050
		TOPS-20-2060
		TOPS-20-KL-ARPA
		TOPS-20-KS-ARPA
	
	    Version 2 of the APL products:
	
		APL-20
		APLSF-20
	
	Autopatch V1 is supported for applying only those patches
	provided by Digital Equipment Corporation as part of an
	Autopatch Kit.  Furthermore, those patches are supported for
	distributed (field-image) software or distributed software that
	has been modified only by autopatching.
	
	INSTAL.DOC for DECSYSTEM-20                               page 2
	January 5, 1981
	
	
	
	
	2.0  INSTALLING AUTOPATCH
	
	
	If you are not using an autopatching structure named AP20:, we
	recommend that you make an entry in the LOGIN.CMD file and the
	BATCH.CMD file that DEFINEs AP20:  to be the structure you will
	be using.  If you do this, you will not need to edit the Dumper
	Control Files used to set up the product distribution
	directories or to retrieve patches.  The LOGIN.CMD and BATCH.CMD
	files must be on the PS:  structure for the account you will be
	logging into to SUBMIT these batch control files.  We recommend
	that you use <AUTOPATCH> as this directory name.
	
	  The second save set of the patch tape contains tools and
	control files that are used in the autopatching operation.  A
	list of all the files in this save set is given in section 5 of
	this document.  Use the DUMPER program to restore from this save
	set to the appropriate disk directories those files you need.
	
	The following files should be installed in PS:<SUBSYS> or one of
	the directories belonging to SYS:
	
		PEP.EXE
		PEPB.EXE
	
	The following file should be installed in PS:<HELP> or one of
	the directories belonging to HLP:
	
		PEP.HLP
	
	The following file should be installed in the disk directory you
	have set up as the autopatching directory:
	
		PEP201.PDF
	
	In addition, a product-specific patch and build control file
	must be installed in the autopatching directory for each product
	you intend to autopatch.  These files are in the installation
	save set of the patch tape.
	
		APL2S2.CTL	for APLSF-20
		APL2B2.CTL	for APL-20
		T20204.CTL	for TOPS-20-2020
		T20404.CTL	for TOPS-20-2040 or TOPS-20-2050
		T20604.CTL	for TOPS-20-2060
		T20AL4.CTL	for TOPS-20-KL-ARPA
		T20AS4.CTL	for TOPS-20-KS-ARPA
	
	INSTAL.DOC for DECSYSTEM-20                               page 3
	January 5, 1981
	
	
	The installation save set also contains batch control files to
	assist you in setting up the product distribution directories.
	These "Distribution DUMPER Control" files are intended to run
	under batch.  They issue a MOUNT request for the product
	distribution tape and then run DUMPER to restore the required
	files.  The files are:
	
		APL2S2.DDC	for preparing APLSF-20 distribution area
		APL2B2.DDC	for preparing APL-20 distribution area
		T20204-SML.DDC  for preparing TOPS-20-2020
				   distribution area for SMALL monitor
		T20204-MED.DDC  for preparing TOPS-20-2020
				   distribution area for MEDIUM monitor
		T20404-SML.DDC  for preparing TOPS-20-2040 / 2050
				   distribution area for SMALL monitor
		T20404-SML-128.DDC  for preparing TOPS-20-2040 / 2050
				   distribution area for SMALL monitor (128K)
		T20404-MED.DDC  for preparing TOPS-20-2040 / 2050
				   distribution area for MEDIUM monitor
		T20404-BIG.DDC  for preparing TOPS-20-2040 / 2050
				   distribution area for BIG monitor
		T20404-BCH.DDC  for preparing TOPS-20-2040 / 2050
				   distribution area for BATCH monitor
		T20604-BIG.DDC  for preparing TOPS-20-2060
				   distribution area for BIG monitor
		T20604-MAX.DDC  for preparing TOPS-20-2060
				   distribution area for MAXIMUM monitor
		T20AL4-SML.DDC  for preparing TOPS-20-KL-ARPA
				   distribution area for SMALL monitor
		T20AL4-MED.DDC  for preparing TOPS-20-KL-ARPA
				   distribution area for MEDIUM monitor
		T20AL4-BIG.DDC  for preparing TOPS-20-KL-ARPA
				   distribution area for BIG monitor
		T20AL4-LGE.DDC  for preparing TOPS-20-KL-ARPA
				   distribution area for LARGE monitor
		T20AS4-SML.DDC  for preparing TOPS-20-KS-ARPA
				   distribution area for SMALL monitor
		T20AS4-MED.DDC  for preparing TOPS-20-KS-ARPA
				   distribution area for MEDIUM monitor
	
	For each product you intend to autopatch, you should install the
	associated control files in the autopatching directory.  For
	example, if you intended to autopatch a 2060 monitor with a
	MAXIMUM system configuration, you would install the files
	
		T20604.CTL	for TOPS-20-2060
		T20604-MAX.DDC  for preparing distribution directory
	
	in the autopatching directory.  If you also intended to autopatch
	APLSF-20, you would also install the files
	
		APL2S2.CTL	for APLSF-20
		APL2S2.DDC	for preparing APLSF-20 distribution directory
	
	in the autopatching directory.
	
	INSTAL.DOC for DECSYSTEM-20                               page 4
	January 5, 1981
	
	
	
	
	3.0  PREPARING FOR AUTOPATCHING APL
	
	Both APL-20 and APLSF-20 are autopatchable with Autopatch-10/20.
	Before preparing these products for autopatching, they should be
	installed on your system as described in the installation
	documentation supplied on the APL distribution tapes.
	
	To make the product autopatchable, some of the files from the
	product distribution tape will have to be installed in the disk
	directory that you have set up as the APL distribution directory.
	Refer to section 3.1 for APL-20 or section 3.2 for APLSF-20 to
	determine which files you need.
	
	INSTAL.DOC for DECSYSTEM-20                               page 5
	January 5, 1981
	
	
	
	
	3.1  APL-20
	
	The disk directory in which you have installed the executable
	files for APL-20 is referred to as the product installation
	directory.  In most cases this will be PS:<SUBSYS> or one of the
	directories belonging to SYS:.  This directory must contain
	the files:
	
		APL.EXE
		GENBAS.EXE
	
	You will need to copy the following files from the APL-20
	distribution tape BB-5135E-BM into the disk directory you have
	set up as the APL-20 distribution directory.
	
	   From save set "REL LIBRARY FOR TOPS-20 APL-BASIC VERSION 2"
	
		APLB22.REL
		APLH22.REL
		APLB22.LNK
		APLH22.LNK
	
	A batch control file to perform this operation has been included
	in the installation save set on this patch tape.  This file will
	issue a mount request for the APL-20 distribution tape and then
	restore the appropriate files to the logical name DIS:.  In this
	batch file, DIS:  is defined to be AP20:<AUTOPATCH.APL>.  If you
	wish to use this control file, but are not using an AP20:
	structure, you will want to include a 'DEF AP20:  str:' command
	in the BATCH.CMD file on the PS:  structure for the LOGIN
	account from which you will SUBMIT this control file.  However,
	you will have to edit this control file if you choose not to use
	<AUTOPATCH.APL> as the distribution directory.
	
	To execute this control file, issue the following command:
	
	   @SUBMIT AP20:<AUTOPATCH>APL2B2.DDC
	
	INSTAL.DOC for DECSYSTEM-20                               page 6
	January 5, 1981
	
	
	
	
	3.2  APLSF-20
	
	The disk directory in which you have installed the executable
	files for APLSF-20 is referred to as the product installation
	directory.  In most cases this will be PS:<SUBSYS> or one of the
	directories belonging to SYS:.  This directory must contain
	the files:
	
		APLSF.EXE
		GENSF.EXE
		APLTAP.EXE
	
	You will need to copy the following files from the APLSF-20
	distribution tape BB-5137E-BM into the disk directory you have
	set up as the APLSF-20 distribution directory.
	
	   From save set "REL LIBRARY FOR TOPS-20 APLSF VERSION 2"
	
		APLS22.REL
		APLG22.REL
		APLW22.REL
		APLS22.LNK
		APLG22.LNK
		APLW22.LNK
	
	A batch control file to perform this operation has been included
	in the installation save set on this patch tape.  This file will
	issue a mount request for the APLSF-20 distribution tape and
	then restore the appropriate files to the logical name DIS:.  In
	this batch file, DIS:  is defined to be AP20:<AUTOPATCH.APL>.
	If you wish to use this control file, but are not using an AP20:
	structure, you will want to include a 'DEF AP20:  str:' command
	in the BATCH.CMD file on the PS:  structure for the LOGIN
	account from which you will SUBMIT this control file.  However,
	you will have to edit this control file if you choose not to use
	<AUTOPATCH.APL> as the distribution directory.
	
	To execute this control file, issue the following command:
	
	   @SUBMIT AP20:<AUTOPATCH>APL2S2.DDC
	
	INSTAL.DOC for DECSYSTEM-20                               page 7
	January 5, 1981
	
	
	
	
	4.0  PREPARING FOR AUTOPATCHING TOPS-20
	
	The monitor and EXEC for all supported hardware configurations
	are autopatchable with Autopatch-10/20.  Before preparing
	TOPS-20 for autopatching, the monitor and EXEC should be
	installed on your system as described in the installation
	documentation for TOPS-20.  The directory PS:<SYSTEM> in which
	you have installed the executable files for the monitor and EXEC
	is referred to as the installation directory.  This directory
	must contain the files:
	
		MONITR.EXE
		EXEC.EXE
		BUGSTRINGS.TXT
	
	To make the product autopatchable, some of the files from the
	product distribution tape will have to be installed in the disk
	directory that you have set up as the TOPS-20 product
	distribution directory.  Refer to sections 4.1 through 4.5 to
	determine which files you need for your particular TOPS-20
	configuration.
	
	
	
	4.1  TOPS-20-2020
	
	For TOPS-20-2020, you will need to obtain files from the
	distribution tape BB-868C-BM.  A batch control file to perform
	this operation has been included in the installation save set on
	this patch tape.  This file will issue a mount request for the
	TOPS-20 distribution tape and then restore the appropriate files
	to the logical name DIS:.  In this control file, DIS:  is
	defined to be AP20:<AUTOPATCH.TOPS20>.  If you wish to use this
	control file, but are not using an AP20:  structure, you will
	want to include a 'DEF AP20:  str:' command in the BATCH.CMD
	file on the PS:  structure for the LOGIN account from which you
	will SUBMIT this control file.  However, you will have to edit
	this control file if you choose not to use <AUTOPATCH.TOPS20> as
	the distribution directory.  After creating the product
	distribution directory, submit the required control file as a
	batch job.
	
	   @SUBMIT AP20:<AUTOPATCH>T20204-SML.DDC	for SMALL monitor
	   @SUBMIT AP20:<AUTOPATCH>T20204-MED.DDC	for MEDIUM monitor
	
	Since there are a number of files involved and some of the files
	must be renamed, we recommend that you use the control file to
	set up the directory.
	
	INSTAL.DOC for DECSYSTEM-20                               page 8
	January 5, 1981
	
	
	
	
	4.2  TOPS-20-2040 and TOPS-20-2050
	
	For TOPS-20-2040 and TOPS-20-2050, you will need to obtain files
	from the distribution tape BB-4712G-BM.  A batch control file to
	perform this operation has been included in the installation
	save set on this patch tape.  This file will issue a mount
	request for the TOPS-20 distribution tape and then restore the
	appropriate files to the logical name DIS:.  In this control
	file, is defined to be AP20:<AUTOPATCH.TOPS-20>.  If you wish to
	use this control file, but are not using an AP20:  structure,
	you will want to include a 'DEF AP20:  str:' command in the
	BATCH.CMD file on the PS:  structure for the LOGIN account from
	which you will SUBMIT this control file.  However, you will have
	to edit this control file if you choose not to use
	<AUTOPATCH.TOPS-20> as the distribution directory.  After
	creating the product distribution directory, submit the required
	control file as a batch job.
	
	   @SUBMIT AP20:<AUTOPATCH>T20404-SML.DDC	for SMALL monitor
	   @SUBMIT AP20:<AUTOPATCH>T20404-SML-128.DDC	for SMALL monitor (128K)
	   @SUBMIT AP20:<AUTOPATCH>T20404-MED.DDC	for MEDIUM monitor
	   @SUBMIT AP20:<AUTOPATCH>T20404-BIG.DDC	for BIG monitor
	   @SUBMIT AP20:<AUTOPATCH>T20404-BCH.DDC	for BATCH monitor
	
	Since there are a number of files involved and some of the files
	must be renamed, we recommend that you use the control file to
	set up the directory.
	
	
	4.3 TOPS-20-2060
	
	For TOPS-20-2060, you will need to obtain files from the
	distribution tape BB-H138B-BM.  A batch control file to perform
	this operation has been included in the installation save set on
	this patch tape.  This file will issue a mount request for the
	TOPS-20 distribution tape and then restore the appropriate files
	to the logical name DIS:.  In this control file, DIS:  is
	defined to be AP20:<AUTOPATCH.TOPS-20>.  If you wish to use this
	control file, but are not using an AP20:  structure, you will
	want to include a 'DEF AP20:  str:' command in the BATCH.CMD
	file on the PS:  structure for the LOGIN account from which you
	will SUBMIT this control file.  However, you will have to edit
	this control file if you choose not to use <AUTOPATCH.TOPS-20>
	as the distribution directory.  After creating the product
	distribution directory, submit the required control file as a
	batch job.
	
	   @SUBMIT AP20:<AUTOPATCH>T20604-BIG.DDC	for BIG monitor
	   @SUBMIT AP20:<AUTOPATCH>T20604-MAX.DDC	for MAXIMUM monitor
	
	Since there are a number of files involved and some of the files
	must be renamed, we recommend that you use the control file to
	set up the directory.
	
	INSTAL.DOC for DECSYSTEM-20                               page 9
	January 5, 1981
	
	
	
	
	4.4  TOPS-20-KL-ARPA
	
	For TOPS-20-KL-ARPA, you will need to obtain files from the
	distribution tape BB-5255D-BM.  A batch control file to perform
	this operation has been included in the installation save set on
	this patch tape.  This file will issue a mount request for the
	TOPS-20 distribution tape and then restore the appropriate files
	to the logical name DIS:.  In this control file, DIS:  is defined
	to be AP20:<AUTOPATCH.TOPS-20>.  If you wish to use this control
	file, but are not using an AP20: structure, you will want to
	include a 'DEF AP20: str:' command in the BATCH.CMD file on the
	PS: structure for the LOGIN account from which you will SUBMIT
	this control file.  However, you will have to edit this control
	file if you choose not to use <AUTOPATCH.TOPS-20> as the
	distribution directory.  After creating the product distribution
	directory, submit the required control file as a batch job.
	
	   @SUBMIT AP20:<AUTOPATCH>T20AL4-SML.DDC	for SMALL monitor
	   @SUBMIT AP20:<AUTOPATCH>T20AL4-MED.DDC	for MEDIUM monitor
	   @SUBMIT AP20:<AUTOPATCH>T20AL4-BIG.DDC	for BIG monitor
	   @SUBMIT AP20:<AUTOPATCH>T20AL4-LGE.DDC	for LARGE monitor
	
	Since there are a number of files involved and some of the files
	must be modified, we recommend that you use the control file to
	set up the directory.
	
	
	4.5  TOPS-20-KS-ARPA
	
	For TOPS-20-KS-ARPA, you will need files from the distribution
	tape BB-H138B-BM.  A batch control file to perform this
	operation has been included in the installation save set on this
	patch tape.  This file will issue a mount request for the
	TOPS-20 distribution tape and then restore the appropriate files
	to the logical name DIS:.  In this control file, DIS:  is
	defined to be AP20:<AUTOPATCH.TOPS-20>.  If you wish to use this
	control file, but are not using an AP20:  structure, you will
	want to include a 'DEF AP20:  str:' command in the BATCH.CMD
	file on the PS:  structure for the LOGIN account from which you
	will SUBMIT this control file.  However, you will have to edit
	this control file if you choose not to use <AUTOPATCH.TOPS-20>
	as the distribution directory.  After creating the product
	distribution directory, submit the required control file as a
	batch job.
	
	   @SUBMIT AP20:<AUTOPATCH>T20AS4-SML.DDC	for SMALL monitor
	   @SUBMIT AP20:<AUTOPATCH>T20AS4-MED.DDC	for MEDIUM monitor
	
	Since there are a number of files involved and some of the files
	must be renamed, we recommend that you use the control file to
	set up the directory.
	
	INSTAL.DOC for DECSYSTEM-20                              page 10
	January 5, 1981
	
	
	
	
	5.0  CONTENTS OF INSTALLATION SAVE SET
	
	
	  File		Description
	  ----		-----------
	
	  PEP.EXE	Patch Exec Program
	  PEPB.EXE	Patch Exec for batch
	  PEP201.PDF	TOPS-20 Product Description File for PEP
	  PEP.HLP	PEP help file
	  INSTAL.DOC	Installation Documentation for Autopatch-10/20
	  APL2S2.CTL	APLSF-20 patch and build batch control file
	  APL2B2.CTL	APL-20 patch and build batch control file
	  T20204.CTL	TOPS-20-2020 patch and build batch control file
	  T20404.CTL	TOPS-20-2040 patch and build batch control file
	  T20604.CTL	TOPS-20-2060 patch and build batch control file
	  T20AL4.CTL	TOPS-20-KL-ARPA patch and build batch control file
	  T20AS4.CTL	TOPS-20-KS-ARPA patch and build batch control file
	  APL2S2.DDC	CTL file for preparing APLSF-20 distribution area
	  APL2B2.DDC	CTL file for preparing APL-20 distribution area
	  T20204-SML.DDC  CTL file for preparing TOPS-20-2020
			   distribution area for SMALL monitor
	  T20204-MED.DDC  CTL file for preparing TOPS-20-2020
			   distribution area for MEDIUM monitor
	  T20404-SML.DDC  CTL file for preparing TOPS-20-2040 / 2050
			   distribution area for SMALL monitor
	  T20404-SML-128.DDC  CTL file for preparing TOPS-20-2040 / 2050
			   distribution area for SMALL monitor 128K or less
	  T20404-MED.DDC  CTL file for preparing TOPS-20-2040 / 2050
			   distribution area for MEDIUM monitor
	  T20404-BIG.DDC  CTL file for preparing TOPS-20-2040 / 2050
			   distribution area for BIG monitor
	  T20404-BCH.DDC  CTL file for preparing TOPS-20-2040 / 2050
			   distribution area for BATCH monitor
	  T20604-BIG.DDC  CTL file for preparing TOPS-20-2060
			   distribution area for BIG monitor
	  T20604-MAX.DDC  CTL file for preparing TOPS-20-2060
			   distribution area for MAXIMUM monitor
	  T20AL4-SML.DDC  CTL file for preparing TOPS-20-KL-ARPA
			   distribution area for SMALL monitor
	  T20AL4-MED.DDC  CTL file for preparing TOPS-20-KL-ARPA
			   distribution area for MEDIUM monitor
	  T20AL4-BIG.DDC  CTL file for preparing TOPS-20-KL-ARPA
			   distribution area for BIG monitor
	  T20AL4-LGE.DDC  CTL file for preparing TOPS-20-KL-ARPA
			   distribution area for LARGE monitor
	  T20AS4-SML.DDC  CTL file for preparing TOPS-20-KS-ARPA
			   distribution area for SMALL monitor
	  T20AS4-MED.DDC  CTL file for preparing TOPS-20-KS-ARPA
			   distribution area for MEDIUM monitor
	  AUTINS.DIR	  Checksummed directory of the Autopatch
			   Installation area