srv_reginit

Description

Begin executing a registered procedure.

Syntax

CS_RETCODE srv_reginit(spp, procnamep,
                     namelen, options)

SRV_PROC          *spp;
CS_CHAR            *procnamep;
CS_INT                 namelen;
unsigned short      options;

Parameters

Returns

Examples

Example 1

#include    <ospublic.h>

/*

** Local Prototype.

*/

CS_RETCODE     ex_srv_reginit  PROTOTYPE((

SRV_PROC       *sp,

CS_CHAR        *pname,

CS_INT         nlen

));

/*

** EX_SRV_REGINIT

**

**    This routine demonstrates how to use srv_reginit to

**    initiate the execution of a registered procedure.

**

** Arguments:

**         sp       A pointer to an internal thread control 

                    structure.

**         pname    The name of the procedure to execute.

**         nlen     The length of the procedure name.

** Returns

**

**    CS_SUCCEED    If the registered procedure began execution.

**    CS_FAIL       If an error was detected.

**

*/

CS_RETCODE      ex_srv_reginit(sp, pname, nlen)

SRV_PROC        *sp;

CS_CHAR         *pname;

CS_INT          nlen;

{

      /*

      ** Call srv_reginit to initiate the execution of this

      ** registered procedure; ask that all threads waiting for

      ** notification of this event be notified.

      */

      if( srv_reginit(sp, pname, nlen, SRV_M_PNOTIFYALL) ==

            CS_FAIL )

      {

           /*

           ** An error was al&ready raised.

           */

           return CS_FAIL;

      }

      /*

      ** All done.

      */

      return CS_SUCCEED;

}

Usage

• srv_reginit is the first step in the process of executing a registered procedure.

• The procedure’s parameters are defined with srv_regparam after srv_reginit has been called.

• Call srv_regexec to execute the registered procedure.

• If the procedure does not exist, the error is detected and reported by srv_regexec.

• When a registered procedure is executed, Open Server notifies the threads in the procedure’s notification list. The options parameter specifies whether notifications are sent to all threads in the list, or just the one that has been waiting the longest.

• An Open Server application can nest registered procedures up to a maximum of 16 levels.

See also