rexx-things/modules/api/classic/unix/rexxapi1/rexxapi1.c
2025-03-12 20:50:48 +00:00

270 lines
12 KiB
C

/*----------------------------------------------------------------------------*/
/* */
/* Copyright (c) 1995, 2004 IBM Corporation. All rights reserved. */
/* Copyright (c) 2005-2021 Rexx Language Association. All rights reserved. */
/* */
/* This program and the accompanying materials are made available under */
/* the terms of the Common Public License v1.0 which accompanies this */
/* distribution. A copy is also available at the following address: */
/* https://www.oorexx.org/license.html */
/* */
/* Redistribution and use in source and binary forms, with or */
/* without modification, are permitted provided that the following */
/* conditions are met: */
/* */
/* Redistributions of source code must retain the above copyright */
/* notice, this list of conditions and the following disclaimer. */
/* Redistributions in binary form must reproduce the above copyright */
/* notice, this list of conditions and the following disclaimer in */
/* the documentation and/or other materials provided with the distribution. */
/* */
/* Neither the name of Rexx Language Association nor the names */
/* of its contributors may be used to endorse or promote products */
/* derived from this software without specific prior written permission. */
/* */
/* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS */
/* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT */
/* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS */
/* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT */
/* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, */
/* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED */
/* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, */
/* OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY */
/* OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING */
/* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS */
/* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */
/* */
/*----------------------------------------------------------------------------*/
/***************************************************************************/
/* */
/* rexxasp1.c Open Object Rexx samples */
/* */
/* ----------------------------------------------------------------------- */
/* */
/* Description: functions used by Open Object REXX script */
/* */
/***************************************************************************/
#include <string.h>
#include <stdio.h>
#include <stdlib.h>
#include <rexx.h>
/*********************************************************************/
/* Numeric Return calls */
/*********************************************************************/
#define INVALID_ROUTINE 40 /* Raise Rexx error */
#define VALID_ROUTINE 0 /* Successful completion */
#ifdef __cplusplus
extern "C" {
#endif
/*********************************************************************/
/* ApiFncTable */
/* Array of names of the REXXASP1 functions. */
/* This list is used for registration and deregistration. */
/*********************************************************************/
static const char *ApiFncTable[] =
{
"Api_Output_From_C",
"Api_Output_From_REXX",
"Api_Exchange_Data",
"ApiDeregFunc"
};
/*************************************************************************
* Function: ApiLoadFuncs *
* *
* Syntax: call ApiLoadFuncs *
* *
* Params: none *
* *
* Return: null string *
*************************************************************************/
RexxReturnCode REXXENTRY ApiLoadFuncs(
const char *name, /* Function name */
size_t numargs, /* Number of arguments */
CONSTRXSTRING args[], /* Argument array */
const char * queuename, /* Current queue */
PRXSTRING retstr ) /* Return RXSTRING */
{
int entries; /* Num of entries */
int j; /* Counter */
entries = sizeof(ApiFncTable)/sizeof(const char *);
for (j = 0; j < entries; j++)
{
RexxRegisterFunctionDll(ApiFncTable[j], "rexxapi1", ApiFncTable[j]);
}
retstr->strlength = 0; /* return null string */
return VALID_ROUTINE;
}
/*************************************************************************
* Function: ApiDeregFunc *
* *
* Syntax: call ApiDeregFuncs *
* *
* Params: none *
* *
* Return: no return value *
*************************************************************************/
RexxReturnCode REXXENTRY ApiDeregFunc(
const char *name, /* Function name */
size_t numargs, /* Number of arguments */
CONSTRXSTRING args[], /* Argument array */
const char * queuename, /* Current queue */
PRXSTRING retstr ) /* Return RXSTRING */
{
int entries; /* Num of entries */
int j; /* Counter */
retstr->strptr = NULL; /* no return value */
if (numargs > 0)
return INVALID_ROUTINE;
entries = sizeof(ApiFncTable)/sizeof(const char *);
for (j = 0; j < entries; j++)
{
RexxDeregisterFunction(ApiFncTable[j]);
}
return VALID_ROUTINE;
}
/*************************************************************************
* Function: Api_Output_From_C *
* *
* Syntax: call Api_Output_From_C *
* *
* Params: none *
* *
* Return: Version of this Api support DLL *
*************************************************************************/
RexxReturnCode REXXENTRY Api_Output_From_C(
const char *name, /* Function name */
size_t numargs, /* Number of arguments */
CONSTRXSTRING args[], /* Argument array */
const char * queuename, /* Current queue */
PRXSTRING retstr ) /* Return RXSTRING */
{
if (numargs > 0)
{
strcpy(retstr->strptr, "Api_OutPut_From_C does not support any Arguments");
retstr->strlength = strlen(retstr->strptr);
return VALID_ROUTINE;
}
printf("This Output is generated and displayed by the C-function Api_Output_From_C\n");
fflush(NULL);
strcpy(retstr->strptr, "1.0"); /* set return value to be "1.0" */
retstr->strlength = 3;
return VALID_ROUTINE;
}
/*************************************************************************
* Function: Api_Output_From_REXX *
* *
* Syntax: call Api_Output_From_C *
* *
* Params: none *
* *
* Return: String to be output by Rexx *
*************************************************************************/
RexxReturnCode REXXENTRY Api_Output_From_REXX(
const char *name, /* Function name */
size_t numargs, /* Number of arguments */
CONSTRXSTRING args[], /* Argument array */
const char * queuename, /* Current queue */
PRXSTRING retstr ) /* Return RXSTRING */
{
if (numargs > 0)
{
strcpy(retstr->strptr, "Api_Output_From_REXX does not support any Arguments");
retstr->strlength = strlen(retstr->strptr);
return VALID_ROUTINE;
}
strcpy(retstr->strptr, "This Output is generated by the C-function Api_Output_From_REXX and displayed by REXX");
retstr->strlength = strlen(retstr->strptr);
return VALID_ROUTINE;
}
/*************************************************************************
* Function: Api_Exchange_Data *
* *
* Syntax: call Api_Exchange_Data startsect, numsects, outbuf *
* *
* Params: parm1 - numeric value given by REXX *
* parm2 - numeric value given by REXX *
* outbuf - variable given by REXX *
* *
* Return: 0 - success, 1 - failure *
*************************************************************************/
RexxReturnCode REXXENTRY Api_Exchange_Data(
const char *name, /* Function name */
size_t numargs, /* Number of arguments */
CONSTRXSTRING args[], /* Argument array */
const char * queuename, /* Current queue */
PRXSTRING retstr ) /* Return RXSTRING */
{
int parm1 = 0;
int parm2 = 0;
char outbuf[255];
/* we expect 3 arguments */
if (numargs != 3 )
{
printf("Api_Exchange_Data function expects 3 arguments, instead received: %lu\n", numargs);
fflush(NULL);
strcpy(retstr->strptr, "1"); // return failure
retstr->strlength = 1;
return VALID_ROUTINE;
}
/* read the values from the parameters */
parm1 = atoi(args[0].strptr);
parm2 = atoi(args[1].strptr);
strcpy(outbuf, args[2].strptr);
printf("Api_Exchange_Data function has received following arguments:\n\tArgument 1: %d\n\tArgument 2: %d\n\tArgument 3: %s\n",
parm1, parm2, outbuf);
fflush(NULL);
strcpy(retstr->strptr, "0"); // return success
retstr->strlength = 1;
return VALID_ROUTINE;
}
#ifdef __cplusplus
}
#endif