Welcome to ATG_EVE. Keying PF2 or HELP will give you a keypad layout. Keying GOLD/PF2 or GOLD/HELP will give a list of all defined keys. Add the line: $ EDT == "Edit/TPU/Section=ATG_EVE" to your LOGIN.COM or SYS$MANAGER:SYLOGIN.COM. Below is a copy of the AAAREADME.TXT from this directory. Read it, and experiment with the various commands as you read that section... I would be glad to receive user feedback on ATG_EVE so that I can enhance it. ! Description ! =========== ! ! ATG_EVE is an EVE "product" that implements a version of the "EDT standard" initialiser. When built into ! a product and, invoked as described below, the user is presented with an editor that is VERY similar to EDT. ! All the key definitions that the user would expect are there, including those from the "standard initialiser". ! However, all of EVE is also there, so if you want any EVE functions, they are also available. ! We find that this is a very good way of weaning users from EDT onto EVE and real TPU. ! ! The extra functions (on top of the EDT keypad) are: ! ! GOLD . Insert special marker. ! Inserts a marker of the form "~~/\~~" into the text that GOLD / can locate. You can define the ! symbol "atg$x_text_marker" in your initialisation file to some other string, if you wish. ! GOLD / Locate and remove sepcial marker. ! GOLD $ Spawn a sub-process. ! Suspends the editing session and transfers control of the terminal to the sub-process. ! When you log out, the editing session resumes. ! GOLD ^ Execute a single DCL command and include the output in the current buffer. ! Very useful for including DIRECTORY output etc. ! GOLD B Switch to specified buffer. If the buffer does not exist, it is created. If you type ! to the prompt, you will be given a menu of available buffers to switch to (see GOLD S below). ! GOLD I Include a file into the named buffer. The default for the buffer name is the FILENAME.TYPE ! of the included file. If a "." is specified at the end of a buffer name, then the file is included ! at the current editing position in that buffer, otherwise the file is included at the start of ! the buffer. You may specify wildcards in the include specification. ! GOLD L Switch to last used buffer. Very useful for "toggling" between buffers. ! GOLD M Switch to the "MAIN" buffer. ! GOLD O Output the specified buffer to a file. The default is to use the current buffer. The defaults ! for the filename are SYS$DISK:[]BUFFERNAME ! GOLD P Protect the specified buffer. Using GOLD P toggles the "un-modifiable" bit on the specified buffer. ! GOLD Q Quit from the editor. If you have modified any writeable buffers, then you will be asked if you ! really mean to quit. ! GOLD R Make buffer read-only. The default is to use the current buffer. This prevents the specified ! buffer from being written to a file when the editor exits. Use with caution. ! GOLD S Show buffer list. The list of available buffers is displayed as a menu. You can use the UP-ARROW ! (or PREV_SCREEN) and DOWN-ARROW (or NEXT_SCREEN) keys to select a buffer, and SELECT, ENTER or RETURN ! to switch to that buffer. The default menu position is to select the current buffer. The selected buffer ! name is highlighted as you move the menu position. ! The first three characters in the menu line are: ! Character Meaning ! R Buffer is read-only (will not be written when the editor exits). ! W Buffer will be written when the editor exits. ! M Buffer contents has been modified since it was created. ! = Buffer is the "current" buffer. ! If the filename field contains a name in brackets, eg. (USER_ROOT:[NICK]LOGIN.COM), then the name ! is that of the last file included into the buffer (eg. with GOLD I), otherwise the filename field contains ! the name of the file, if any, that will be generated when the editor exits. ! GOLD V Show the version of this file. ! GOLD W Make buffer writeable. The default is to use the current buffer. You will be asked for the name of ! the file that you wish the specified buffer to be written to when the editor exits. The default filename ! is SYS$DISK:[]BUFFERNAME. eg. if your buffer is called FRED.FLINT, then the file generated will be ! SYS$DISK:[]FRED.FLINT ! ! GOLD CTRL/G Replace the SELECT region with the contents of the specified buffer. ! CTRL/G Paste the specified buffer into the current buffer (include it at the current position). ! GOLD CTRL/P Cut the SELECT region to the specified buffer. ! CTRL/P Copy the SELECT region to the specified buffer. ! GOLD CTRL/W Toggle screen width between 80 and 132 columns. The editor comes up in 132 column mode by default. ! Include the line "tpu atg$set_screen_width(80)" in your EVE initialisation file (normally called ! SYS$LOGIN:EVE$INIT.EVE). Alternatively include "atg$set_screen_width(80)" in your TPU command file ! (normally called TPU$COMMAND.TPU). See below for a discussion on how to find out more about EVE and ! TPU initialisation files. If you are on VAXstation using UIS$EMULATORS for your TPU window, you can ! specify any width to "atg$set_screen_width()" (within reason!). ! F7 As CTRL/G (insert buffer) ! GOLD F7 As GOLD CTRL/G (replace select with buffer) ! F8 As CTRL/P (copy select to buffer) ! GOLD F8 As GOLD CTRL/P (cut select to buffer) ! F17 Make the next window the current window (if there is more than 1 window on the screen). This is the ! same as the EVE NEXT WINDOW command. ! GOLD F17 Toggle between 1 or 2 windows on the screen. This does an EVE SPLIT_WINDOW 2 command if there is only ! one window on the screen, else it does an EVE ONE WINDOW command. ! F18 Insert EVE style named marker. This differs from GOLD . in that you are asked for the name of ! the mark. The mark can lie in any buffer, and any number of marks can co-exist. If you enter a ! name that is already in use, the previous mark for that name is deleted. Note that marks entered ! via F18 are lost when the editor is left. Similar to an EVE MARK name command. ! GOLD F18 Locate and move to an EVE style named marker. This command also locates marks entered by key F18. ! the buffer that the mark is located in is mapped to the current window. Similar to an EVE GO TO name ! command. ! F19 Insert the current date in the form "DD-Mmm-YY". If the day is in the range 1 to 9, a leading "0" is ! included. ! GOLD F19 Insert the current time in the form "HH:MM". ! ! Note that using GOLD HELP or GOLD PF2 will give an on-line list of keys including those specified above, and that HELP ! (or PF2) will generate a keypad diagram including the above additions. ! ! Building and Invoking ATG_EVE ! ============================= ! ! This file contains an EVE "product" that is build using EVE$BUILD under VMS V5 as follows (see ATG_EVE.COM): ! ! $ Edit/Tpu/NoDisplay/Section=EVE$SECTION/Command=SYS$EXAMPLES:EVE$BUILD/NoInit ATG_EVE ! ! The resulting section is invoked as follows: ! ! $ Edit/Tpu/Section=dev:[dir]ATG_EVE [/Command=init-file.TPU] [/INITIALIZATION=init-file.eve] file-name.type ! ! or, for old die-hards... ! ! $ Edt == "Edit/Tpu/Section=dev:[dir]ATG_EVE" ! $ Edt filename.type ! ! We place the EDT definition in the SYS$SYLOGIN command file, and always move the section to SYS$COMMON:[SYSLIB] (see INSTALL.COM). ! ! For more information on TPU and EVE initialisation command files, refer to the VMS V5 manual ! "Volume 5B (General User) Processing Text, VAXTPU Program Development", section 5.4 (VAXTPU Startup Files) and section ! 5.4.4 (EVE Initialisation Files). ! ! Note that under VMS V5 the section can be INSTALLed (see INSTALL.COM), eg. ! ! $ Install Create Sys$Library:ATG_EVE.TPU$SECTION /Open /Header_Res /Shared ! ! INSTALLing the section shared is highly recommended. Major performance benifits can be gained on systems which have more ! than one user using this editing section. ! Nick de Smith Applied Telematics Group 7 Vale Avenue Tunbridge Wells Kent TN1 1DJ England +44 892 511000