dc_rpc_mainloop - Start an SPP service

ANSI C, C++

#include <dcrpc.h>
int  dc_rpc_mainloop (DCLONG flags)

K&R C

#include <dcrpc.h>
int  dc_rpc_mainloop(flags)
DCLONG     flags;

The function dc_rpc_mainloop() starts the receiving of service requests to a service function of the SPP which is being executed in the process. The function dc_rpc_mainloop() must be called in the main function. Call the function dc_rpc_mainloop() only once in the process.

The function dc_rpc_mainloop() does not return until it receives a termination request from OpenTP1. The function dc_rpc_mainloop() receives a termination request from OpenTP1 in the following cases:

Termination processing starts because one of the following OpenTP1 stop commands has been accepted:
dcstop command (normal termination)
dcstop -n command (forced normal termination)
dcstop -a command (planned termination A)
dcstop -b command (planned termination B)
The following server stop command is entered to start termination processing for the processes of the SPP that called the function dc_rpc_mainloop():
dcsvstop command (normal termination)
OpenTP1 terminates the processes of the SPP that called the function dc_rpc_mainloop() because the number of processes exceeds the maximum number specified in the user service definition.
Service processing terminates if the SPP is executing under a nonresident process.
If loads on SPPs are distributed in a multiserver configuration, service requests addressed to the present service group are reduced.

Return value	Return value (numeric)	Explanation
DC_OK	0	A termination request was received from OpenTP1. Execute termination processing for the SPP immediately, then call the function dc_rpc_close() and exit().
DCRPCER_INVALID_ARGS	-301	The value specified for the argument is invalid.
DCRPCER_PROTO	-302	The function dc_rpc_open() was not called.
DCRPCER_PROTO	-302	The function dc_rpc_mainloop() or the function dc_mcf_mainloop() was called.
DCRPCER_FATAL	-303	The SPP service could not be started.

The function dc_rpc_mainloop() returns when it receives a termination request from OpenTP1. However, the function dc_rpc_mainloop() does not return but the process terminates in the following cases:

The SPP enters a termination process because the OpenTP1 forced termination command (dcstop -f command) or server forced termination command (dcsvstop -f command) is executed.
A process terminates abnormally because the UAP or OpenTP1 malfunctions.
The service function issues abort() or exit().
Hardware, the operating system, or OpenTP1 causes an error.

Even if the SPP is created in such a way that termination processing will be executed after the function dc_rpc_mainloop() terminates normally, the processing is not executed in the above cases.