home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Professional
/
OS2PRO194.ISO
/
os2
/
systools
/
enved
/
enved.doc
< prev
next >
Wrap
Text File
|
1993-12-09
|
12KB
|
570 lines
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 <var1> <var2> ...
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.
