Guidance Forums / Reginald Rexx / For the Reginald newbie

Search 搜索
Home Home

Forum List • Thread List • Reply • Refresh • New Topic • Search • Previous • Next First 1 Last
Message1. For the Reginald newbie
Posted by: Jeff Glatt 2005-11-25 18:34:25 Last edited by: Jeff Glatt 2012-05-25 02:17:58 (Total edited 3 times)
For those who are new to Reginald REXX, this is a primer for installing and using Reginald:

The latest version of Reginald, and any add-on support, can be found at:

First, you need to install Reginald itself. When you run the Reginald installer, it will ask you where you wish to install some files on your hard drive. You can go with the suggested directory just by clicking on the Install button.

When the install window eventually disappears (without any error message), then Reginald is installed. You can now run any REXX script just by moving the mouse pointer over the icon for the script, and double-clicking the left button. In other words, you run a REXX script the same way you would run any executable program.

You do not need to install any other software, but you may choose to install other packages from the above web page because they add many additional features to the REXX language (such as the ability to create a graphical user interface), or help you write your own REXX scripts.

If you want to write your own scripts, you'll definitely want to install REXX Programmer Center (often referred to as simply RPC). RPC is a "development environment". It has a built-in editor to write your REXX scripts. This editor features syntax color highlighting for REXX instructions, and has full mouse and menu support. You can edit several scripts at once, cut and paste text between them, etc.

RPC also has a built-in debugger to test and run your scripts. Each line in your REXX script is highlighted as it is executed, and the debugger displays the values of variables, and other information, in another window. You can set breakpoints on particular instructions just by double-clicking on the desired line in your script.

If you want to write a script that has its own user interface (ie, creates its own windows with mouse support, menus, buttons, sliders, list boxes, and lots of other controls), RPC also has a built-in "Window editor" to graphically create your own windows, menus, etc. Creating a window filled with controls is as simple as using your mouse to drag and drop your controls into the window, and resizing/positioning them with the mouse. RPC does most of the work of writing a REXX script to create and present your user interface.

RPC also has a built-in image editor to create/edit graphic files you may display in your buttons and other controls.

RPC has many other features, including online help books for the REXX language, all of the Reginald add-on support, and RPC itself (including help for the Window and Image editors). With RPC, you can do all your development from one window, and documentation/help is right there. This makes REXX development easy and quick.

When you download RPC from the above web page, you get a ZIP file. (There's no installer for RPC). Simply unzip the contents of that ZIP file to the same directory where you installed Reginald.

You must also download the REXX GUI add-on DLL. Download and run its installer, which will automatically install REXX GUI in Reginald's directory.

Then to run RPC, just double-click on RexxCenter.exe (or create a shortcut to it on your desktop).

There are many other add-on packages available. For example, there is an add-on package to add features to access the internet from your REXX script, a package to add ODBC (ie, database) support, a package to speak text, MIDI support, etc.

You do not need to install these extra packages if you don't intend to use that extra support.

The documentation for each add-on package is separate from its installer, and there are links on the above web page for all the documentation. When you install the documentation for a package, then those pages can be brought up in RPC's help window.

For example, you'll download the REXX GUI add-on installer, and run that to install REXX GUI. Then you'll also need to download the documentation for REXX GUI. Like RPC, the documentation is packaged in a ZIP file. Simply unzip the contents to the same directory where you installed Reginald.

All the books are displayed, and read, via REXX Programmer Center (RexxCenter.exe). It has a "Books" window built into it, which lists all of the books, and you just click on a topic to have it displayed in a REXX Center window. REXX Center features online help.

REXX Center is a real IDE. You do pretty much everything from REXX Center -- reading documentation, writing your script, designing your windows/menus/controls, debugging your script, and even packaging it into an EXE if desired.

If you're completely new to REXX, then read "The REXX Reference" book from start to finish (well, up to the Function Reference anyway). That's about the REXX language itself, and also details some Reginald-specific extensions to REXX.

If you want to know how REXX Programmer Center itself works, read the book "Programmer Center".

If you want to create programs with your own windows, menus, buttons, sliders, etc, (instead of a plain old DOS window like standard REXX) then you'll next read the "Graphical User Interface" book.
Posted by: Jeff Glatt 2007-06-26 13:27:16
I've decided that it will help me to keep track of topics if you all follow these guidelines:

If your post is a bug report, start your subject line with "BUG: ".

If your post is a feature request, start your subject line with "REQ: ".

If anything else, just make the subject line meaningful.
Forum List • Thread List • Reply • Refresh • New Topic • Search • Previous • Next First 1 Last
© Fri 2024-7-19  Guidance Laboratory Inc. Hits:0