Category : Batch File Utilities - mostly for DOS
Archive   : [email protected]
Filename : ENVI-MAN.DOC

€ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
€ Å¿ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ
Éλ Á
кР¿
ÉÊ» Á
Ð Ð

±±±±±±±±Ü ±±Ü ±±Ü ±±Ü ±±Ü ±±Ü ±±Ü ±±Ü ±±Ü ±±Ü ±±Ü
±±Ûßßßßßß ±±±Ü ±±Û ±±Û ±±Û ±±Û ±±±Ü ±±±Û ±±±±Ü ±±±Ü ±±Û
±±±±±±±±Ü ±±Û±±Ü±±Û ±±Ü ±±Ûß ±±Û ±±±±±±Ü ±±±Û ±±±Û ±±Ûß±±Ü ±±Û±±Ü±±Û
±±Ûßßßßßß ±±Û ß±±±Û ±±±±Ûß ±±Û ßßßßßß ±±Û±±Ü±±Û ±±±±±±Û ±±Û ß±±±Û
±±±±±±±±Ü ±±Û ±±Û ±±Ûß ±±Û ±±Û±±Û±±Û ±±Ûßßß±±Ü ±±Û ±±Û
ßßßßßßßß ßß ßß ßß ßß ßß ßß ßß ßß ßß ßß ßß




Welcome to ENVI-MAN, a utility program to assist in analyzing and managing the
Environment data!














ßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßß

U S E R M A N U A L

Version 1.0

Release April 26, 1991

ÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜ

Copyright 1991-1992 by Micrometric.
All rights reserved.

ENVI-MAN is distributed as SHAREWARE and, as such, may be copied and shared on a
private non-commercial basis with others in its unmodified form. Liability is
limited to replacing the software for registered users. There is no liability
for any damage or loss caused by this software, directly or indirectly.
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ ÚÄÄÄÄÄÄÄ¿ ³Û
³ ÚÄÄÄÄÁÄÄ¿ ³ (R) ³Û
³ Äij ³O ³ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³Û
³ ³ ÚÄÄÄÄÁÐÄ¿ ³ Association of ³Û
³ ³ ³ ³ÄÙ Shareware ³Û
³ ÀÄij O ³ Professionals ³Û
³ ÄÄÄÄij º ³ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³Û
³ ÀÄÄÄÐÄÄÄÙ MEMBER ³Û
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÛ
ÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛ

If you have problems with this program, or want to send comments, manual correc-
tions, or enhancement suggestions, you may call or mail them to:

Micrometric
98 Dade Avenue
Sarasota, FLorida 34232-1609 USA

Tech Support . . . (813) 377-2515
FAX . . . . . . . (813) 377-2091
Support BBS . . . (813) 371-2490

The Micrometric Software Support BBS provides availability and technical support
for the Micrometric þþþþ-MAN series of shareware programs. First time callers
have access to the board and can leave messages or download replies/current
shareware releases. Registered users may also download the latest Beta test
software releases, when available.

Additionally, you can send routed E-Mail via the RIME(tm) network to David
Groome at the ->ACTION node in the ASP, Laser, Batch, Common, or Shareware con-
ferences. I also check CompuServe (71631,744), but only on an infrequent basis.


PKZIP, PKUNZIP and PKSFX are trademarks of PKWARE, Inc.
MS-DOS is a registered trademark of the Microsoft Corporation.
IBM PC, XT, AT and PC-DOS are registered trademarks of the IBM Corporation.












2


TABLE OF CONTENTS


INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Major Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Manual Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Page layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Brackets and parentheses . . . . . . . . . . . . . . . . . . . . . . 5
Computer key conventions . . . . . . . . . . . . . . . . . . . . . . 5
Action steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
þþþþ-MAN programs . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Shareware distributed documentation manual . . . . . . . . . . . . . 6
Shareware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

INSTALLING THE SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . 9
From a Diskette Vendor . . . . . . . . . . . . . . . . . . . . . . . . . 9
From a BBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Registered Version . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

RUNNING ENVI-MAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Requested Environment Memory . . . . . . . . . . . . . . . . . . . . . . 15
Shareware message . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

MASTER AND PROGRAM
ENVIRONMENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Master Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Program Environment . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Master Environment Expansion . . . . . . . . . . . . . . . . . . . . . . 18

ENVI-MAN OPERATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Program Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Environment Data Display . . . . . . . . . . . . . . . . . . . . . . . . 22
Environment Space Remaining Display . . . . . . . . . . . . . . . . . . 23
Additional Environment Space Required Display . . . . . . . . . . . . . 23
Available Environment Space ERRORLEVEL calculation . . . . . . . . . . . 24

ENVI-MAN BATCH
FILE EXAMPLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25















3

TABLE OF CONTENTS ENVI-MAN Version 1.0























































4


INTRODUCTION

