| 1 |
RexxUtil for Regina (Regutil), version 1.3.0 |
| 2 |
|
| 3 |
RegUtil is now distributed as part of the Regina Rexx interpreter. However |
| 4 |
this does not preclude RegUtil being able to be built for other interpreters |
| 5 |
independently from Regina. Simply follow the notes described in the 1.2.5 |
| 6 |
section below. |
| 7 |
|
| 8 |
RexxUtil for Regina (RegUtil), version 1.2.5 |
| 9 |
(original notes from last stand-alone version of Regutil) |
| 10 |
|
| 11 |
RegUtil is an implementation of IBM's RexxUtil for Regina. RexxUtil is a |
| 12 |
collection of functions which perform certain useful services, such as |
| 13 |
searching directories and files, performing contention management, and so on. |
| 14 |
The documentation is in regutil.pdf, which is part of the distribution. |
| 15 |
|
| 16 |
RegUtil is not finished, but it's getting closer. If there is a function which |
| 17 |
you need, but which returns 'not implemented', do let me know. If you feel |
| 18 |
like implementing some of the unimplemented functions, please let me know. If |
| 19 |
you find a bug, please let me know about that, too. As of version 1.1.0, you |
| 20 |
can test the version number of the library by calling the sysutilversion() |
| 21 |
function. Note that IBM's implementation returns 2 for the current release, |
| 22 |
but regutil returns 1.25 (you can tell them apart this way -- there's no |
| 23 |
version of IBM's library which returns anything less than 2). |
| 24 |
|
| 25 |
This is version 1.2.5. I will increment the third digit each time I do a |
| 26 |
bug-fix release. I will increment the second digit if I ever add a large |
| 27 |
number of new functions, however the goal is to provide compatibility with |
| 28 |
IBM's libraries, so this is unlikely to happen (except when IBM adds a large |
| 29 |
number of new functions ...). |
| 30 |
|
| 31 |
To compile the library using Microsoft C, type nmake -f Makefile.nt. To |
| 32 |
compile the library under FreeBSD systems, type make -f Makefile.bsd. To |
| 33 |
compile the library under another Unix system, you might try using the |
| 34 |
provided make files. Good luck, and let me know how it goes. The make files |
| 35 |
assume the stock vendor compiler -- to use another compiler such as gcc, |
| 36 |
you'll generally need to remove the flags that don't start with -D from the |
| 37 |
PCFLAGS definition and add -fPIC or the position-independent-code flag for |
| 38 |
your compiler. |
| 39 |
|
| 40 |
This code has been built on FreeBSD, NT, Solaris, HP, TRU64 Unix, Linux, |
| 41 |
Dynix, and AIX. |
| 42 |
|
| 43 |
To install on NT, copy rexxutil.dll to a directory in your path (e.g., the |
| 44 |
directory with regina.exe). To install on Unix systems, copy librexxutil.so |
| 45 |
(or whatever it's called on your system :( to some central location and put |
| 46 |
that central location in your LD_LIBRARY_PATH, LIBPATH, SHLIB_PATH, or |
| 47 |
whatever it's called on your system. FreeBSD has a nice utility to set |
| 48 |
standard library searches, which you might want to investigate. |
| 49 |
|
| 50 |
|
| 51 |
-- Patrick TJ McPhee |
| 52 |
[email protected] |