Function calls in C

The C subprogram interface of the mail sender frontend supports the following function calls:

Function call	Function	Associated include file with function declaration and data structures
YMLSML()	Send e-mail	YMLSML.H
YMLCML()	Request e-mail send order result	YMLCML.H
YMLDML()	Delete e-mail send order	YMLDML.H
YMLGML()	Query information on e-mail send orders	YMLGML.H

C function calls and include files used

The extension of the subprogram interface with some additional parameters and returncodes described in the section “ASSEMBLER macro interface” affects also the C include files. The selection between the old and the new interface version is done with the definition of a preprocessor symbol before the inclusion of the particular include file.

If one wants to use the VERSION=1 variant of the include files, the following has to be specified:

#define _YMLCML_H_VERSION_1
#include "YMLCML.H"
#define _YMLDML_H_VERSION_1
#include "YMLDML.H"
#define _YMLGML_H_VERSION_1
#include "YMLGML.H"
#define _YMLSML_H_VERSION_1
#include "YMLSML.H"

Correspondingly one gets the VERSION=2 variant of the include files with:

#define _YMLCML_H_VERSION_2
#include "YMLCML.H"
#define _YMLDML_H_VERSION_2
#include "YMLDML.H"
#define _YMLGML_H_VERSION_2
#include "YMLGML.H"
#define _YMLSML_H_VERSION_2
#include "YMLSML.H"

For provisioning of the function header with unit, function and version values corresponding preprocessor symbols are defined in the include files, for instance the symbols YMLSML_UNIT, YMLSML_FUNCTION and YMLSML_VERSION for the YMLSML interface. The latter symbol naturally depends on the selected interface version.

The C include files listed below declare the functions and the data structures used by them.