ENVI-MAN is a utility that accomplishes two major function. The first is the
ability to display all of the current environment strings and data about the
environment such as the location, size and space availability of the Master
environment. The second function is to let a batch file know how much environ-
ment space is currently available and to provide a graceful exit if there is not
enough. The routine may also show that, under certain circumstances, the size of
the master environment can be expanded with no change being made to the
CONFIG.SYS file.

Major Features

* Data display option showing each of the current environment strings along
with its length. Summary data on the Master environment size, current envi-
ronment size and available environment space is also shown.
* Single line summary display option of the available environment space as
reported by ERRORLEVEL.
* Sets the ERRORLEVEL variable to the available environment space for use in
testing within batch files.
* Option to calculate the available environment space with or without possible
free memory located above the master environment.
* Option to compare and test the available environment space with a requested
amount of needed environment memory.
* May be run from the DOS prompt to display data or from a batch file to test
available environment space.
* Written in assembler for fast operation and small size.

System Requirements

ENVI-MAN will run on an IBM PC, XT, AT or true compatibles. It has been tested
with PC-DOS/MS-DOS operating systems, version 3.0 through version 5.0.

Manual Format

This manual is divided into several introductory chapters followed by a chapter
for each ENVI-MAN function menu. The format of these chapters, and the informa-
tion presented therein, has been standardized using the following conventions.

Page layout - Each page has a header detailing the chapter and the program ver-
sion covered. A footer displays the manual page number.

Brackets and parentheses - Brackets, [...], are used in the manual and in the
help screens to specify what should be entered in response to the current
prompt. If a character string is to be entered, the type of character is noted,
such as ALPHA, NUMERIC, ANY, etc. Parentheses, (..), are used for comments.

Computer key conventions - Keys specified in the manual text that are not in
entry brackets are shown as reversed text, such as ESCAPE . All key references
are in capital letters for clarity.

Action steps - Some procedures may require selection from a menu of options,
inputting data, or following a sequence of operations. Most manual sections will
first give an overview of the function or task under discussion and then detail

5

INTRODUCTION ENVI-MAN Version 1.0

the various action operating procedures. In order to make this manual easier to
use, a symbol, -> , marks the beginning of each of these action operating proce-
dures.

þþþþ-MAN programs - The general group of shareware programs by Micrometric is
referred to by the name þþþþ-MAN. It may also be used in reference to a specific
program in that group.

Shareware distributed documentation manual - The documentation file included on
the shareware distribution diskette contains the same information as the printed
and bound manual, supplied as part of registration, with two exceptions, the
result of the word processor, formatting, and printer used. The first is that
all of the control display characters (ASCII 1-31) and the reverse print key-
board codes are NOT shown properly. Finally, bolding, underlining, and special
symbols are NOT present.

Shareware

ENVI-MAN is being distributed as SHAREWARE. The SHAREWARE concept allows users
to examine a program on a trial basis, at no (or minimal) charge, before pur-
chasing it. In addition, by decreasing marketing costs, professional quality
software may be distributed for a fraction of the cost of a comparable commer-
cial product. Regardless of whether you register the program, please help dis-
tribute ENVI-MAN by sharing unmodified copies of it and its files with others.

You are hereby granted the right to use the ENVI-MAN program for a thirty (30)
day evaluation period. If you find ENVI-MAN of value, and continue to use it
after this evaluation period, YOU MUST REGISTER YOUR PROGRAM USE. This will
provide you with:

* A 7" x 8 1/2" printed and bound manual.
* ENVI-MAN phone or mail support for one year.
* Notification of the next ENVI-MAN release.
* Ability to suppress the shareware registration reminder message displayed
at the end of the program.
* An installation/update/registration brand program.
* Sincere thanks for your support of the SHAREWARE concept.

A Single System Program Registration entitles the user to unlimited use of the
ENVI-MAN program on a single computer.

A Site License Program Registration entitles the user to unlimited use of the
ENVI-MAN program on all computers, including networks, at a single corporate
location.










6

ENVI-MAN Version 1.0 INTRODUCTION

Program Registration, Single System . . . $20.
Includes latest version diskette and manual
Program Registration, Site License . . . $200.
Includes latest version diskette and manual
Latest Version Diskette only . . . . . . $10.
Shipping - Surface (for outside of USA/Canada only)$5.
Shipping - Air (for outside of USA/Canada only)$10.
COD and credit card orders, add 5%
Florida residents, add 7% sales tax

ADDRESS: Micrometric
98 Dade Avenue
Sarasota, FLorida 34232-1609 USA

PHONE: Tech Support . . (813) 377-2515
FAX . . . . . . . (813) 377-2091
Support BBS . . . (813) 371-2490
Order Line . . . (800) 929-0184

For ease in program registration, a registration order form is included with the
distribution files.

