Don Amby's SYS$LOGIN Environment V1.0-7 --------------------------------------- Donald E. Amby Delco Systems Operations P.O. Box 471, M/S 1A21 Milwaukee, WI 53201 (414)768-2682 or (414)281-1296 Amby%Wizard.GM@Hac2Arpa.Hac.Com (Internet) AMBY (DECUServe) AMBY (DCS) This directory is the root of my (Don Amby) login environment, which has a LOGIN.COM file that is run at login time. There is also a SETUP.COM file that defines all of my logical names, global symbols, keys, etc. that define my working environment. These were designed to function on the VAXcluster where I do all of my real work, and these files expect certain things to be defined (in the system logical name table). 1 Backgound Many years ago I adopted the convention of making software tools available as part of a set of tools, which I refer to as a 'toolkit'. Basically, a toolkit refers to a directory somewhere in the file system where there is to be found a SETUP.COM file that you can run. Running this SETUP.COM file will then define all that you need to make the tools in the toolkit available. This typically means the definition of logical names (in order to point to files, directories, etc.) and global symbols (to run *.COM or *.EXE files that implement a tool). In addition, sometimes it may use a Command Definition Utility (CDU) to define new DCL command verbs (with the SET COMMAND and a *.CLD file). Much of this philosophy is the result of some of the good things that I have seen on numerous DECUS SIG tapes. A goal of mine has always been to make tools as portable as possible, across VAX/VMS systems (running the same version of VMS). I currently am running VMS V5.3-1, so I would expect everything to work on similar systems. 2 Setting Up In order to set up my environment and tools you need to run the LOGIN.COM file, which will in turn run the SETUP.COM file (and all other DCL command procedures). LOGIN.COM My login command procedure. SETUP.COM Overall setup for this set of tools. SETLOGS.COM Defines logical names (AMBY$ROOT based). SETSYMBS.COM Defines global symbols. SETKEYS.COM Defines DCL keys. The following is all that is necessary on the system where I work, and have all of these files. $ @LOGIN If you are not running these from the system where I maintain this stuff, then you will need to do something special. $ @LOGIN $ [.RUN]SETUP $ @LOGIN 3 Directories The following subdirectories can be found below this directory. [.CDD] My CDD dictionary (for DATATRIEVE stuff). [.DATA] Data files used to drive the environment. [.DECUS] DECUS related stuff. [.DEV] Development areas for collections of tools. [.DOC] Documentation related to tools, etc. [.EXE] Executables (*.COM,*.EXE,*.OBJ,*.OLB) for tools. [.HELP] Help library (and help sources) for tools. [.ISEE] ISEE tools personal working area. [.NOTES] VAX Notes related files and tools. [.RUN] Run-time area for my toolkits. [.SITE] Site specific definitions. [.TEMP] Temporary files directory (my SYS$SCRATCH). [.TOOLKITS] Various collections of older tools that I am in the process of replacing. 4 Getting Help After you have run the SETUP.COM file you can get help on my personal tools and environment with the AMBYHELP command. $ AMBYHELP 5 SIG Tape Submission This section is a discussion of what is contained in the LZW compressed saveset that is in this directory along with this file. As such you will need to decompress it using the LZDCMP tool, in order to recover the backup saveset. Then you will need to use BACKUP in order to get individual files. 5.1 Saveset Directories The following is a complete listing of every directory that is in the LZW compressed saveset file that is part of this submission. Some of the directories are empty, and can be ignored. These inadvertently made it into the submission. [AMBY] Top directory, that is my actual SYS$LOGIN. [AMBY.CDD] My CDD dictionary (for DATATRIEVE stuff). [AMBY.DATA] Data files used to drive the environment. [AMBY.DECUS] DECUS related stuff. [AMBY.DECUS.LT_SIG] Languages & Tools SIG development area. [AMBY.DECUS.LT_SIG.CMS] DEC/CMS library for L&T SIG Folder, etc. [AMBY.DECUS.LT_SIG.WRK] Work directory for building the L&T SIG Folder, etc. [AMBY.DEV] Development areas for collections of tools. [AMBY.DEV.AMBY] AMBY product development area (for my personal set of tools). [AMBY.DEV.AMBY.WRK] Work directory where I build my personal tools. [AMBY.DEV.BASETOOLS] BASETOOLS product development area. [AMBY.DEV.BASETOOLS.WRK] Work directory for building BASETOOLS. [AMBY.DEV.CMTOOLS] Configuration Management toolkit development area. [AMBY.DEV.CMTOOLS.WRK] Work directory for building CMTOOLS. [AMBY.DEV.COMMON] Common modules, tools, libraries development area. [AMBY.DEV.COMMON.WRK] Work directory for building COMMON tools. [AMBY.DEV.DCS] DCS site specific development area. [AMBY.DEV.DCS.WRK] Work directory for building DCS product. [AMBY.DEV.DECUSERVE] DECUServe site specific development area. [AMBY.DEV.DECUSERVE.WRK] Work directory for building DECUSERVE product. [AMBY.DEV.DECUSTOOLS] DECUS toolkit developement area (how I package DECUS tools into a toolkit). [AMBY.DEV.DECUSTOOLS.WRK] Work directory for building DECUSTOOLS product. [AMBY.DEV.DOCTOOLS] Documentation toolkit development area. [AMBY.DEV.DOCTOOLS.WRK] Work directory for building DOCTOOLS product. [AMBY.DEV.EDIT] My personal editing environment development area. [AMBY.DEV.EDIT.WRK] Work directory for building EDIT product. [AMBY.DEV.SITE] Template for site specific stuff. [AMBY.DEV.SITE.WRK] Work directory for building SITE product. [AMBY.DEV.TESTTOOLS] Beta test tools toolkit development area. [AMBY.DEV.TESTTOOLS.WRK] Work directory for building TESTTOOLS product. [AMBY.DEV.TEXTOOLS] TeX/LaTeX toolkit development area. [AMBY.DEV.TEXTOOLS.WRK] Work directory for building TEXTOOLS product. [AMBY.EXE] Executables (*.COM,*.EXE,*.OBJ,*.OLB) for my own personal tools. [AMBY.HELP] Help library (and help sources) for my personal tools. [AMBY.NOTES] VAX Notes related files and tools. [AMBY.RUN] Run-time area for my toolkits. [AMBY.RUN.BASETOOLS] Basic toolkit of tools that are used by lots of other tools [AMBY.RUN.BASETOOLS.DATA] Toolkit data files. [AMBY.RUN.BASETOOLS.DOC] Toolkit documentation files. [AMBY.RUN.BASETOOLS.EXE] Toolkit executable files. [AMBY.RUN.BASETOOLS.HELP] Toolkit help library and related help files. [AMBY.RUN.CMTOOLS] Configuration Management toolkit. [AMBY.RUN.CMTOOLS.DATA] Toolkit data files. [AMBY.RUN.CMTOOLS.DOC] Toolkit documentation files. [AMBY.RUN.CMTOOLS.EXE] Toolkit executable files. [AMBY.RUN.CMTOOLS.HELP] Toolkit help library and related help files. [AMBY.RUN.DECUSTOOLS] DECUS toolkit, which is how I make tools from DECUS SIG tapes available. [AMBY.RUN.DECUSTOOLS.DATA] Toolkit data files. [AMBY.RUN.DECUSTOOLS.DOC] Toolkit documentation files. [AMBY.RUN.DECUSTOOLS.EXE] Toolkit executable files. [AMBY.RUN.DECUSTOOLS.HELP] Toolkit help library and related help files. [AMBY.RUN.DOCTOOLS] Documentation development toolkit, to help in building complex RUNOFF documents. [AMBY.RUN.DOCTOOLS.DATA] Toolkit data files. [AMBY.RUN.DOCTOOLS.DID] Toolkit data item descriptions (document templates). [AMBY.RUN.DOCTOOLS.DOC] Toolkit documentation files. [AMBY.RUN.DOCTOOLS.EXAMPLES] Toolkit example files. [AMBY.RUN.DOCTOOLS.EXE] Toolkit executable files. [AMBY.RUN.DOCTOOLS.HELP] Toolkit help library and related help files. [AMBY.RUN.EDIT] My editing environment toolkit, that sets up my LSEDIT environment and other TPU stuff. [AMBY.RUN.EDIT.DATA] Toolkit data files. [AMBY.RUN.EDIT.DOC] Toolkit documentation files. [AMBY.RUN.EDIT.EXE] Toolkit executable files. [AMBY.RUN.EDIT.HELP] Toolkit help library and related help files. [AMBY.RUN.SITE] Site specific toolkit, that is where I can tailor the environment to run my tools. [AMBY.RUN.SITE.DATA] Toolkit data files. [AMBY.RUN.SITE.DOC] Toolkit documentation files. [AMBY.RUN.SITE.EXE] Toolkit executable files. [AMBY.RUN.SITE.HELP] Toolkit help library and related help files. [AMBY.RUN.SITE.MAIL] Site specific common mail distribution list area. [AMBY.RUN.TESTTOOLS] Beta test toolkit, which is where most tools are initially released for use. [AMBY.RUN.TESTTOOLS.DATA] Toolkit data files. [AMBY.RUN.TESTTOOLS.DOC] Toolkit documentation files. [AMBY.RUN.TESTTOOLS.EXAMPLES] Toolkit example files. [AMBY.RUN.TESTTOOLS.EXE] Toolkit executable files. [AMBY.RUN.TESTTOOLS.HELP] Toolkit help library and related help files. [AMBY.RUN.TESTTOOLS.INCLUDE] [AMBY.RUN.TESTTOOLS.TEMPLATE] [AMBY.RUN.TESTTOOLS.TEST] [AMBY.RUN.TEXTOOLS] TeX and LaTeX toolkit, which contains stuff used to access TeX on our system. [AMBY.RUN.TEXTOOLS.DATA] Toolkit data files. [AMBY.RUN.TEXTOOLS.DOC] Toolkit documentation files. [AMBY.RUN.TEXTOOLS.EXE] Toolkit executable files. [AMBY.RUN.TEXTOOLS.HELP] Toolkit help library and related help files. [AMBY.RUN.TEXTOOLS.LOCAL] Local version of TEX_INPUTS files. [AMBY.SITE] Site specific definitions. [AMBY.SITE.DCS] Site specific stuff that I use to tailor my tools to use on DCS system. [AMBY.SITE.DECUSERVE] Site specific stuff that I use to tailor my tools to use on DECUServe system. [AMBY.TEMP] Temporary files directory (my SYS$SCRATCH). [AMBY.TOOLKITS] Various collections of older tools that I am in the process of replacing. [AMBY.TOOLKITS.FILETOOLS] Software tools related to file manipulations. [AMBY.TOOLKITS.FILETOOLS.DATA] Toolkit data files. [AMBY.TOOLKITS.FILETOOLS.EXE] Toolkit executable files. [AMBY.TOOLKITS.FILETOOLS.HELP] Toolkit help related files. [AMBY.TOOLKITS.MISCTOOLS] Miscellaneous software tools collection. [AMBY.TOOLKITS.MISCTOOLS.DATA] Toolkit data files. [AMBY.TOOLKITS.MISCTOOLS.DOC] Toolkit documentation files. [AMBY.TOOLKITS.MISCTOOLS.EXE] Toolkit executable files. [AMBY.TOOLKITS.MYTOOLS] This is an old collection of tools that were originally for my private use. [AMBY.TOOLKITS.MYTOOLS.DATA] Toolkit data files. [AMBY.TOOLKITS.MYTOOLS.EXE] Toolkit executable files. [AMBY.TOOLKITS.MYTOOLS.HELP] Toolkit help library and help related files. [AMBY.TOOLKITS.MYTOOLS.UTILS] Toolkit executables (this was used before I got in the habit of [.EXE] directories).