
In General:

The API samples in the "callrexx" directory demonstrate how to
invoke the REXX interpreter from within an application.

The sample callrexx1.c demonstrates the dynamic linking of the
REXXSTART-command which is only possible from a calling C++ program.

The sample callrexx2 demonstrates the dynamic loading of the
REXXSTART command via dlopen and dlsym functions from a calling
C program (use callrexx2c.mak) as well as from a calling C++
program (use callrexx2cpp.mak).

The big advantage of dynamic loading lies in the ability to use the library 
librexx.so without the need to recompile the calling C or C++ programs.

Especially:

The directory contains

- Makefiles for the C programs
- C-source code which needs to be compiled using the makefiles
- Object REXX interface programs

The examples show:

- How to deliver arguments to a REXX program
- How data can be returned from a REXX program
- How to use the instore feature
- How to use the Macrospace feature


callrexx1
---------
Build: "make -f callrexx1.mak"     
Run:   "callrexx1"

callrexx2
---------
Build: "make -f callrexx2.mak"     
Run:   "callrexx2"