This program is produced by a member of the Association of Shareware Profession-
als (ASP). ASP wants to make sure that the shareware principal works for you. If
you are unable to resolve a shareware-related problem with an ASP member by
contacting the member directly, ASP may be able to help. The ASP Ombudsman can
help you resolve a dispute or problem with an ASP member, but does not provide
technical support for members' products. Please write to the ASP Ombudsman at
545 Grover Road, Muskegon, MI 49442-9427, send a CompuServe message via easyplex
to ASP Ombudsman 70007,3536, or by FAX to the ASP FAX number: (616) 788-2765. In
communications with the Ombudsman please include a telephone number and/or FAX
if available.






















7

INTRODUCTION ENVI-MAN Version 1.0























































8


INSTALLING THE SYSTEM

From a Diskette Vendor

If the ENVI-MAN program has been obtained from a diskette vendor, you should
follow any of their instruction on unpacking/installing the programs (if indeed
they have separate instructions.) The program, and its files, is normally sup-
plied as a self extracting file whose name is "[email protected]" (xxx is the ver-
sion, such as "ENVI@100").

This file should first be copied to a directory on your hard disk. This direc-
tory may be a new one, such as one named "ENVI", and created specifically for
ENVI-MAN, or a current one, such as "UTILITY", that has other programs/files.
For information on creating a separate directory, see your DOS manual.

NOTE FOR BEST OPERATION, ALL REQUIRED ENVI-MAN FILES *SHOULD* BE PLACED ON
PATH REFERENCED SUBDIRECTORIES!

Once the file is copied to the desired hard disk directory, at the DOS prompt
change to this drive directory, and then type the EXE file name (such as
"ENVI@100") and press ENTER . This will unpack all of the ENVI-MAN files.

From a BBS

If the ENVI-MAN file was downloaded from a Bulletin Board, it should first be
copied to a directory as defined above, and then unpacked, using whatever pro-
gram is specified by the Bulletin Board. It is normally distributed with a name
of "[email protected]" (vvv is the version) or "ENVIMN.ZIP".

Registered Version

Registered users should use the program "INSTALL", that is supplied upon regis-
tration. This program will create a registration file which will, in turn, sup-
press the shareware registration reminders.

-> To install ENVI-MAN on your hard disk, follow the steps detailed below:

1. Place the ENVI-MAN distribution diskette in your floppy diskette drive.

2. At the DOS prompt, change to the drive in which the distribution diskette
is located. For example, if the diskette was placed in drive A, type A
: and press ENTER .

3. Type I N S T A L L and press ENTER . The installation pro-
gram will then be loaded, and its display should be as shown below.










9

INSTALLING THE SYSTEM ENVI-MAN Version 1.0

Õ͵ INSTallation MANagement Program/One System Started atÍ>07-31-92 03:00 Æ͸
³°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°³
³°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°³
³°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°³
³°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°³
³°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°³
³°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°³
³°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°³
³°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°³
³°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°³
³°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°³
³°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°³
³°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°³
³°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°³
³°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°³
³° °°Ü °°Ü °°Ü°°°°°°°°Ü°°°°°°°°Ü °°Ü °°Ü °°Ü °°Ü °°Ü°³
³° €Í °°Û °°°Ü °°Û°°Ûßßßßßß ßß°°Ûßßß °°Ü °°°Ü °°°Û °°°°Ü °°°Ü °°Û°³
³° ÚÅ¿ °°Û °°Û°°Ü°°Û°°°°°°°°Ü °°Û °°°Û °°°Û °°°Û °°Ûß°°Ü °°Û°°Ü°°Û°³
³° ÚÁ¿ °°Û °°Û ß°°°Û ßßßßß°°Û °°Û °°Û °°Û°°Ü°°Û °°°°°°Û °°Û ß°°°Û°³
³°ÍÁÍÁÍ°°Û °°Û °°Û°°°°°°°°Û °°Û °°°°Ü °°Û°°Û°°Û°°Ûßßß°°Ü°°Û °°Û°³
³° ßß ßß ßß ßßßßßßßß ßß ßßßß ßß ßß ßß ßß ßß ßß ßß°³
Ե INSTALL/1 Version 3.00 Copyright 1990-92 Micrometric, All Rights Reserved ƾ
F1>Help³ESC>Exit³ENTER/[char]>Select³ HomeEnd³

NOTE Context sensitive help is available from this point in the installa-
tion program on, by pressing the F1 key.

4. If a color video card is detected, the following prompt will be displayed.
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ É͵ Color Monitor Card Detected ÆÍ» ³
³ º Use the color display ºÛ ³
³ º Force a monochrome display ºÛ ³
³ ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ¼Û ³
³ ÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛ ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

-> If your system has a color monitor, press U .
-> If your system has a monochrome or LCD display, press F .

5. A selection list of all path referenced directories is next displayed.

NOTE FOR BEST OPERATION, ALL REQUIRED ENVI-MAN FILES *SHOULD* BE PLACED
ON PATH REFERENCED SUBDIRECTORIES!











