home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 10 Tools
/
10-Tools.zip
/
cenvi23.zip
/
README.DOC
< prev
next >
Wrap
Text File
|
1996-02-20
|
31KB
|
600 lines
CEnvi Demo - ReadMe
CEnvi version 2.11
20 February 1996
Copyright 1993, Nombas, All Rights Reserved.
Published by Nombas, 64 Salem Street, MEDFORD MA 02155 USA
VOICE (617) 391-6595 EMAIL: nombas@nombas.com
BBS (617) 391-3718 WWW: http://www.nombas.com
FAX (617) 391-3842
Thank you for trying this shareware version of CEnvi from Nombas.
_______
____|__ | (R)
--| | |-------------------
| ____|__ | Association of
| | |_| Shareware
|__| o | Professionals
-----| | |---------------------
|___|___| MEMBER
Introduction to Cmm and CEnvi
Cmm: Cmm (C minus minus) is a scripting (i.e. programming)
language. Cmm is 'C' for the rest of us; i.e., C minus the
hard stuff. Cmm packs the functionality of C, but eliminates
C's complex, time consuming, and hazardous data manipulations.
Cmm is immediately familiar and immediately useful to hundreds
of thousands of professional C programmers. At the same time,
Cmm is also easy to learn and use for people who have never
programmed.
Cmm extends the power of C down to the macro language domain.
Nowhere will you find a more straight forward syntax, fewer
keywords, and such simple, well-defined rules as in the Cmm
language. Three features -- power, safety, and simplicity --
make the Cmm Toolkit the perfect fit for scripting and macro
usage.
Cmm strengths
* Easy to learn for new programmers
* Safe (Hard to make dangerous beginner mistakes)
* Intuitive to professional C/C++ developers
* Natural extension of the C/C++ programming languages
CEnvi: CEnvi is a standalone interpreter for the Cmm scripting
language--a powerful and versatile cross-platform macro language
interpreter. CEnvi gives you a full strength computer language,
but without the time, system, and resource programming hassles
normally associated with developing computer programs.
Whether you are a professional programmer, systems administrator,
experienced user, or just a novice, you can unleash the power of
your PC with CEnvi. CEnvi can be incorporated at a pace that is
comfortable to you: you may only want to use CEnvi code set up by
a more experienced user, you may want to enhance existing batch
files with a line or two of CEnvi code, or you may want to write
complete utilities using CEnvi.
CEnvi s automation development tools enable you to create robust
utilities, quickly build programs, and easily automate tasks so
you can work more productively and efficiently.
CEnvi's advantages
* Easy to use
* Powerful - Allows for direct system and DLL calls
* Provides a Windows command line and programming interface
* Data Exchange through DDE, clipboard, shared memory and pipes
* Low memory and Disk usage
* Event Scheduling and Monitoring
* Enhances Existing batch and REXX utilities
Who benefits from CEnvi
* Programming Professionals
* Network and System Administrators
* The home or business PC user
To learn how to write scripts in the Cmm language, new programmers
should consult Chapter 2, "The Cmm Language", and Chapter 3,
"Tutorial - CmmEdit a Simple Editor". Current C programmers
should consult Chapter 4, "Cmm vs. C", on the differences between
C and Cmm.
What they said about CEnvi version 1.009
"Every now and then a programming tool serves a particular need
better than anything else. CEnvi, a shareware product from
Nombas, is such a tool. ...CEnvi has virtually replaced ReXX
and the DOS batch language in my office."
Al Stevens, Dr.Dobb's, December '94
"Concise documentation, an extensive code library, over 70
examples, and compact executable size make CEnvi a good choice
for writing small programs and Windows scripts." <four stars>
Ziff-Davis Interactive
"...if you are a C programmer, this product is really a dream
come true."
Brian Proffit, OS/2 Magazine January '94
... and awarded to CEnvi version 2.00
1995 Ziff-Davis Shareware Awards - Winner of PC Magazine
Shareware-of-the-Year award for Programming Tools
New Features in Version 2.10
CEnvi versions have been added for Windows NT--console and GUI
mode. Full clipboard support for Windows and Windows NT version.
This includes marking, copying, and pasting from/to the CEnvi screen.
The CEnvi shell has been greatly enhanced in all versions--including
launching applications with environment-variable inheritance, file
redirection and piping, alias, history, and many internal commands.
New "literal strings" protect text from overwriting.
New Features for Version 2.11
Windows 95 support, including OLE Automation. The shell has been
greatly enhanced, many bugs have been squashed and wishes fulfilled.
-------------------------- Quick Start For DOS -----------------------------
Create a directory to install CEnvi for DOS in (we recommend
CENVIDOS). UNZIP cenvidos.zip into the directory you created. CEnvi
for DOS includes two executables. CEnvid.exe is a regular DOS
program. CEnvid32.exe is a 32 bit DOS version. It is useful if you
find that the regular DOS version of CEnvi is running out of
memory.
The first time you run CEnvi for DOS, run the install.cmm
installation script. The installation script does 2 things for you.
It creates a CMMPATH environment variable, adds the CEnvi for DOS
path to the DOS PATH.
After CEnvi for DOS is installed, try the following sample
utilities. They best demonstrate the power of CEnvi for DOS.
Samples that end in .bat can be run as batch files. Samples that
end in .CMM require typing "cenvid sample.cmm" where sample is the
name of the utility.
NOTE: CEnvi for DOS can directly alter DOS environment variables.
For example, from the DOS command line enter the commands:
SET COUNT=100
CEnviD COUNT = COUNT + 2
SET
and you'll see that CEnvi has increased the COUNT environment
variable to 102. Because CEnvi uses environment space, you
may sometimes see an error message such as:
"The environment is not big enough..."
To correct this problem, you can specify a larger environment
size with a command such as:
COMMAND.COM /E:2000
To make this change permanent, add the /E:XXXX parameter,
where XXXX is a new environment size, to the "SHELL="
line in CONFIG.SYS.
DOS Quick-Start Sample Files
*EnviAsks.bat: Many examples of user input using EnviAsk.bat
and GetUKey.cmm
*EnvSort.bat: Sort environment variables alphabetically
*FileFind.bat: Wildcard search for files on current drive or on
all drives
*GetUKey.cmm: Display a choice prompt and then set an
environment variable based on user's selection
*KbdBuf.bat: Alter the size of the keyboard buffer
*KeyState.bat: Get or set the state of the NumLock, CapsLock,
or Insert keys
*Mouse.bat: Demonstrate reading a mouse's position and state
*PathAdd.bat: Add a directory to your PATH environment
variable.
*PathDel.bat: Remove a directory from your PATH environment
variable
*RunTime.bat: Rudimentary scheme for executing a command at a
certain time of day.
*Sound.bat: Play a frequency for a given time period
*WinClip.cmm: Utility to access Windows clipboard from DOS
------------------------- Quick Start For Windows --------------------------
Create a directory to install CEnvi for Windows in (we recommend
CENVIWIN). UNZIP cenviwin.zip into the directory you created. CEnvi
for Windows includes two executables. CEnviw.exe is a Windows
program that is both a Cmm interpreter and a Windows Command line
and servewin.com allows windows to control DOS sessions.
When you run CEnvi for Windows from program manager, it will provide
a command-line interface (complete with shell commands you expect,
such as DIR, MKDIR, etc., and ability to call any program from the
shell or START executables). Type install, and the installation
script will set up CEnvi for Windows Properly. It will create a
CEnvi program group containing CEnvi for Windows, and a few sample
Cmm utilities.
After CEnvi for Windows is installed, try the following sample
utilities. They best demonstrate the power of CEnvi for Windows.
All of these utilities can be run directly from the CEnvi for
Windows command line prompt. Some are shown as icons in the CEnvi
program group, double click to run them. All these samples may be
viewed using a standard text editor such as notepad.
Windows Quick-Start Sample Files
*BmpView.cmm: Demonstrate the BMP.LIB routines by reading any
number of .BMP files and displaying them.
To run this program, type bmpview at the CEnvi
shell prompt.
*Dropper.cmm: Perform command for all files Drag-&-Dropped to
this tool.
*ExitWin.cmm: Exit Windows; options to save files, force
applications to quit, restart Windows, and
reboot computer. To run this program, type exitwin
at the CEnvi shell prompt.
*InputBox.cmm: Demonstrate uses of the InputBox() routine in
InputBox.lib. To run this program, type inputbox
at the CEnvi shell prompt.
*KeyGhost.cmm: Demonstrate how to use KeyPush.lib to control
other applications. To run this program, type
keyghost at the CEnvi shell prompt.
*MenuNot.cmm: Disable or delete a menu item. To run this program,
type menunot at the CEnvi shell prompt.
*MsgBoxes.cmm: Show various message box types using the
function in MsgBox.lib. To run this program, type
msgboxes at the CEnvi shell prompt.
*Pm_exits.cmm: Adds Restart Windows and Reboot to Program manager.
Meant to display adding menu selections to other
applications. To run this program, type pm_exits
at the CEnvi shell prompt. To add this utility all
the time, add an item to the startup group and set
its command line to "CENVIW pm_exits.cmm".
*PMButt.cmm: Replace Program Manager with a tiny button in
upper-left corner for access to all PM items. To
run this program, type pmbutt at the CEnvi
shell prompt.
*PongTime.cmm: Bounce the Windows clock mini-app around. To run
this program, type pongtime at the CEnvi shell
prompt.
*WinTools.cmm: Demonstrate many of the capabilities of
WinTools.lib. To run this program, type wintools
at the CEnvi shell prompt.
----------------------- Quick Start For OS/2 -------------------------------
Create a directory to install CEnvi for OS/2 in (we recommend
CENVIOS2). UNZIP cenviOS2.zip into the directory you created. CEnvi
for OS/2 includes two executables. CEnvi2.exe is a OS/2 program.
CEnvi2PM.exe is used by CEnvi2.exe to make presentation manager
calls. It must be in the current directory or in the search
path for many of the Os/2 samples to work correctly.
The first time you run CEnvi for OS/2, run "install.cmm" from the Cmm
installation script. The installation script will set up CEnvi for
OS/2 Properly.
After CEnvi for OS/2 is installed, try the following sample
utilities. They best demonstrate the power of CEnvi for OS/2.
OS/2 Quick-Start Sample Files
*Bouncy.cmd: Start a bouncy OS/2 Command Window. This
demonstrates moving windows and silliness.
*ClipBrd.cmd: Get or modify clipboard text
*DoFiles.cmd: Perform any command on a list of files selected
from a file dialog box
*DoMenu.cmd: Execute any menu selection of a PM application,
based on the name of the window and the menu text
*DOS.cmd: Perform DOS command from an OS/2 session, with the
option to "see" output of the command; mirrors
OS2.BAT
*KeyGhost.cmd: Sample for using KeyPush.lib to determine if
CEnvi is worth the price of registration.
*MsgBoxes.cmd: Show various message box types using the
function in MsgBox.lib.
*NumLock.cmd: Turn on NUMLOCK key once, or maintain NUMLOCK ON.
A shadow of NumLock.cmd can be put in startup
folder to default computer to NumLock ON.
"NumLock 1000" will check every second to make
sure that NUMLOCK is still set.
*ObjSet.cmd: Alter WPS object and folder settings. Run
OBJSET MANUAL for complete description.
*OnTop.cmd: Float window to top of all other windows
*OS2.bat: Perform OS/2 command from a DOS session, with the
option to "see" output of the command; mirrors
DOS.CMD. Note that this requires CEnvi for DOS
*Session.cmd: Replace OS/2's START command for greater control
of starting sessions, including name, position,
font, notebook settings, etc...
*Sessions.cmd: batch file to demonstrate various uses of
Session.cmd
*ShutDown.cmd: Automated shutdown or reboot of OS/2 system,
including options to save desktop settings or
force shutdown/reboot with other programs running.
*TextWin.cmd: GET/PUT text from/to a windowed DOS or OS/2
session
*WinSet.cmd: Set the position, size, state, etc... of a PM
Window
*WinTools.cmd: Demonstrate many of the capabilities of
WinTools.lib. This is a fun one!
--------------------- Quick Start For Windows/NT --------------------------
CEnvi for Windows NT includes two executables: CEnviNT.exe is a
console (text-mode) application for running CEnvi scripts from
the default NT command line, or CEnvi scripts embedded within
batch files. CEnviWNT.exe is a GUI application that operates as
a Cmm command-line shell, can execute Cmm scripts associated
with .cmm files, and provides more access than the console version
to the creation of windows within Windows NT.
When you run either version of CEnvi for Windows from program
manager the first time, it will run the Cmm installation script
for that version, INSTALL.CMM. This will set up CEnvi for Windows
Properly. (You may execute the INSTALL utility again at any time,
from either version, by entering the command "INSTALL" at the CEnvi
command shell prompt.)
For the console version (CEnviNT.exe), INSTALL.CMM will add the
CMMPATH to your environment group, and add the CEnvi path to the
PATH environment variable.
For the GUI version (CEnviWNT.exe), INSTALL.CMM will update the
registry to locate CEnviWNT and the Cmm files and libraries in the
CMMPATH registered location, and the registry will also be updated
to associate files with the .cmm extension to CEnviWNT.EXE so they
can be automatically launched from File Manager.
After CEnvi for Windows NT is installed, try the following sample
utilities. They best demonstrate the power of CEnvi for Windows NT.
All of these utilities can be run directly from the CEnvi for
windows command line prompt. Some are shown as icons in the CEnvi
program group, double click to run them. All of these samples may
be viewed using a standard text editor such as notepad.
Windows NT Quick Start Sample Files
*BmpView.cmm Demonstrate the BMP.LIB routines by reading any
number of .BMP files and displaying them. To run
this program, type bmpview at the CEnvi shell
prompt.
*Dropper.cmm Perform command for all files Drag-&-Dropped to
this tool.
*InputBox.cmm Demonstrate uses of the InputBox() routine in
InputBox.lib. To run this program, type INPUTBOX
at the CEnvi shell prompt.
*KeyGhost.cmm Demonstrate how to use KeyPush.lib to control
other applications. To run this program, type
KEYGHOST at the CEnvi shell prompt.
*MenuNot.cmm Disable or delete a menu item. To run this
program, type MENUNOT at the CEnvi shell prompt.
*MsgBoxes.cmm Show various message box types using the function
in MsgBox.lib. To run this program, type msgboxes
at the CEnvi shell prompt.
*PMButt.cmm Replace Program Manager with a tiny button in
upper-left corner for access to all PM items. To
run this program, type PMBUTT at the CEnvi shell
prompt.
*PongTime.cmm Bounce the Windows clock mini-app around. To run
this program, type PONGTIME at the CEnvi shell
prompt.
*Reboot.cmm Automate Program Manager File/Exit and dialog box
to reboot system from command-line or CEnvi script.
*WinTools.cmm Demonstrate many of the capabilities of
WinTools.lib. To run this program, type WINTOOLS at
the CEnvi shell prompt.
----------------------------- FILE LIST -----------------------------------
The CEnvi Unregistered Shareware package includes all the files
in the following lists. You are not permitted to upload or otherwise transfer
copies of any unregistered version of CEnvi that do not include all of the
files in these lists. If you want to upload a CEnvi sharware version to a
BBS, you may consider calling the Nombas BBS to download the latest shareware
zip files.
--------------- CENVIW.zip Contains the following files -------------------
CENVIW.EXE: CEnvi shareware executable for Windows
SERVEWIN.COM: Allows CEnvi for Windows to control DOS Boxes
CENVI.DOC: CEnvi Shareware Manual, Chapter 1: CEnvi Unregistered Shareware
CMMTUTOR.DOC: CEnvi Shareware Manual, Chapter 2: Cmm Language Tutorial
CMM_VS_C.DOC: CEnvi Shareware Manual, Chapter 3: Cmm versus C, for C
Programmers
CENVILIB.DOC: CEnvi Shareware Manual, Chapter 4: Function Library
LICENSE.DOC: CEnvi Unregistered Shareware License Agreement
README.DOC: Introductory file. Read this first for quick intallation.
REGISTER.DOC: CEnvi registration form
INSTALL.CMM: Cmm source file for installing this shareware version
*.CMM, *.CMD, *.BAT, *.LIB: Many sample programs using CEnvi for Windows.
See CENVI.DOC for a complete list.
----------------- CENVID.zip Contains the following files -----------------
CENVID.EXE: CEnvi shareware executable for DOS
CENVID32.EXE: CEnvi shareware 32 Bit executable for DOS
CMMTUTOR.DOC: CEnvi Shareware Manual, Chapter 2: Cmm Language Tutorial
CMM_VS_C.DOC: CEnvi Shareware Manual, Chapter 3: Cmm versus C, for C
Programmers
CENVILIB.DOC: CEnvi Shareware Manual, Chapter 4: Function Library
LICENSE.DOC: CEnvi Unregistered Shareware License Agreement
README.DOC: Introductory file. Read this first for quick intallation.
REGISTER.DOC: CEnvi registration form
INSTALL.CMM: Cmm source file for installing this shareware version
*.CMM, *.CMD, *.BAT, *.LIB: Many sample programs using CEnvi for DOS.
See CENVI.DOC for a complete list.
------------------CENVI2.zip Contains the following files -----------------
CENVI2.EXE: CEnvi shareware executable for OS/2
CENVI2PM.EXE: Gateway program, executed transparently by CEnvi, for access
to PM-dependent system calls (OS/2 version only).
CENVI.DOC: CEnvi Shareware Manual, Chapter 1: CEnvi Unregistered Shareware
CMMTUTOR.DOC: CEnvi Shareware Manual, Chapter 2: Cmm Language Tutorial
CMM_VS_C.DOC: CEnvi Shareware Manual, Chapter 3: Cmm versus C, for C
Programmers
CENVILIB.DOC: CEnvi Shareware Manual, Chapter 4: Function Library
LICENSE.DOC: CEnvi Unregistered Shareware License Agreement
README.DOC: Introductory file. Read this first for quick intallation.
REGISTER.DOC: CEnvi registration form
INSTALL.CMM: Cmm source file for installing this shareware version
*.CMM, *.CMD, *.BAT, *.LIB: Many sample programs using CEnvi for OS/2.
See CENVI.DOC for a complete list.
-------------------------- REGISTRATION --------------------------------
This is a shareware release Please register. As a registered CEnvi user
you will receive the following benefits:
*The latest version of CEnvi for all supported platforms (currently DOS,
OS/2, Windows, and NT).
*The CEnvi user's manual--about 200 pages, including a description of the
Cmm programming language and a tutorial for those who have never programmed,
and descriptions and examples of the over 150 functions included in the
CEnvi library).
*/BIND option for creating standalone executables from Cmm scripts for
your own personal use.
*Support from Nombas and CEnvi/Cmm users through CompuServe
(72212,1622), internet (nombas@nobmas.com), the cenvi-cmm e-mail mailing
list (cenvi-cmm@world.std.com), phone (617-391-6595), the Nombas BBS
(617-391-3718), or Compuserve in PCUTIL forum 3.
*Access to the growing list of CEnvi utilities and libraries (some of which
are included in this unregistered shareware package, and others are
contributed by Nombas and CEnvi/Cmm users to the electronic locations
described above). Available on the Nombas BBS, from internet via
anonymous ftp at ftp.std.com in the /vendors/CEnvi-Cmm directory, or in
CompuServe in PCUTIL library 3 (search on CEnvi, Cmm, CENV, & CNV).
There are four ways to register CEnvi version 2.00:
************************************************************************
****** REGISTRATION METHOD 1: CENVI MAIL-IN/FAX REGISTRATION FORM ******
************************************************************************
Please fill out and mail in or fax this form, along with payment.
Name: _________________________________________________________________
Company: ______________________________ Position: _____________________
Address: ______________________________________________________________
_______________________________________________________________________
______________________________________________________________________
Country: _________________________ (add ZIP code if applicable)
Phone: ___________________________ EMail: ______________________________
CEnvi Single-user License & Manual .. Quantity _____ x $69.00 = $ _________
License fee for additional CEnvi users at your
organization (does not include additional manual
or diskettes)... Additional simultaneous users _____ x $39.00 = $ _________
10-User License .. 2 media & manual.. Quantity ____ x $299.00 = $ _________
50-User License .. 2 media & manual.. Quantity ____ x $899.00 = $ _________
Additional CEnvi Manuals ............ Quantity _____ x $15.00 = $ _________
Shipping outside USA, Canada, or Mexico $4.00 ................ $ _________
Subtotal $ _________
Massachusetts residents please add 5% sales tax ............... $ _________
Check handling fee IF CHECK NOT DRAWN ON A U.S. BANK . $30.00 = $ _________
Total $ _________
Include a check or money order for this total, IN U.S. FUNDS AND DRAWN ON A
U.S. BANK (if not drawn on U.S. bank then add the $30 handling fee),
payable to Nombas, or supply the following credit card payment information.
Credit card orders (circle one): MasterCard / Visa / American Express
Card Number _____________________________________ Expires ____________
Exact name on card (print) ____________________________________________
Signature (REQUIRED) __________________________________________________
Mail this form, along with payment or credit information, to:
Nombas
64 Salem St.
MEDFORD MA 02155 USA
or fax to:
Nombas
(617) 391-3842
***************************************************************************
******** REGISTRATION METHOD 2: COMPUSERVE ELECTRONIC REGISTRATION ********
***************************************************************************
CompuServe members may register directly through the CompuServe
Registration Service. To use this service enter GO SWREG at your CI$
prompt. Registration ID is 1354 for CEnvi for DOS, 1355 for CEnvi for
OS/2, and 1356 for CEnvi for Windows (you only need to register ONE
version). Nombas will immediately be informed of your registration, and
the CEnvi registration fee will automatically be added to your CompuServe
bill.
***************************************************************************
************ REGISTRATION METHOD 3: Public (software) Library *************
***************************************************************************
CREDIT CARD ORDERS ONLY -
You can order with MC, Visa, Amex, or Discover from Public (software)
Library by calling 800-2424-PsL or 713-524-6394 or by FAX to 713-524-6398
or by CIS EMail to 71355,470. You can also mail credit card orders to PsL
at P.O.Box 35705, Houston, TX 77235-5705.
THE ABOVE NUMBERS ARE FOR ORDERS ONLY.
Any questions about the status of the shipment of the order, refunds,
registration options, product details, technical support, volume discounts,
dealer pricing, site licenses, etc., must be directed to Nombas (see phone
number and addresses below).
To insure that you get the latest version, PsL will notify Nombas the day
of your order and we will ship the product directly to you.
CEnvi (all versions) is PsL product #11069.
***************************************************************************
************** REGISTRATION METHOD 4: KDL (Germany) Library ***************
***************************************************************************
Registration and instructions may be found through KDL-Registration Service
in Germany:
fax number:
* for German customers only: 089-895626-99
* for international customers: ++49-895626-99
phone number:
* for German customers only: 089-895626-50
* international customers: ++49-89-895626-50
Normally we do not take any orders by phone, but this number can be used to
request our registration form and our general registration rules.
Email-adresses:
* INTERNET:100347.2627@compuserve.com
* INTERNET:regservice@kellydata.de
The second number is available in March 1996, but should be used from that time
on.
Mail.adress: KDL-Registrierungsservice
Norbert M. Burkhard
Lena-Christ-Str.: 50
82152 Martinsried / Munich
Germany
***************************************************************************
Thank you for trying this shareware copy of CEnvi. Mail inquires and other
correspondences to:
Nombas
64 Salem Street
Medford, MA 02155 USA
Nombas may also be contacted at:
Phone: (617)391-6595
Internet: nombas@nombas.com
WEB: http://www/nombas.com
CompuServe: 72212,1622
BBS: (617)391-3718
Fax: (617)391-3842