EnvE-v110-0 =================================================================== ENVED An Environment Editor Version 1.10 (C) Copyright IBM Corporation 1987, 1993 (C) Copyright IBM Corporation 1987, 1993 ------------------------------------------------------------------- Version 1.10, December 1993 This program was written by: Tim Baldwin IBM UK Laboratories Hursley Park Winchester Hampshire, SO21 2JN BALDWINT at WINVMB baldy@vnet.ibm.com (C) Copyright IBM Corporation 1987, 1993. All Rights Reserved. ------------------------------------------------------------------- Page i (C) Copyright IBM Corporation 1987, 1993 CONTENTS 1.0 Introduction . . . . . . . . . . . . . . . . . . . . . . . 1 1.1 What Is ENVED? . . . . . . . . . . . . . . . . . . . . . 1 1.2 What You Need . . . . . . . . . . . . . . . . . . . . . . 1 1.3 Using ENVED . . . . . . . . . . . . . . . . . . . . . . . 2 1.3.1 Installing The Editor . . . . . . . . . . . . . . . . 2 1.3.2 Starting The Editor . . . . . . . . . . . . . . . . . 2 1.3.3 Making Changes . . . . . . . . . . . . . . . . . . . . 2 1.3.4 Ending The Editor . . . . . . . . . . . . . . . . . . 3 1.4 Keyboard Summary . . . . . . . . . . . . . . . . . . . . . 3 Contents ii (C) Copyright IBM Corporation 1987, 1993 1.0 INTRODUCTION 1.1 WHAT IS ENVED? ENVED is program to allow you to edit the environment strings associated with an OS/2 process. The environment consists of a set of variable names each variable having a simple text string value. Programs running in that OS/2 process may examine the environment and obtain the value of one or more of these environment variables. Such programs often use the values they obtain to tailor their behaviour for an individual user. Many environment variables are established and given initial values as OS/2 starts up and processes its CONFIG.SYS file. The environment can be displayed by issuing the SET command from and OS/2 command prompt, the result shows the variables and their associated values and looks something like this: COMPSEC=C:\OS2\CMD.EXE PATH=C:\OS2;C:\OS2\SYSTEM;D:\TOOLS DPATH=C:\OS2;C:\OS2\SYSTEM etc. The SET command can also be used to add new environment variables, to remove variables and to replace an existing variable's value. However these values are often quite lengthy and rather than replacing the entire value you may just want to make a few small changes, this is where an Environment Editor such as ENVED proves useful. ENVED may be particularly useful to program developers, since most compilers make extensive use of environment variables to control the characteristics of the compilation process. ENVED makes altering those environment variables for debugging, testing or experimentation very simple. 1.2 WHAT YOU NEED ENVED will run under IBM's OS/2 2.0 or any later version and requires that REXX is installed (which is the default). It should also run under IBM's OS/2 1.3 or 1.2 Extended Edition, but these older systems have not been fully tested. ENVED is supplied as a single file ENVED.ZIP. This should be unpacked using PKUNZIP to give: ENVED.CMD This is a REXX program to run the editor. ENVED.DLL This a library of functions required by the REXX program. Introduction 1 (C) Copyright IBM Corporation 1987, 1993 ENVED.DOC This is the full documentation in a plain ASCII printable format. In addition the package will contain the following important file: LICENSE.TXT This contains the terms and conditions under which IBM makes this program available. 1.3 USING ENVED 1.3.1 INSTALLING THE EDITOR Simply ensure that ENVED.CMD is placed in a subdirectory that is listed in your PATH and that ENVED.DLL is placed in a subdirectory that is listed in your LIBPATH. 1.3.2 STARTING THE EDITOR From an OS/2 full screen or windowed command session enter the following command at the OS/2 prompt: ENVED ... You can put any number, including zero, of environment variable names after the ENVED command. Each variable that you specify will be presented in a full screen edit panel (one variable per line) together with its current value. If any of the variables are currently not set they will be displayed with a blank value. If you do not specify any variable names the a complete copy the the current environment will be displayed. The list of environment variables is always initially displayed sorted into alphabetical order. 1.3.3 MAKING CHANGES You may move the cursor anywhere between the "Top of Environment" and "End of Environment" markers using the cursor control keys and you may make any changes you wish. The editor starts in "replace" mode whereby any characters you type overwrite those already present, you may toggle to "insert" mode by pressing the Ins or Insert key. The current mode is indicated by the size of the cursor. You may change the value of any environment variable by altering the text to the right of the "=" sign, or you may change the name of the variable to the left of the "=" sign (or you may change both). If you change a variable's name this will effectively add a new variable leaving the old one unchanged. Introduction 2 (C) Copyright IBM Corporation 1987, 1993 To add a new environment variable either press Ctrl-Enter to add a blank line and the type both the variable name and its value, or choose the existing variable that most closely matches the new one, press Alt-R to duplicate it, then make the required changes. To remove an environment variable you must set its value to nothing, like this: VARIABLE= The Alt-T (truncate line) key is useful for doing this. Note: Pressing Ctrl-Backspace (delete line) simply removes a variable from the list currently being edited; it does not delete the variable or its value from the environment. 1.3.4 ENDING THE EDITOR To end ENVED and return to the OS/2 command prompt press either F3 or F10. - F3 will discard any changes you made, leaving the environment settings exactly as they were before ENVED was invoked. - F10 will update the current environment with all the changes you made. 1.4 KEYBOARD SUMMARY The following lists all the editing key actions that are available in ENVED. These keys are similar to those used by the TINYED editor, although only a subset of TINYED's keys are provided. Right Move the cursor one character to the right. Left Move the cursor one character to the left. Up Move the cursor up one line. Down Move the cursor down one line. Ctrl-Right Move the cursor forward to the start of the next word. Ctrl-Left Move the cursor back to the start of the previous word. Tab Move the cursor forward to the next tab position (tabs are every eight columns). Shift-Tab Move the cursor back to the previous tab position Introduction 3 (C) Copyright IBM Corporation 1987, 1993 (tabs are every eight columns). Home Move the cursor to the start of the current line. End Move the cursor to the end of the current line. Ctrl-Home Move the cursor to the top of the list of environment variables. Ctrl-End Move the cursor to the end of the list of environment variables. Page Up Scroll the list of environment variables up by one screenful. Page Down Scroll the list of environment variables down by one screenful. Enter Move the cursor down one one and back to the start of the line. Ctrl-Enter Add a new blank line to the list of environment variables. Backspace Delete the character to the left of the cursor. Ctrl-Backspace Remove the current environment variable from the list being edited. Delete Delete the character at the cursor position. Insert Toggle between "replace" "insert" typing mode. Alt-J Join the next line to the end of the current line. Alt-R Repeat the current line (insert a new copy of the current environment variable into the list). Alt-S Split the current line at the cursor position. Alt-T Truncate the current line (delete all the characters from the cursor position to the end of the line). F1 Display some help information; press Esc to remove the help panel. F3 Quit the editor without making any changes. F10 Update the environment will all the changes made. Others You can also enter any ASCII character by holding down the Alt key, typing the character's ASCII value (in decimal, from 1 to 255) on the numeric keypad and releasing the Alt key. Introduction 4 (C) Copyright IBM Corporation 1987, 1993 Introduction 5 =================================================================== =================================================================== (C) Copyright IBM Corporation 1987, 1993 Printed in the U.K.