10

ENVI-MAN Version 1.0 INSTALLING THE SYSTEM

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ ÚÄ´ Select the INSTALLATION DIRECTORY ÃÄ¿ ³
³ ³ C:\BAT ³Û ³
³ ³ C:\DOS-500 ³Û ³
³ ³ C:\UTILITY ³Û ³
³ ³ C:\ZIP ³Û ³
³ ³ C:\ ³Û ³
³ ³ User Defined Drive-Directory Path ³Û ³
³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÛ ³
³ ÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛ ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

-> To cancel the installation program at this point, press ESCAPE .
-> To select one of the path referenced directories on which to install
ENVI-MAN, move the highlight bar to the desired one and press ENTER .
-> To specify a non-path referenced directory on which to install
ENVI-MAN, press U and then press ENTER . A data entry window for the
installation path will then be displayed, as shown below (with an exam-
ple path already entered). Enter the desired drive and directory path
on which to install ENVI-MAN, using the control keys described on the
bottom help line.
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ ÚÄ´ Enter Path ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³
³ ³ C:\ENVI.......................................................... ³Û ³
³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÛ ³
³ ÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛ ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

-> To cancel defining the path, press ESCAPE . The program will return
to directory selection.
-> To accept the path as entered and edited, press ENTER . If the
specified directory does not currently exist, the following message
will be displayed.
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ ÚÄ´ MESSAGE ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³
³ ³ The drive-directory path as entered DOES NOT currently exist. ³Û ³
³ ³ This directory WILL NOW BE created. ³Û ³
³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÛ ³
³ ÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛ ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

-> To cancel creation of this directory, press ESCAPE .
-> To create the specified directory, press ENTER . If the speci-
fied drive is invalid or the requested installation directory's
parent does not exist, an error message will be displayed. Press
any key, and then re-edit the installation path.

6. If more than one system is available for installation, a SYSTEM TO INSTALL
selection menu will be displayed, as shown below.





11

INSTALLING THE SYSTEM ENVI-MAN Version 1.0

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ ÉÍÍ͵ Select the SYSTEM TO INSTALL ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» ³
³ º ENVI-MAN Environment data summary, environ. space remaining ºÛ ³
³ º FILE-MAN Menu driven DOS file manager, directory tree ºÛ ³
³ º LASR-MAN Print text files on a laser printer, 36 print styles ºÛ ³
³ º MENU-MAN Display custom user selection menus from batch files ºÛ ³
³ º PATH-MAN Determines if a file is on a PATH directory ºÛ ³
³ ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ¼Û ³
³ ÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛ ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

-> To terminate the installation program at this point, press ESCAPE .
-> To select the SYSTEM TO INSTALL, press its highlighted letter or move
the highlight bar to in with the arrow keys and press ENTER .

7. A list of all ENVI-MAN files is next displayed, along with an INSTALLATION
FUNCTION menu. The normal sequence of operations is to first "Install" the
ENVI-MAN program and files, and then "Brand" the system with your name and
serial number.
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ Õ͵ Select the INSTALLATION FUNCTION ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ͸ ³
³ ³ Install system Brand system eXit ³Û ³
³ ÔÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ¾Û ³
³ ÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛ ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³Õ͵ File Name Status Hard Disk Path/File Description ENVI-MAN FILES Æ͸ ³
³³ SystemÍ>ENVI-MAN Environment data summary, environ. space remaining ³Û³
³³ ENVI-MAN.COM PROCESS Utility program ³Û³
³³ YYYY.YYY PROCESS Other files ³Û³
³Ô͵ INSTALLATION PATHÍ>C:\ENVI ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ;۳
³ ÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

-> To install ENVI-MAN on the hard disk, insure that the highlight bar is
on the "INSTALL SYSTEM" FUNCTION and press ENTER . Each of the file(s)
will be copied to the selected installation drive-directory.

NOTE A happy face symbol after any of the system's file names de-
notes that this file is already on the hard disk. During in-
stallation it will be replaced, on the directory where it
currently resides, not the INSTALLATION DRIVE-DIRECTORY PATH.

When all files have been copied to the hard disk, a copy complete mes-
sage is displayed.








12

ENVI-MAN Version 1.0 INSTALLING THE SYSTEM

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ ÚÄ´ MESSAGE ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³
³ ³ FILE COPY COMPLETED. ³Û ³
³ ³ All of the required BOOK-IT! files are on the hard disk. ³Û ³
³ ³ ÍÍÍ> BOOK-IT! IS READY TO RUN. <ÍÍÍ ³Û ³
³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÛ ³
³ ÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛ ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

-> To cancel the installation at this point, press ESCAPE .
-> To continue with the installation, press any other key. The high-
light bar will then be on the "BRAND SYSTEM" FUNCTION.

8. -> To brand the system with your name and serial number, move the high-
light bar to the "BRAND SYSTEM" FUNCTION and press ENTER . A REGISTRA-
TION INFORMATION data entry window will be displayed, as shown below,
with sample data already entered.

