home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 18 REXX
/
18-REXX.zip
/
rdebug21.zip
/
README.OS2
< prev
next >
Wrap
Text File
|
1993-04-03
|
12KB
|
294 lines
rDEBUG Version 2.1 Distribution Notes
March, 1993 Revision
WHAT IS rDEBUG
rDEBUG is an Intergrate Development Environment for
OS/2 REXX language procedures and KEDIT macros. This
is a source level debugger using all common features of
an IDE such as: built-in editor, breakpoints,
watchpoints, stepping single lines or stepping over
procedures, selective tracing, logging, restart
capabilities, pulldown menus, context help, a profiler
and a demo program. The system features fault tolerant
coding to maintain a debugging session in spite of most
coding errors. rDEBUG is ideal for checking VISUAL REXX
procedures. rDEBUG is a number of REXX macros that
requires Mansfield Software Group's KEDIT for this version
but will support the EPM for version 2.2.
Support is available for Canada and the USA, initially,
by the CANADA REMOTE SYSTEMS BBS and will be extended to
COMPUSERVE if warranted. Other countries will be serviced
by mail.
rDEBUG IS NOT FREE SOFTWARE, but rather, user-supported
"Shareware". rDEBUG may registered for $99 for a single
user or $399 for a multiple-user site. Shipping and
handling is $2.50 for Canada and the USA or $3.00 for
other countries. Please indicate whether uyou wish
3.5" or 5.25" format disks.
More details are provided later in this documentation
file.
While on the topic of printers if you wish to print from
within rDEBUG please change line 2 of rDEBUG.KEX as shown there.
HARDWARE REQUIREMENTS
rDEBUG will run on three systems, OS/2, DOS AND VM/CMS with
265K of hard disk space an additional 251 is required for
KEDIT. This disk contains only the OS/2 version. With
registration you can generate a system for any or all of
OS/2, DOS and VM/CMS (VM/CMS has to be tested yet). rDEBUG
can be run from a floppy and works on everything from a
notebook XT under DOS 3.3 and a 80386/sx 25mhz under DOS 5.0
and OS/2 version 2.0.
SOFTWARE REQUIREMENTS
You must have installed IBM's REXX 2.0 with OS/2 version
2.0. Also, you must have installed Mansfield Software
Group's KEDIT for OS/2 version 5.0+ in the root directory of
the drive that contains rDEBUG directory or in a directory
in the PATH. KEDIT (includes a version for DOS as well as
for OS/2) can be bought from me at a big discount (approxi-
mately $125.00) or directly from Mansfield Software Group,
P.O. Box 532, Storrs, CT, 06268 (203) 429-8404.
INSTALLATION of rDEBUG for OS/2 version 2.0
rDEBUG can work in any directory, however, the current
directory must be on the same drive that contains an rDEBUG
directory.
1) click on OS/2 Full Screen prompt
2) place rDEBUG disk in your floppy drive
3) type A: and press <ENTER>, if you use drive "A", or
4) type B: and press <ENTER>, if you use drive "B"
5) if only rDEBUG.zip exists,
type: "c:"
type: "md \temp" (may already exist, ignore error message)
type: "cd \temp"
type: "PKUNZIP a:\rDEBUG" or as in 3 & 4
type: "PKUNZIP b:\rDEBUG" to uncompress it.
6) type: "INSTALL target_drive" (defaults: INSTALL C:) and press <ENTER>
7) follow instructions displayed on screen to complete installation.
8) be sure KEDIT.EXE is installed in root directory or in a directory
in the path defined in \rdebug\rdebug.cmd.
9) type: "rDEBUG" to run a demonstration procedure that shows what rDEBUG
can do.
10) type: "rDEBUG profile" to run a debugging session on an actual procedure.
11) to run rDEBUG on Visual REXX procedures you must install VREXX as shown
in the VREXX.ZIP which is available on most BBS's (or if you have registered
included with rDEBUG distribution disk).
HOW TO RUN rDEBUG FROM DESKTOP
1) double click/1 on rDEBUG folder
2) Run DEMO by clicking on DEMO
3) Run TESTPROF by clicking on TESTPROF
4) Run your program when \rDEBUG is on drive C by clicking on rDEBUG
and supplying your program name when prompted
5) Run your program when \rDEBUG is on drive D by clicking on D:\rDEBUG
icon and supplying your program name when prompted
rDEBUG DEMO COVERAGE
If you type rDEBUG in the OS/2 commandline a simple
demonstration procedure will run and stop at various points
to execute and explain some of rDEBUG's features namely:
Breakpoints: BREAK 2 5-7 ( set b/p's at lines 2 5 6 7)
Assignments: abc = 1
Show variables: SAY abc def dbp
GO COMMAND: GO 3
WATCH COMMAND: watch abc (def>12)
STEP PROCEDURE COMMAND: GO 0 or F10
PROFILER TOOL COMMAND: PROFILER
EXIT COMMAND: EXIT
FILES USED BY rDEBUG: (* marks files that can be deleted after demo)
CHORES.CMD * test file used by profile.cmd
CHORES2.CMD * test file used by profile.cmd
DEBUGRUN.KEX main routine od rDEBUG
DEMO.CMD * demo test file
INSTALL.CMD * installation procedure for rDEBUG
PROFILE.CMD * sample procedure for logging on
RCASE.KEX macro to standardize the case of REXX procedures
RDBCMDS.KEX macro to call rDEBUG commands
RDBEND.KEX wrap up macro for rDEBUG
RDBHELP.HLP online help system file
RDBHELP.KEX macro to deliver online help
RDBINIT.KEX initialization macro to set up screens, etc
RDBIO.OS special routines to handle REXX SAY and PULL commands
RDBMENU.KEX macro to handle all menus
RDBMISC.KEX macro to supply various miscellaneous function
RDBMSG.KEX macro to handle most messages to tester
RDBPROF.KEX macro to maintain the procedure's profile
RDBTASK.KEX macro to handle rDEBUG commands from the menus
RDBUI.KEX macro to provide the user interface
RDBUIEXT.OS2 definitions of keys for os/2
RDBVARS.KEX macro to store and pass startup variables between macros
RDDEMO.CMD * procedure to initialize a demonstarion of rDEBUG
RDDEMO.KEX * macro to handle a DEMO of rDEBUG
RDDEMO.INC * file used by RDDEMO.KEX
RDEBUG.CMD procedure to start a rDEBUG session on REXX procedure
RDEBUG.CTL * control file used by INSTALL.CMD
RDEBUG.HLP rDEBUG help manual
RDEBUG.KEX macro to start a rDEBUG session on REXX macro
RDPROFIL.KEX macro to setup all rDEBUG sessions
RDXGEN.KEX macro to tailor DEBUGRUN.KEX or setup a system
RDXMIMIC.KEX macro to modify certain REXX statements
RDXWRAP.KEX macro to wrap up rDEBUG.KEX
README.OS2 this file
RHYPERTX.KEX macro to handle hypertext functions
RMATCH.KEX macro to verify the proper pairing of delimiters
RPP.KEX macro to indent REXX code in a structured fashion
RSTRUC.KEX macro to show only lines that contain REXX key words
RSYNMSG.KEX macro to handle error message for rSYNTAX.kex
RSYNTAX.KEX macro to check for proper syntax of all REXX statements
RXREF.KEX macro to generate a cross reference map of all variables
TELL.CMD procedure to call TELL macro
TELL.KEX macro to show information on invoking a procedure
TRACESW.CMD * procedure to call rXREF macro
TRACESW.KEX * macro to initialize control variables
UPDATE INFORMATION
If you're already a registered user of rDEBUG and you want
an update of the latest version, we'll be happy to oblige.
Please see order form below. Or, you can leave a message
for Gil Gagnon on Canada Remote Systems (416) 798-7730 or
798-7731 (Gil.Gagnon@canrem on Internet).
Your support of this product makes continued development
possible. We schedule our development work by the response
we receive from a product. By registering, you're letting
us know that this product is important to YOU!
We offer several incentives to you for registering. First
of all, you receive the most up-to-date copy of the program
that we have, including comments, embedded test drivers and
code for DOS in addition to OS2. You also receive support
for rDEBUG. And finally, you will receive several tools not
included in the evaluation package. Make no mistake, however,
this is a fully functional version of rDEBUG and not "crippled"
in any way. In the wings: 1) support for IBM's EPM editor;
2) REXX's TRACE-like output as an option 3) rDEBUG 3.0 for
DOS and 4) support for Quercus Personal Rexx for OS/2.
All products and documentation here are Copyright 1992.
J Gil Gagnon & Associates Inc.
814-25 Glenn Hawthorne Boulevard
Mississauga, Ontario L5R 3E6
Voice: (416) 568-3105
They may not be sold or licensed without the express
permission of J Gil Gagnon & Associates Inc.
DISTRIBUTION NOTICE
This is "user-supported" software. You are hereby granted a
license by J Gil Gagnon & Associates Inc to distribute this
evaluation copy of rDEBUG and its documentation, subject to
the following conditions:
1. rDEBUG may be distributed freely without charge in
evaluation form only.
2. rDEBUG may not be sold, licensed, or a fee charged
for its use. If a fee is charged in connection with
rDEBUG, it must cover the cost of copying or dissemi-
nation only. Such charges must be clearly identified
as such by the originating party. Under no cir-
cumstances may the purchaser be given the impression
that he is buying rDEBUG itself.
3. rDEBUG must be presented as a complete unit, includ-
ing this documentation. Neither rDEBUG nor its
documentation may be amended or altered in any way.
4. By granting you the right to distribute the evaluation
form of rDEBUG, you do not become the owner of rDEBUG
in any form.
Any other use, distribution or representation of rDEBUG
is expressly forbidden without the written consent
of J Gil Gagnon & Associates Inc.
Mail to:
J Gil Gagnon & Associates Inc
814-25 Glenn Hawthorne Boulevard
Mississauga, Ontario L5R 3E6
Telephone: (416) 568-3105
O R D E R F O R M
Name __________________________________
Company __________________________________
Street __________________________________
City, State, Zip/Country __________________________________
__________________________________
Registration Fee for Single-
System rDEBUG License $99.00 ...........___________
Registration Fee for Multi-
System Site License $299.00 ...........___________
Purchase of KEDIT 5.0 for OS/2
and DOS $125.00 ...........___________
Sub total ___________
Shipping and Handling:
U.S. and Canada: $2.50
Other countries: $3.00 ...........___________
(We airmail all foreign shipments)
GST 7% of subtotal (for Canadian residents) ___________
TOTAL...........................................___________
Please indicate payment method:
Check __ MO ___
We normally ship 3.5" 720K diskettes. Check here if you
need rDEBUG on 5.25" 360K diskette.................________
Where did you learn of rDEBUG? ____________________________