srv_bind

Description

Describe and bind a program variable for a column or parameter.

Syntax

CS_RETCODE srv_bind(spp, cmd, type, item, osfmtp,

                 varaddrp, varlenp, indp)

SRV_PROC          *spp;
CS_INT                 cmd;
CS_INT                 type;
CS_INT                 item;
CS_DATAFMT      *osfmtp;
CS_BYTE             *varaddrp;
CS_INT                *varlenp;
CS_SMALLINT     *indp;

Parameters

Returns

Examples

Example 1

#include  <ospublic.h>

/*

 ** Local Prototype

 */

CS_RETCODE      ex_srv_bind PROTOTYPE((

SRV_PROC               *spp,

CS_INT                 *nump,

CS_BYTE                *namep,

CS_INT                 *lenp

));

/*

 ** EX_SRV_BIND

**

**     Example routine using srv_bind to describe and bind two

 **     program.

**     variables to receive client RPC parameters. For this

 **     example, the

**     RPC is passed an employee number, and last name. A third

 **     program. 

**     variable will be bound to receive the length of the

 **     employee’s name.

**     This routine is called prior to srv_xferdata, which will

 **     actually transfer the data into the program variables.

**

** Arguments:

**     spp     A pointer to an internal thread control structure.

**     nump    A Pointer to the integer to receive the employee

 **             number.

**     namep   A Pointer to the memory area to receive the

 **             employee name.

**    lenp     A Pointer to the integer to receive the length of

 **             the employee’s name. (On input, points to the

 **             maximum length of the memory area available.)

**

** Returns:

**    CS_SUCCEED    Program variables were successfully bound.

**    CS_FAIL       An error was detected.

 */

CS_RETCODE     ex_srv_bind(spp, nump, namep, lenp)

SRV_PROC        *spp;

CS_INT          *nump;

CS_BYTE         *namep;

CS_INT          *lenp;

{

     CS_INT               param_no;

     CS_DATAFMT           varfmt;

     srv_bzero((CS_VOID *)&varfmt, (CS_INT)sizeof(varfmt));

     /*

     ** First, bind the integer to receive the employee number,

     ** param 1. Here, we know the length of the data, so no

     ** length pointer is required.

     */

     param_no = 1;

     varfmt.datatype = CS_INT_TYPE;

     varfmt.maxlength = (CS_INT)sizeof(CS_INT);

     if (srv_bind(spp, (CS_INT)CS_GET, (CS_INT)SRV_RPCDATA,

          param_no, &varfmt, (CS_BYTE *)nump, (CS_INT *)NULL,

          (CS_SMALLINT *)NULL) != CS_SUCCEED)

     {

          return(CS_FAIL);

     }

     /*

      ** Then, bind the character memory to receive the

      ** employee name, param 2.

      */

     param_no = 2;

     varfmt.datatype = CS_CHAR_TYPE;

     varfmt.maxlength = *lenp;

     if (srv_bind(spp, (CS_INT)CS_GET, (CS_INT)SRV_RPCDATA,

           param_no,

          &varfmt, namep, lenp, (CS_SMALLINT *)NULL) !=

           CS_SUCCEED)

     {

          return(CS_FAIL);

     }

     return(CS_SUCCEED);

}

Usage