NOTE This step is REQUIRED for ENVI-MAN to be registered. Also, if
you move the ENVI-MAN files to another drive-directory you
will need to "BRAND" the system again.

Enter your company and/or your name, and then the system registration
number. Your registration number is located on the back of the front
cover of this manual.
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ ÚÄ´ REGISTRATION INFORMATION ÃÄÄÄÄÄÄÄÄ¿ ³
³ ³ Name ABC COMPANY, George Jones ³Û ³
³ ³ Registration number 12345678 ³Û ³
³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÛ ³
³ ÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛ ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

-> To accept either the name or registration number after entry and
editing, press ENTER . A message will be displayed after the regis-
tration number is entered. It's contents are dependent on whether
the registration number is valid. Both messages are shown below.
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ ÚÄ´ MESSAGE ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³
³ ³ BOOK-IT! serial number entered is VALID. ³Û ³
³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÛ ³
³ ÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛ ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ ÚÄ´ MESSAGE ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³
³ ³ BOOK-IT! serial number entered is INVALID! ³Û ³
³ ³ Please try again. ³Û ³
³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÛ ³
³ ÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛ ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ



13

INSTALLING THE SYSTEM ENVI-MAN Version 1.0

-> To continue with the installation program, press any key. If the
registration number was valid, the "EXIT" option is highlighted.
If it was invalid, select the "BRAND SYSTEM" option again.

9. -> To exit from the installation program, move the highlight bar to the
"EXIT" FUNCTION and press ENTER . If the system has been properly
branded, the program will exit, and ENVI-MAN is ready for use. If the
system has not been branded, an error message is displayed, as shown
below.
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ ÚÄ´ MESSAGE ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³
³ ³ This system has not been 'BRANDED'. ³Û ³
³ ³ In order to be registered, it must first be 'BRANDED'! ³Û ³
³ ³ To exit without BRANDING, press ESCAPE. ³Û ³
³ ³ To continue with the INSTALL program, press any other key. ³Û ³
³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÛ ³
³ ÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛ ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ




































14


RUNNING ENVI-MAN

The syntax to execute the ENVI-MAN utility program is:

ENVI-MAN [option a] [option ...] [requested environment memory]

The command line options provide information to ENVI-MAN that will override the
default options that are in effect at the beginning of the program.

A space MUST be present after the program name and any command line parameters.
Spaces between options and requested environment memory are optional.

Options

none If no options or requested environment memory are specified ENVI-MAN will
display the program syntax.

+ Calculate the Available Environment Space using the Master Environment
Size and any currently free memory available immediately above the Master
Environment. Set the DOS ERRORLEVEL variable equal to the value calculated
using the rules detailed in the section "Available Environment Space
ERRORLEVEL Calculation". This is the default.

- Calculate the Available Environment Space using only the Master Environ-
ment Size. Set the DOS ERRORLEVEL variable equal to the value calculated
using the rules detailed in the section "Available Environment Space
ERRORLEVEL Calculation".

s Display a single summary line specifying the Available Environment Size
and the value to which ERRORLEVEL is set. This display does not cause a
pause nor is any user action required.

d Displays each of the current environment strings along with its length.
Additionally data is displayed about the master environment size, free
memory above the master environment, current environment size, available
environment space and the value of ERRORLEVEL.

x Suppress the error message display on Insufficient Environment Space re-

maining.

Requested Environment Memory

nnnnn (0-32767) If a numeric value is placed on the command line, it will be
treated as a request to test for the availability of a corresponding num-
ber of bytes of environment space. This number will then be used in the
calculation of the ERRORLEVEL variable using the rules detailed in the
section "Available Environment Space ERRORLEVEL Calculation".

Shareware message

A shareware message may be randomly displayed at the end of ENVI-MAN. Pressing
any key will exit the program.

The use of the "X" option to suppress display of the Insufficient Environment

15

RUNNING ENVI-MAN ENVI-MAN Version 1.0

Space Remaining will not affect the shareware message display.

By registering you use of ENVI-MAN, you will be able to use the registration
serial number to suppress the shareware message display.


















































16


MASTER AND PROGRAM
ENVIRONMENTS

Master Environment

When the computer is first booted, a Master Environment is established. Its
default size is 160 bytes for DOS versions 3.x and 4.x and 256 bytes for version
5.0. This size may be changed, in sixteen byte increments up to a maximum size
of 32,767, by use of the SHELL and COMMAND statements in the CONFIG.SYS file.
Details of these commands may be found in the DOS manual. For any changes to the
CONFIG.SYS file to become effective, the system must be re-booted after the
changes are made.

The contents of the Master Environment are environment strings, each in the
following format:

NAME = STRING[ASCII 0]

As can be seen from the format, the minimum environment string length is four
bytes.

An example environment string is -

PATH=C:\

