The EDCXSRVI routine creates a
z/OS® XL C environment for the server
part of user-server application. It is intended that this routine
be called by a stub routine supplied by the server and statically
bound with the user application. The stub routine is responsible for
loading the server application code. EDCXSRVI has the following parameters:
- The address of the entry point of the server code. This must be
the address of the EDCXSTRT or EDCXSTRL entry
point.
- The value to be in R1 when the server entry point is called. This
can be used for communication between the initialization stub and
the server mainline; its value can be retrieved in the server code. __xregs(1) will
return a pointer to this list of parameters.
- The address of a low-level get-storage routine (meeting the same
interface as EDCXGET, but not necessarily EDCXGET).
- The address of a low-level free-storage routine (meeting the same
interface as EDCXFREE, but not necessarily EDCXFREE).
When this routine returns, the server environment is fully established
and waiting for a message from the user. R15 points to
a handle that is used in subsequent calls
to EDCXSRVN to send messages to the server.