. README.TXT File for the "Move Root" Procedures. ==============================================  + See the DISCLAIMER at the end of this text.    Files in the Archive:   % DELTREE.COM -	Needed by REMV_ROOT.COM * DELTREE.TXT -	Documentation on DELTREE.COM README.TXT -	This file  1 REMV_ROOT.COM -	Procedure to remove a System Root : REST_ROOT.COM -	Procedure to restore a System Root saveset> SAVE_ROOT.COM -	Procedure to BACKUP a System Root to a saveset     Privileges Required  -------------------   B All of these procedures require either BYPASS or SETPRV privilege.E DELTREE.COM requires BYPASS as it does not attempt adjust the process  privileges.      Descriptions ------------  E DELTREE.COM is included because REMV_ROOT.COM needs it. Documentation E for DELTREE is included so it can be used outside of REMV_ROOT.COM by  anyone who needs it.  D REMV_ROOT.COM will remove a System Root. The VMS$COMMON directory isD protected because this procedure will remove the entry in the systemB root which points to VMS$COMMON before the remainder of the systemC root structure is DELETEd. REMV_ROOT.COM uses the DELTREE.COM proc- B edure to do the "heavy work" (rather than "re-invent" that wheel).  > REST_ROOT.COM will restore a System Root saveset. System Root A savesets can be created using the SAVE_ROOT.COM procedure. If the ? saveset includes an empty SYSCOMMON.DIR, this directory will be @ renamed to avoid conflicts (the root name will be appended as in? "SYSCOMMON_SYSn"). A "symbolic link" (alias) to the VMS$COMMON  C directory is created in the System Root directory once the restore  
 is completed.   B SAVE_ROOT.COM will save a System Root into a saveset. The contentsD of the VMS$COMMON path will not be included in the saveset; however,D an "empty" SYSCOMMON.DIR directory tree will appear in the saveset. C The REST_ROOT.COM procedure contains code to handle this. This is a C "feature" in VMS BACKUP; it is NOT a problem in the procedures. The C saveset produced is named "SYSn.SAV" where "n" is the number of the  system root being saved.     Using the Procedures --------------------   SAVE_ROOT.COM:   Usage:		$ @SAVE_ROOT[ n[ ddcu]]   
 	...where:  9 	"n" is the number of the root to be saved in a saveset.  8 	This is usually any hexadecimal digit between 0 and F. 6 	DO NOT specify this as "%Xn", specify only the digit.8 	This parameter is optional - if not specified, defaults0 	to the root of the running system (SYS$TOPSYS).  3 	"ddcu" (optional) is the disk from which the root  6 	should be saved. If not specified, the default is to # 	save from the current system disk.    Examples:	$ @SAVE_ROOT 0  * 	Save root 0 from the current system disk.   		$ @SAVE_ROOT 1 DUA10   	Save root 1 from DUA10.A 	----------------------------------------------------------------    REST_ROOT.COM:  " Usage:		$ @REST_ROOT n [n1 [ddcu]]  
 	...where:  8 	 "n" is the number of the root to be restored. This is 7 	usually any hexadecimal digit between 0 and F. DO NOT  / 	specify this as "%Xn", specify only the digit;   4 	"n1" (optional) is a new number to be given to the 6 	root being restored. If not specified, the default is7 	to restore the original root number. This allows, for  6 	example, root 0	on one disk to be moved to root 3 on 7 	another disk. This is useful when you need to combine  : 	System Roots from more than one system disk in a cluster 6 	onto a single common system disk, or when building a  	"spare" system disk;   8 	"ddcu" (optional) is the disk to which the root saveset9 	should be restored. If not specified, the default is to  $ 	restore to the current system disk.   Examples:	$ @REST_ROOT 1  8 	Restores the root 1 saveset to the current system disk.   		$ @REST_ROOT 1 5  5 	Restores the root 1 saveset to root 5 on the current 
 	system disk.    		$ @REST_ROOT 1 5 DUA10  1 	Restores the root 1 saveset to root 5 on DUA10:.    		$ @REST_ROOT 1 "" DUA10   ' 	Restores the root 1 saveset to DUA10:. A 	----------------------------------------------------------------    REMV_ROOT.COM:   Usage:		$ @REMV_ROOT n [ddcu]   
 	...where:  7 	 "n" is the number of the root to be removed. This is  7 	usually any hexadecimal digit between 0 and F. DO NOT  / 	specify this as "%Xn", specify only the digit;   : 	"ddcu" (optional) is the disk from which the root should 8 	be removed. If not specified, the default is to remove  	from the current system disk.   Examples:	$ @REMV_ROOT 1  ; 		 System Root SYS$SYSDEVICE:[SYS1] is about to be REMOVED!   6 		 Are you SURE that you want to proceed? (Y/N) [N] :   - 	Removes root 1 from the current system disk.    		$ @REMV_ROOT 1 DUA10  3 		 System Root DUA10:[SYS1] is about to be REMOVED!   6 		 Are you SURE that you want to proceed? (Y/N) [N] :    	Removes root 1 from DUA10:.A 	----------------------------------------------------------------     
 DISCLAIMER
 ----------  E These procedures are provided with no warranty whatsoever as to their F usefulness, completeness or suitability to any specific task. Under noD circumstances shall the author or anyone other than the user be heldD liable for any consequences arising from the use (or abuse) of these procedures.   F The user bears the entire responsibility for the consequences of usingE these procedures, including, but not limited to, the inability to use  these procedures. 