This document describes the examples provided for the C Wrapper for BS2000/OSD. It covers the following topics:
The following C RPC Server example is delivered for BS2000/OSD:
The EXAMPLE server module contains the server-side implementation of
the procedure SQUARE and the function
CALC.
| Element | Type | LMS Library | Comment | Notes |
|---|---|---|---|---|
CREATE-EXAMPLE-SERVER |
J | EXP951.CSRV | S-procedure to generate the C RPC sample server. It uses
RUN-CPLUS-COMPILER.
|
|
RUN-CPLUS-COMPILER |
J | EXP951.CSRV | S-procedure to run the CPLUS compiler.
|
|
EXAMPLE.C |
S | EXP951.CSRV | C RPC sample server program source. | 1 |
DEXAMPLE.C |
S | EXP951.CSRV | C RPC sample server stub source. | 1 |
ERX.H ERXVDATA.H ERXARRAY.H |
S | EXP951.CSRV | RPC runtime header files. | |
ETBCDEF.H |
S | EXP951.CSRV | C language ACI control block definitions. |
When compiling the C server example sources, the compiler may issue warnings. These warnings can be ignored.
To create the server EXAMPLE
Parametrize S-procedure
CREATE-EXAMPLE-SERVER, if needed.
| Procedure Parameter | Description | Default |
|---|---|---|
EXP-SRV-LIB |
C RPC Server examples library | EXP951.CSRV |
For more details, see also the procedure headers in the delivered job control.
Enter the following command:
/CALL-PROCEDURE *LIB(LIB=EXP951.CSRV,ELE=CREATE-EXAMPLE-SERVER)
Enter the following command:
This procedure calls the CPLUS Compiler to generate the
corresponding object modules stored as L-elements in EXP-SRV-LIB (the default
is EXP951.CSRV).
There is no need to link the object modules with the BS2000/OSD Common
Runtime Environment (CRTE) library. The CRTE is loaded once dynamically in the
corresponding worker task of the RPC server where the server program is
executed. The C RPC example server corresponds with the delivered
CALC and SQUARE COBOL clients.
