Description


Include file: xrexx.h

Functions

XRexxInterface

Parameters

char * name the symbolic name of the interface
char * dllName the name of the DLL
char * proc the name of your function

char * name the symbolic name of the interface
PFN proc the adress of your function

Remarks

Creates an interface to REXX. Therefore a C-function of you application (DLL) will be registered. The function must have following format:

REXXINTERFACE Handler(PRXSTRING commandString, PUSHORT flags, PRXSTRING returnString)

Commands which are not known in a rexx-script running in this interface will be posted to the handler.
Creates an interface to REXX. Therefore a C-function of your application (EXE) will be registered. The function must have following format:

REXXINTERFACE Handler(PRXSTRING commandString, PUSHORT flags, PRXSTRING returnString)

Commands which are not known in a rexx-script running in this interface will be posted to the handler.

Exceptions

If the method fails an exception of the type XRexxException is thrown.
If the method fails an exception of the type XRexxException is thrown.

Execute

Parameters

char * commandFile name of a file which contains the script
LONG type type of command (see rexx program reference)
XString * result buffer for result
SHORT returnCode buffer for returncode
XString * args string which contains the arguments for the script

Return-Value

LONG result return-code from the operating system

Remarks

Run a REXX-script

GetHandler

Parameters

char * handlerName the name of the rexx interface used in the constructor
char * dllName name of the DLL if used (default is NULL)

Return-Value

XRexxInterface * pointer pointer to an interface (NULL if no interface found)

Remarks

Returns a pointer to a XRexxInterface

DeregisterFunction

Parameters

char * name symbolic name of the function

Return-Value

LONG result return-code from the operating system

Remarks

Deregister a function

IsFunctionRegistered

Parameters

char * name symbolic name of the function

Return-Value

BOOL result

Remarks

Query if a function is registered

RegisterFunction

Parameters

char * name symbolic name of the function which must be used in the rexx-script
char * dllName name of the dll
char * proc real name of the function

char * name symbolic name of the function which must be used in the rexx-script
PFN proc adress of the function

Return-Value

LONG result return-code from the operating system
LONG result return-code from the operating system

Remarks

Register a C-function of your application (DLL) so that it can be called from a rexx-script. The function must have the following format:

REXXINTERFACE MyFunc( PUCHAR name, ULONG argc, PRXSTRING argv, PSZ queue, PRXSTRING ret)
Register a C-function of your application (EXE) so that it can be called from a rexx-script. The function must have the following format:

REXXINTERFACE MyFunc( PUCHAR name, ULONG argc, PRXSTRING argv, PSZ queue, PRXSTRING ret)

GetVar

Parameters

char * name name of the variable
XString * value buffer for the value of the variable

Return-Value

LONG result return-code from the operating system

Remarks

Query a variable for a running rexx-script

SetVar

Parameters

char * name name of the variable
char * value value of the variable

Return-Value

LONG result return-code from the operating system

Remarks

Set a variable for a running rexx-script


This document was generated by Jens von Pilgrim's Autodoc