INSTALLATION INSTRUCTIONS WPELSE Editor Version 1.1 (WPS+ Interface for LSE) Includes the MORE utility August, 1987 The WPELSE editor is similar to WPS-PLUSTM. It provides the same interface as WPS-PLUS and contains all the functionality of LSE as well. It matches WPS-PLUSTM where practical, and provides several extended capabilities. WPELSE works on VMS version 4.5 and has not been tested on other versions. Also, WPELSE works only on version 2.0 of LSE and not on version 1.2 (this is due to a change of key lists in version 2.0) These installation instructions are intended for the system manager. Separate user documentation is provided. Contents of the Distribution Directory WPELSE.TPU The source file of .TPU code for building WPELSE. EVELSEMOD.TPU The source file of .TPU code for building EVELSEMOD. WPELSE.TPU$SECTION The compiled section file for WPELSE. EVELSEMOD.TPU$SECTION The compiled section file for EVELSEMOD. WPELSE.HLP Help module to be added to SYS$COMMON:[SYSHLP]TPUHELP.HLB WPELSE.COM Command file for WPELSE. MORE.COM Command file for MORE. BUILD_WPELSE.COM Master command file for building WPELSE and Help files BUILD_WPELSEMOD.COM Command file for re-building WPELSE.TPU$SECTION from WPELSE.TPU BUILD_EVELSEMOD.COM Command file for rebuilding EVELSE.TPU$SECTION from EVELSE.TPU INSTALL_FRAGMENT.COM How to install WPELSE.TPU$SECTION global, if desired. INSTALL_WPELSE_ON_CLUSTER.COM Automatic installation across a cluster. INSTALL_WPELSETPU.COM Companion to the above. SYSDEFS_FRAGMENT.COM Definitions to execute at SYLOGIN. SPECIAL.CHARS Test file (includes characters 0-255). MAILEDIT.COM Command file used to set WPELSE as your MAIL editor. VARIOUS DOCUMENTATION Described below. As might be expected, all of the .COM files contain a LOCAL definition for the location of WPELSE and will need to be changed to suit your particular situation. Trying WPELSE without installation The following command will test-drive WPELSE without installing it, but without the checks and features provided by WPELSE.COM. Note that a full disk-and-directory path is required for the TPU$SECTION (TPU otherwise assumes a location). Note also that on-line Help will not be available. LSE/tpu/section=disk:[directory]wpelse.tpu$section test.filename Installing WPELSE and MORE These instructions are valid for VMS 4.5 1. Place all of these files in a directory of your choice. It will be assumed that you place a copy of WPELSE.HLP in SYS$COMMON:[SYSHLP]. 2. Use your previously-favorite editor to edit WPELSE.COM and MORE.COM. In both files, bracketed by LOCAL/END LOCAL, you will find: $ ! LOCAL - LOCAL - LOCAL - LOCAL - LOCAL - LOCAL - LOCAL - LOCAL $ ! $ define wpelse_dir lanl$utility:[wpelse] $ ! $ ! END LOCAL - END LOCAL - END LOCAL - END LOCAL - END LOCAL Change this line in both files to point to your chosen location. 3. Set your default to SYS$COMMON:[SYSHLP] and do the following: Lib/Replace TPUHELP.HLB WPELSE.HLP The first time you do this, a new module (WPELSE.HLP) will be added to the help library for TPU. 4. In your SYLOGIN.COM sequence, add the following lines (modified to point to your chosen location): $ MORE :== @LANL$UTILITY:[WPELSE]MORE $ WPELSE*DIT :== @LANL$UTILITY:[WPELSE]WPELSE $ WPELSE_LASTFILE :== "" 5. Optionally, for efficiency, you may install the global section associated with WPELSE and MORE. Modify the following to point to the appropriate location. LANL$UTILITY:[WPELSE]WPELSE.TPU$SECTION/OPEN/SHARE/HEADER The command may be issued to INSTALL, and should also be put in your SYSTARTUP.COM sequence. 6. Test the installation by typing WPELSE filename and/or MORE filename(s). Using WPELSE as your MAIL editor WPELSE can be used as your MAIL editor by first placing MAILEDIT.COM in your directory with your login.com file. Place the following lines in your LOGIN.COM file: $ Define mail$edit mailedit.com $ mail :== "mail/edit" These two commands tell MAIL to look for a command file named MAILEDIT.COM and allow mail to come up in the edit mode. Previous and future versions of VMS The WPELSE.TPU$SECTION supplied will work on VMS versions 4.4 and 4.5, and possibly future versions. When Digital decides to change TPU (again), it may be necessary to re-compile WPELSE. If you are still using VMS version 4.3 or 4.2, you will certainly need to re-compile (and may want to change the name to WPELSE.GBL to conform to earlier Digital convention). Of course, when you want to make modifications to WPELSE, you will need to re-compile both EVELSEMOD and WPELSE. The procedure BUILD_WPELSE.COM is provided to do this. It assumes that you want the saved section files to be placed in your current directory. Modifications can also be made to EVELSEMOD.TPU which provides windowing and other functions. The procedure BUILD_EVELSEMOD.TPU is provided to do this. Again the saved section is placed in your current directory. Options in the WPELSE source There are at least 3 WPELSE "behaviors" which you might choose to change. All of these are documented in the WPELSE.TPU source, and can be found by searching for the word LOCAL (in upper case): 1. The KP3 key is defined as "Exit" for compatibility with DM (which is also on this distribution). You may wish to define KP3 as "Upper Case" (which is now available as KP6). In addition, PF3 ("Delete Word") has some special characteristics - you may prefer the standard meaning. 2. Scrolling is defined so that the cursor stays near the middle of the screen, and the screen scrolls only every few lines. If you prefer to have the screen scroll a line at a time, this feature may be removed. 3. The cursor now remains within the confines of existing lines. This causes the cursor to sometimes jump around when you move up or down in a file. An option is provided for a "free" cursor. Documentation Both a users' guide and an installer's guide are available. The documentation in this directory is available in three forms: .TXT files should be printable on any printer. .WPL files can be imported into WPS-PLUS (TM). Coming Attractions We plan to add a calculator function ( #) to WPELSE for the next release. Other functions may be added by user request. Comments, Bugs, Suggestions: Mike Boorman, Dale E. Coy or Karl Nielsen Los Alamos National Laboratory Group MEE-8, MS/J957 PO Box 1663 Los Alamos, NM 87545 (505) 667-7159 FTS 843-7159