The length of the above example is nine bytes.

The Master Environment strings may be created or changed by use of the DOS com-
mands such as PROMPT, PATH and SET. An example would be-
SET GOOD=EMPIRE
SET BAD=KLINGONS
PROMPT=$P$G

Program Environment

When a program is executed, the loader (which is called by COMMAND.COM and is
DOS Int 21h - EXEC), establishes a copy of the environment for use by the pro-
gram. It first copies all of the environment strings from the Master Environ-
ment(or, if this is a child process, from the parent's environment). These envi-
ronment strings are then terminated by a three character sequence of:

[ASCII 0][ASCII 1][ASCII 0]

The environment strings are followed by the complete path of the loaded program
using the format:

D:\[subdirectory path\]NNNNNNNN.EEE[ASCII 0]

where:
D:\ disk drive from which the program is being loaded,
subdirectory path\ path of the program being loaded,
NNNNNNNN name of the program,
.EEE extension of the program.


17

MASTER AND PROGRAM ENVIRONMENTS ENVI-MAN Version 1.0

The program environment is then sized up to a paragraph boundary so that its
size in bytes is always a multiple of sixteen.

Master Environment Expansion

One interesting fact is that the size of the Master Environment may, under cer-
tain circumstances, exceed its default size or the size defined in CONFIG.SYS.

The Master environment is preceded by a 16 byte Memory Control Block (MCB) which
give the memory block size and the address of its owner. If the address is zero,
the memory block is free.

In some cases while booting, Terminate and Stay Resident (TSR) programs are
loaded. Their program environment is allocated before the program is loaded.
Some TSR's will release their environment memory allocation before returning
control to the command processor. If the size of the environment does not grow,
these free memory holes can be used to load the environment for later TSR's or
other programs. However, if the size of the environment does increase, there may
be few uses for these free memory areas and they may remain unused.

In the situation just described, memory allocation in the area of the Master
Environment might look as detailed below. ENV_SIZE is the default or defined
value for the Master Environment.

Memory Control Block 1 (=16 bytes)
{OWNER=COMMAND.COM}
{MEMORY_SIZE=ENV_SIZE}

Master Environment (=ENV_SIZE bytes)

Memory Control Block 2 (=16 bytes)
{OWNER=FREE}
{MEMORY_SIZE=X}

Free Memory (=X bytes (a multiple of 16))

Memory Control Block 3 (=16 bytes)
{OWNER=SOMEONE}
{MEMORY_SIZE=Z}

Note that MCB 2 and its associated memory block are free. Now for the fun part!

If a request is made to COMMAND.COM to increase the size of the environment,
such as with a SET statement and the size of the new environment would then
exceed that as defined by ENV_SIZE, it WILL NOT display "Out of environment
space". Rather, it will obtain the needed memory from MCB 2 and its associated
block.

Lets assume that there was a Master Environment (ENV_SIZE) of 160 bytes, the
current length of the environment strings was 155 bytes and the SET command will
add 10 bytes to the size of the environment strings.

COMMAND.COM will:

18

ENVI-MAN Version 1.0 MASTER AND PROGRAM ENVIRONMENTS

1. Increase the size of the memory block specified in MCB 1 by 16 bytes.
2. This increases the size of the Master Environment by 16 bytes.
3. Relocate MCB 2 16 bytes higher and decrease the size of its memory block
by 16 bytes.
4. This decreases the size of the free memory block associated with MCB 2 by
16 bytes.

This area of memory will now look like:

Memory Control Block 1 (=16 bytes)
{OWNER=COMMAND.COM}
{MEMORY_SIZE=ENV_SIZE+16}

Master Environment (=ENV_SIZE+16 bytes)

Memory Control Block 2 (=16 bytes)
{OWNER=FREE}
{MEMORY_SIZE=X-16}

Free Memory (=X-16 bytes (a multiple of 16))

Memory Control Block 3 (=16 bytes)
{OWNER=SOMEONE}
{MEMORY_SIZE=Z}

This procedure can continue - Master Environment increasing by 16 bytes and Free
Memory and its MCB 2 decreasing by 16 bytes - until both the Free Memory AND MCB
2 have been incorporated into the Master Environment!

Note that MCB 3 is not involved, since, if MCB 3 pointed to a free memory block,
it would normally be incorporated into MCB 2. However, if MCB 3 did point to
free memory, it could eventually be used by the Master Environment after all of
MCB 2 and its free memory was used.





















19

MASTER AND PROGRAM ENVIRONMENTS ENVI-MAN Version 1.0























































20


ENVI-MAN OPERATION

Program Syntax

A program syntax message is displayed if:

* No command line parameters are specified. Or,
* Any of the command line parameters is invalid.

The program syntax message is shown below.
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
ڴ ENVI-MAN Version 1.02, Copyright 1991-92 Micrometric, All rights reserved ÿ
³The program syntax is: ENVI-MAN [options][requested environment memory] ³
³ options = none, display syntax ³
³ +, calculate ERRORLEVEL using Free Memory Above Master (default)³
³ -, calculate ERRORLEVEL using only Master Size ³
³ d, display Environment Data ³
³ s, display Environment Space Remaining Summary line ³
³ x, suppress displays including Insufficient Environment Message ³
³ requested = nnnnn, optional decimal bytes of environment memory needed ³
³ERRORLEVEL = AVAILABLE ENVIRONMENT SPACE + Free(optional) - Requested(opt.) ³
³ = 0, no Environment Space Remaining ³
³ = 1-254, bytes Environment Space Remaining ³
³ = 255, greater that 254 bytes Environment Space Remaining Á
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ENVI-MAN syntax, Press any key to continue..
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

-> If this message is displayed, correct the program syntax and rerun.



























21

ENVI-MAN OPERATION ENVI-MAN Version 1.0

Environment Data Display

ENVI-MAN has two major functions: an informational one and a testing one. The
Environment Data Display is its primary informational tool.

To obtain the Environment Data Display, use the syntax -

ENVI-MAN D

A sample of the resulting Environment Data Display is shown below. An explana-
tion of its information follows.
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
ڴ ENVI-MAN Version 1.02, Copyright 1991-92 Micrometric, All rights reserved ÿ
³ COMSPEC=C:\DOS\COMMAND.COM Ä> 27 ³
³ DOS=DOS-330 Ä> 12 ³
³ PATH=C:\BAT;C:\DOS-330;C:\UTILITY;C:\ Ä> 38 ³
³ PROMPT=$e[36;44;1m$t$h$h$h$h$h$h $d$h$h$h$h$h $p$g$e[37;44;1m Ä> 62 ³
³C:\UTILITY\ENVI-MAN.COM Ä> 24 ³
ÀÄÄÄÄÄ´ Current Environment Strings Ä> String Length ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
³ Master Environment Location <> 0E36:0000 ³
³ MASTER ENVIRONMENT SIZE Í> 320 ³
³ Free Memory Above Master +> 80 ³
³ POSSIBLE MASTER ENVIRONMENT SIZE ÷> 400 ³
³ Number Of Environment Strings <> 4 ³
³ Environment Strings Length +> 140 ³
³ Program Path Length +> 26 ³
³ Current Environment Size Í> 176 ³
³ AVAILABLE ENVIRONMENT SPACE Í> 180 ³
³ POSSIBLE AVAIL ENVIRONMENT SPACE ÷> 260 ³
³ Requested Environment Memory Ä> 0 ³
³ ERRORLEVEL SET TO Í> 255, Press any key to continue.. ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

The program line shows the current ENVI-MAN version.
The boxed lines, except for the last, are the current Master Environment and
Program Environment strings. At the end of each string is its length, which
includes its terminating zero byte.
The last boxed line is the program path that is included in the Program Environ-
ment. At its end is its length, including its terminating zero byte.

MASTER ENVIRONMENT LOCATION . . . . The segment address and offset (always zero)
at which the Master Environment is located. Its MCB is located one paragraph
lower.
MASTER ENVIRONMENT SIZE . . . . The current Master Environment size, not neces-
sarily the default or defined size.
FREE MEMORY ABOVE MASTER . . . . . The size of any contiguous free memory in-
cluding its associated MCB above the Master Environment.
POSSIBLE MASTER ENVIRONMENT SIZE . The possible maximum size of the Master
Environment if the currently available free memory is included.
NUMBER OF ENVIRONMENT STRINGS . The number of currently defined environment
strings.



22

ENVI-MAN Version 1.0 ENVI-MAN OPERATION

ENVIRONMENT STRINGS LENGTH . . The size of all of the currently defined envi-
ronment strings. This size includes the strings termination zero byte, since
this byte is required in the Master Environment.
PROGRAM PATH LENGTH . . . . . . The length of the program path string in the
Program Environment. This size includes the termination zero byte and the two
bytes that separate the environment strings from the program path.
CURRENT ENVIRONMENT SIZE . . . . . The size of the current environment. This
size set by COMMAND.COM and is always a multiple of 16 bytes.
AVAILABLE ENVIRONMENT SPACE . . . . Currently defined MASTER ENVIRONMENT SIZE
less the currently defined ENVIRONMENT STRINGS LENGTH. The available free
space in the currently defined Master Environment.
POSSIBLE AVAIL ENVIRONMENT SPACE . The AVAILABLE ENVIRONMENT SPACE plus the
FREE MEMORY ABOVE MASTER Environment space.
REQUESTED ENVIRONMENT MEMORY . The amount of environment memory needed as
requested in the ENVI-MAN command line parameters.
ERRORLEVEL SET TO . . . . . . . . . The value calculated by ENVI-MAN to which
the ERRORLEVEL variable is set upon program exit. For the formula used for
this calculation, see the section "AVAILABLE ENVIRONMENT SPACE ERRORLEVEL
CALCULATION" later in this chapter.

Environment Space Remaining Display

To display a single summary line on the environment space status, use the syntax
-

ENVI-MAN S

An example of the resulting display is shown below. For the formula used for
this calculation, see the section "AVAILABLE ENVIRONMENT SPACE ERRORLEVEL CALCU-
LATION" later in this chapter.
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ Environment Space Remaining Í> 255 ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

Additional Environment Space Required Display

If, based on the defaults and the command line parameters, there is not suffi-
cient environment space remaining, an informational message is displayed, as
shown below. This message ONLY appears if reserved memory has been specified on
the command line AND the "X" suppress option is NOT specified.
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
ڴ ENVI-MAN Version 1.02, Copyright 1991-92 Micrometric, All rights reserved ÿ
³The amount of Additional Environment Memory requested for this batch file is ³
³greater than the currently available Environment Space. This means that if ³
³execution of this batch file continued, the operating system would display ³
³the message "out of environment space" and terminate the batch file. In order³
³to run this batch file (assuming no free memory above the Master Environment)³
³you MUST decrease the environment strings length OR increase the size of the ³
³ENVIRONMENT space using the SHELL statement in your CONFIG.SYS file. Á
ÀÄÄ´ Additional Environment Space Required Í> 120, Press any key to continue..³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

The displayed "Additional Environment Space Required" NEVER includes any possi-

23

ENVI-MAN OPERATION ENVI-MAN Version 1.0

ble free memory above the Master Environment. This is the amount by which the
defined environment size should be increased in order to run the program with
the desired environment information. Possible free memory is not used since this
value is how much the Master Environment
needs to be increased.

The Master Environment size may be changed, in sixteen byte increments up to a
maximum size of 32,767, by use of the SHELL and COMMAND statements in the CONF-
IG.SYS file. Details of these commands may be found in the DOS manual. For any
changes to the CONFIG.SYS file to become effective, the system must be re-booted
after the changes are made.

If sufficient environment space was not available, this message WOULD BE dis-
played with the syntax -

ENVI-MAN 2000

and WOULD NOT BE displayed with the syntax -

ENVI-MAN 2000X


Available Environment Space ERRORLEVEL calculation

The ERRORLEVEL variable is used to denote the amount of Available Environment
Space and is calculated as follows:

ERRORLEVEL = Master Environment Size
- Environment Strings Size
+ Free Memory Above Master Environment (optional)
- Requested Environment Memory (optional)

If ERRORLEVEL is negative (there is not enough Available Environment
Space), it is set equal to zero to denote an error condition.

If ERRORLEVEL, as calculated, is equal to zero (there is exactly enough
current Available Environment Space), it is set equal to one to denote a
non-error condition.

If ERRORLEVEL is greater than 254, it is set equal to 255.

A summary of the various ERRORLEVEL values and their relationship to the Avail-
able Environment Space is shown below.

ERRORLEVEL Available Environment Space

0 -32767 to -1
1 0 to 1
2-254 Same as ERRORLEVEL
255 255 to 32767




24


ENVI-MAN BATCH
FILE EXAMPLES

Shown below are several examples of the use of ENVI-MAN in batch files.

-> To assure that an environment variable of 8 character storage size may be
added and to display your own message if there is insufficient space, use the
following batch file code:

...
ENVI-MAN +8X (or ENVI-MAN 8X)
IF NOT ERRORLEVEL 1 GOTO NOFIT
...
:NOFIT
ECHO DO THIS AND THAT BECAUSE
ECHO THERE IS NOT ENOUGH SPACE
ECHO IN THE ENVIRONMENT.
...

The batch file code shown below will produce the same results at that
above (without the requested environment memory parameter the "Additional
Environment Space Required Display" can never occur and thus the "X" sup-
press option is not needed):

...
ENVI-MAN +
IF NOT ERRORLEVEL 8 GOTO NOFIT
...
:NOFIT
ECHO DO THIS AND THAT BECAUSE
ECHO THERE IS NOT ENOUGH SPACE
ECHO IN THE ENVIRONMENT.
...


-> To assure that an environment variable of 8 character storage size may be
added and let ENVI-MAN display a message if there is insufficient space, use
the following batch file code:

...
ENVI-MAN +8 (or ENVI-MAN 8)
IF NOT ERRORLEVEL 1 GOTO EXIT
...
:EXIT
...

-> To display the amount of available environment space on a single line, use
the following batch file code:

...
ENVI-MAN +S (or ENVI-MAN S)
...



25

ENVI-MAN BATCH FILE EXAMPLES ENVI-MAN Version 1.0

-> To display the environment data, use the following code (this syntax may be
used in a batch file or entered at the DOS prompt):

ENVI-MAN D


















































26