Establishing a server environment
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.