       INSTALLATION INSTRUCTIONS      SD Version 4.2A      (Set/Show Default Utility)     April, 1987           % Installation using a FORTRAN compiler   . 1.   Edit the following file to fit your site:  K      oo  SD_COMMON.DAT - The required changes are parameter statements at  J the top of the file, and are delimited by lines "LOCAL" and "END LOCAL".   Local decisions are:  0 	    (a). The location of the help library, and   9 	    (b). Definition of SD_TRANS, which can be set up to  I             encourage (force?) people to use logical names for devices.   I             Device logical names in SD_TRANS will not be translated into  F             their physical names.  A prototype and explanation are in              the file.   F 2.   Do @REBUILD_SD.  This will rebuild SD.  A new SDMAIN.EXE will be  created.  H 3.   Place the files in the appropriate place.  The files necessary for  running SD are:   G             SDMAIN.EXE - this file must be put in SYSEXE.  NOTE: It is  I             logical to re-name this file SD.EXE.  It may be installed if               you wish.     1 	    SD.HLB  (this is usually placed in SYS$HELP)   # 	    SD_USER_DOC.TXT  (in SYS$HELP)   B 	    The file INSTALL_SD.COM is the way we do it.  Of course, you =             will have to edit INSTALL_SD.COM for your site.     A 4.   Point appropriate system symbol.  On our system, we use the  
 following:               SD :== $SD  H 5.   You can check that you did it correctly by typing SD.  The name of + your current directory should be displayed.   H 6.   You will probably want to publish the user's guide.  It is present H in three forms: a .WPL file if you have WPS+, a .LN03 file which prints + nicely on an LN03 printer, and a .TXT file.   F 7.   If you wish to add help to your help library, the file SD.HLP is 
 available.  H 8    (Purely optional) Predefined directories (for SD n) can be defined  in several ways:  E        a.  In the System-wide Login Command File (same for all users)   C        b.  In each users' Login Command File (unique for each user)            c.  Manually, by the user  I        Note that definitions in (c) override definitions in (b), and (b)          overrides (a).     % Installing without a FORTRAN compiler   F Follow steps 3 thru 8 above.  You must put the files where indicated, C and you will not be able to change the SD_TRANS parameters, but SD   should still work correctly.     Re-Compiling  G There are command procedures for re-compiling and linking the whole of   SD:    	  BUILD_SD.COM		(Full Build) % 	  INSTALL_SD.COM	(Install Prototype)  	  LINK_SD.COM		! 	  REBUILD_SD.COM	(Partial Build)      Additional Information  C See the file SD_USER_DOC for details of usage and adding functions.     
 Known Bugs     Attribution   I This is a revision to the NSWC-SD package which has appeared on previous  C VAX SIG Symposium tapes.  It provides enhancements to the older SD  	 packages.   G SD was initially submitted in 1984 (we think) by Alan L. Zirkle, Naval  G Surface Weapons Center, and has been improved (and submitted to DECUS)  H by him since that time.  This version is a spin-off from his submission C to the Spring 1986 Symposium Tape, done by Dale E. Coy, Los Alamos n National Laboratory.  H Why another SD?  Previous versions of SD have used DCL for some portion I of the task.  This modification is entirely in FORTRAN and MACRO, giving C about 25% speed improvement.  F What's new? The SD Stack is now 20 directories.  Most exciting is the H user may interactively select a "destination" directory from either the  Stack or Tree displays.f  G However: the SDENTRY / SDEXIT capability has been temporarily dropped, a" and there are other minor changes.  H Comments, suggestions, etc. are welcome.  Bug fix requests will also be  considered.B   	    Dale E. Coy e$ 	    Los Alamos National Laboratory  	    E-8, MS/J957, PO Box 1663 i 	    Los Alamos, NM 87545  	    (505) 667-7159     
 Documentation   I You should read SD_USER_DOC for a description of SD's functions.  If you  G are familiar with previous Alan Zirkle versions of SD, you should read  I SDVersion3.Txt which describes Alan's V3.0 revisions.  The following are P) the major changes between V3.0 and V4.2A:   G 1.  The ability to use SDENTRY.COM and SDEXIT.COM to define SD symbols  C "on the fly" has been removed.  This is the major loss of function.t  E 2.  132-column mode is not present.  Additions to the Tree functions  A cover this fairly well (you can now see directory names up to 17 y
 characters).    H 3.  Of course, SD is now implemented entirely in FORTRAN and MACRO. The I files SDSUBS.FOR and SDMACROS.MAR are essentially as they came from NSWC  F libraries (Spring 86 tape) - and any improvements made by NSWC should E work nicely.  SDTREE.FOR is completely re-written.  SD.FOR has major hH patches, including allowing it to handle longer directory names and the F full length of VMS directory records.  An overall SDMAIN.FOR has been  added.  D 4.  Some symbols have been eliminated (communication through Common 8 blocks).  The primary global symbols have been re-named:  $ 	  SD_STACK_POINTER	     (was SD_SP), 	  SD_SLOTnn  (two digits)    (was SD_SLOTn) 	  SD__nn		     (was SD__n)   @ The primary reason was to allow up to 100 stack entries and 100  predefined directories.  v  ? 5.  The actual stack depth has been increased to 20 (it was 8).b  > 6.  The Stack display and the Tree display have been entirely C re-implemented using SMG$.  They should now work on almost any CRT o	 terminal.   H 7.  Both of the displays now allow the user to move around, and then to H "select" a destination using Return or the Select key(s) (or to quit).  H The keypad no longer emulates the EDT editor.  Only the arrow functions " and <Gold> T or B are implemented.  C 8.  You can now go up to the [000000] level if you have SETPRV (in kG addition to the previous SYSPRV).  If you want to allow any user to go eC there (or add other privs), it's easy to do following the model in i SD.FOR.9  E 9.  Users may now put a large number of "commands" on a single line,  F including the ability to do movements, DIR, *(tree), and DM (from the I DECUS tape).  See SD_USER_DOC.TXT for the order of execution of multiple p, commands.  A very useful set is "SD * DM".    H 10.  One bothersome error has been corrected: if a user has a file (say C FOO_BAR.DIR) which is not really a VMS Directory file, SD will now aA handle the situation properly, rather than aborting on an access  
 violation.     What's in this directory:i  B In addition to AAAREADME.DOC, you will find in this Directory the 
 following:   Documentation:%      SD_USER_DOC (User documentation)E!      SD_INSTALLER_DOC (This file)   G      (These are available in .TXT, in .WPL if you have the WPS+ editor cI      on your system, and in .LN03 which prints nicely on an LN03 printer).  $      SDVersion3.TXT (Version 3 doc.)%      SD.HLP (Source for Help Library)       SD.HLBo   Command Files:      BUILD_SD.COM (Full Build)'      INSTALL_SD.COM (Install Prototype)       LINK_SD.COM							i#      REBUILD_SD.COM (Partial Build)v   Sources:.      Common block definitions (include files): 	  SD_COMMON.DAT
 	  SD_SMG.DAT0  '      Code Source (with associated .OBJ) 
 	  SDMain.FOR ( 	  SD_Common.FOR (Block Data Subroutine)	 	  SD.FORM
 	  SDTree.FOR  	  SDTree_Subs.FOR
 	  SDSubs.FOR"! 	  IS_Dir.FOR (Checks .DIR files)o 	  SDMacros.MAR							  