---

RMMonitors.c

Go to the documentation of this file.

/* This file was generated by mib2c and is intended for use as a mib module
   for the ucd-snmp snmpd agent. */

#include <netinet/in.h>


#ifdef IN_UCD_SNMP_SOURCE
/* If we're compiling this file inside the ucd-snmp source tree */


/* This should always be included first before anything else */
#include <config.h>


/* minimal include directives */
#include "mibincl.h"
#include "util_funcs.h"


#else /* !IN_UCD_SNMP_SOURCE */


#include <ucd-snmp/ucd-snmp-config.h>
#include <ucd-snmp/ucd-snmp-includes.h>
#include <ucd-snmp/ucd-snmp-agent-includes.h>


#endif /* !IN_UCD_SNMP_SOURCE */


#include "RMMonitors.h"

#include <string.h>
#include <ucd-snmp/util_funcs.h>
#include "utility.h"
#include "rmClient.h"


/* 
 * RMMonitors_variables_oid:
 *   this is the top level oid that we want to register under.  This
 *   is essentially a prefix, with the suffix appearing in the
 *   variable below.
 */


oid RMMonitors_variables_oid[] = { 1,3,6,1,4,1,343,2,15,1,2,4 };


/* 
 * variable4 RMMonitors_variables:
 *   this variable defines function callbacks and type return information 
 *   for the RMMonitors mib section 
 */


struct variable4 RMMonitors_variables[] = {
/*  magic number        , variable type , ro/rw , callback fn  , L, oidsuffix */
#define   MONITORNEXTINDEX      1
  { MONITORNEXTINDEX    , ASN_UNSIGNED  , RONLY , var_RMMonitors, 1, { 1 } },
#define   MONITORUUID           5
  { MONITORUUID         , ASN_OCTET_STR , RONLY , var_MonitorTable, 3, { 2,1,2 } },
#define   MONITORCONTROLINDEX   6
  { MONITORCONTROLINDEX , ASN_UNSIGNED  , RWRITE, var_MonitorTable, 3, { 2,1,3 } },
#define   MONITORCONFIGINDEX    7
  { MONITORCONFIGINDEX  , ASN_UNSIGNED  , RWRITE, var_MonitorTable, 3, { 2,1,4 } },
#define   MONITORLOCATION       8
  { MONITORLOCATION     , ASN_INTEGER   , RONLY , var_MonitorTable, 3, { 2,1,5 } },
#define   MONITORTYPE           9
  { MONITORTYPE         , ASN_INTEGER   , RONLY , var_MonitorTable, 3, { 2,1,6 } },
#define   MONITORSUBSYSTEMID    10
  { MONITORSUBSYSTEMID  , ASN_UNSIGNED  , RONLY , var_MonitorTable, 3, { 2,1,7 } },
#define   MONITORRESOUCEID      11
  { MONITORRESOUCEID    , ASN_UNSIGNED  , RONLY , var_MonitorTable, 3, { 2,1,8 } },
#define   MONITORSTATISTICID    12
  { MONITORSTATISTICID  , ASN_UNSIGNED  , RONLY , var_MonitorTable, 3, { 2,1,9 } },
#define   MONITORLASTVALUELOW   13
  { MONITORLASTVALUELOW , ASN_UNSIGNED  , RONLY , var_MonitorTable, 3, { 2,1,10 } },
#define   MONITORLASTVALUEHIGH  14
  { MONITORLASTVALUEHIGH, ASN_UNSIGNED  , RONLY , var_MonitorTable, 3, { 2,1,11 } },
#define   MONITORSTARTTIME      15
  { MONITORSTARTTIME    , ASN_OCTET_STR , RONLY , var_MonitorTable, 3, { 2,1,12 } },
#define   MONITORSTOPTIME       16
  { MONITORSTOPTIME     , ASN_OCTET_STR , RONLY , var_MonitorTable, 3, { 2,1,13 } },
#define   MONITORTHRESHOLDLASTEVENTTIME  17
  { MONITORTHRESHOLDLASTEVENTTIME, ASN_OCTET_STR , RONLY , var_MonitorTable, 3, { 2,1,14 } },
#define   MONITORHIGHWATERMARKVALUELOW  18
  { MONITORHIGHWATERMARKVALUELOW, ASN_UNSIGNED  , RONLY , var_MonitorTable, 3, { 2,1,15 } },
#define   MONITORHIGHWATERMARKVALUEHIGH  19
  { MONITORHIGHWATERMARKVALUEHIGH, ASN_UNSIGNED  , RONLY , var_MonitorTable, 3, { 2,1,16 } },
#define   MONITORLOWWATERMARKVALUELOW  20
  { MONITORLOWWATERMARKVALUELOW, ASN_UNSIGNED  , RONLY , var_MonitorTable, 3, { 2,1,17 } },
#define   MONITORLOWWATERMARKVALUEHIGH  21
  { MONITORLOWWATERMARKVALUEHIGH, ASN_UNSIGNED  , RONLY , var_MonitorTable, 3, { 2,1,18 } },
#define   MONITORHIGHWATERMARKTIME  22
  { MONITORHIGHWATERMARKTIME, ASN_OCTET_STR , RONLY , var_MonitorTable, 3, { 2,1,19 } },
#define   MONITORLOWWATERMARKTIME  23
  { MONITORLOWWATERMARKTIME, ASN_OCTET_STR , RONLY , var_MonitorTable, 3, { 2,1,20 } },
#define   MONITORLEAKYBUCKETLASTEVENTTIME  24
  { MONITORLEAKYBUCKETLASTEVENTTIME, ASN_OCTET_STR , RONLY , var_MonitorTable, 3, { 2,1,21 } },
#define   MONITORLEAKYBUCKETVALUELOW  25
  { MONITORLEAKYBUCKETVALUELOW, ASN_UNSIGNED  , RONLY , var_MonitorTable, 3, { 2,1,22 } },
#define   MONITORLEAKYBUCKETVALUEHIGH  26
  { MONITORLEAKYBUCKETVALUEHIGH, ASN_UNSIGNED  , RONLY , var_MonitorTable, 3, { 2,1,23 } },
#define   MONITORNOTIFICATIONSTATUS  27
  { MONITORNOTIFICATIONSTATUS, ASN_INTEGER   , RONLY , var_MonitorTable, 3, { 2,1,24 } },
#define   MONITORSTATUS         28
  { MONITORSTATUS       , ASN_INTEGER   , RONLY , var_MonitorTable, 3, { 2,1,25 } },
#define   MONITORSNMPTRAP       29
  { MONITORSNMPTRAP     , ASN_INTEGER   , RWRITE, var_MonitorTable, 3, { 2,1,26 } },
#define   MONITORCOMMAND        30
  { MONITORCOMMAND      , ASN_INTEGER   , RWRITE, var_MonitorTable, 3, { 2,1,27 } },

};
/*    (L = length of the oidsuffix) */


/*
 * init_RMMonitors():
 *   Initialization routine.  This is called when the agent starts up.
 *   At a minimum, registration of your variables should take place here.
 */
void init_RMMonitors(void) {


  /* register ourselves with the agent to handle our mib tree */
  REGISTER_MIB("RMMonitors", RMMonitors_variables, variable4,
               RMMonitors_variables_oid);


  /* place any other initialization junk you need here */
}


/*
 * var_RMMonitors():
 *   This function is called every time the agent gets a request for
 *   a scalar variable that might be found within your mib section
 *   registered above.  It is up to you to do the right thing and
 *   return the correct value.
 *     You should also correct the value of "var_len" if necessary.
 *
 *   Please see the documentation for more information about writing
 *   module extensions, and check out the examples in the examples
 *   and mibII directories.
 */
unsigned char *
var_RMMonitors(struct variable *vp, 
                oid     *name, 
                size_t  *length, 
                int     exact, 
                size_t  *var_len, 
                WriteMethod **write_method)
{


  /* variables we may use later */
  static u_long ulong_ret;
  /*
  static long long_ret;
  static unsigned char string[SPRINT_MAX_LEN];
  static oid objid[MAX_OID_LEN];
  static struct counter64 c64;
  */


  if (header_generic(vp,name,length,exact,var_len,write_method)
                                  == MATCH_FAILED )
    return NULL;


  /* 
   * this is where we do the value assignments for the mib results.
   */
  switch(vp->magic) {


    case MONITORNEXTINDEX:
        
        ulong_ret = getNewId(MONITOR);
        return (unsigned char *) &ulong_ret;


    default:
      ERROR_MSG("");
  }
  return NULL;
}


/*
 * var_MonitorTable():
 *   Handle this table separately from the scalar value case.
 *   The workings of this are basically the same as for var_RMMonitors above.
 */
unsigned char *
var_MonitorTable(struct variable *vp,
            oid     *name,
            size_t  *length,
            int     exact,
            size_t  *var_len,
            WriteMethod **write_method)
{


  /* variables we may use later */
  static long long_ret;
  static u_long ulong_ret;
  static unsigned char string[SPRINT_MAX_LEN];
  /*
  static oid objid[MAX_OID_LEN];
  static struct counter64 c64;
  */

  static u_int64_t v64;
  unsigned long id;

  id = header_MyGeneric(vp,name,length,exact,var_len,write_method, MONITOR);
  if(id == 0) {
    switch(vp->magic) {

    case MONITORCONTROLINDEX:
        *write_method = write_monitorControlIndex;
        break;

    case MONITORCONFIGINDEX:
        *write_method = write_monitorConfigIndex;
        break;

    case MONITORSNMPTRAP:
        *write_method = write_monitorSNMPTrap;
        break;

    case MONITORCOMMAND:
        *write_method = write_monitorCommand;
        break;

    default:
        ERROR_MSG("");

    }
    return NULL;
  }


  /* 
   * this is where we do the value assignments for the mib results.
   */
  switch(vp->magic) {


    case MONITORUUID:
        
        *string = 0;
        getUUIDString(MONITOR, MONITOR_UUID, id, string);
        *var_len = strlen(string);
        return (unsigned char *) string;

    case MONITORCONTROLINDEX:
        *write_method = write_monitorControlIndex;
        ulong_ret = 0;
        getUnsigned(MONITOR, MONITOR_CONTROLID, id, &ulong_ret);
        return (unsigned char *) &ulong_ret;

    case MONITORCONFIGINDEX:
        *write_method = write_monitorConfigIndex;
        ulong_ret = 0;
        getUnsigned(MONITOR, MONITOR_CONFIGID, id, &ulong_ret);
        return (unsigned char *) &ulong_ret;

    case MONITORLOCATION:
        
        long_ret = 0;
        getInteger32(MONITOR, MONITOR_LOCATION, id, &long_ret);
        return (unsigned char *) &long_ret;

    case MONITORTYPE:
        
        long_ret = 0;
        getInteger32(MONITOR, MONITOR_TYPE, id, &long_ret);
        return (unsigned char *) &long_ret;

    case MONITORSUBSYSTEMID:
        
        ulong_ret = 0;
        getUnsigned(MONITOR, MONITOR_SUBSYSTEMID, id, &ulong_ret);
        return (unsigned char *) &ulong_ret;

    case MONITORRESOUCEID:
        
        ulong_ret = 0;
        getUnsigned(MONITOR, MONITOR_RESORUCEID, id, &ulong_ret);
        return (unsigned char *) &ulong_ret;

    case MONITORSTATISTICID:
        
        ulong_ret = 0;
        getUnsigned(MONITOR, MONITOR_STATISTICID, id, &ulong_ret);
        return (unsigned char *) &ulong_ret;

    case MONITORLASTVALUELOW:
        
        ulong_ret = 0;
        getUnsigned(MONITOR, MONITOR_LASTVALUE32, id, &ulong_ret);
        return (unsigned char *) &ulong_ret;

    case MONITORLASTVALUEHIGH:
        
        v64 = 0;
        getUnsigned64(MONITOR, MONITOR_LASTVALUE64, id, &v64);
        ulong_ret = getHigh32(v64);
        return (unsigned char *) &ulong_ret;

    case MONITORSTARTTIME:
        
        *string = 0;
        ulong_ret = 0;
        getUnsigned(MONITOR, MONITOR_STARTTIME, id, &ulong_ret);
        if(ulong_ret) 
          strncpy(string, ctime((const time_t *) &ulong_ret), SPRINT_MAX_LEN);

        *var_len = strlen(string);
        return (unsigned char *) string;

    case MONITORSTOPTIME:
        
        *string = 0;
        ulong_ret = 0;
        getUnsigned(MONITOR, MONITOR_STOPTIME, id, &ulong_ret);
        if(ulong_ret)
          strncpy(string, ctime((const time_t *) &ulong_ret), SPRINT_MAX_LEN);

        *var_len = strlen(string);
        return (unsigned char *) string;

    case MONITORTHRESHOLDLASTEVENTTIME:
        
        *string = 0;
        ulong_ret = 0;
        getUnsigned(MONITOR, MONITOR_THRESHOLDLASTEVENTTIME, id, &ulong_ret);
        if(ulong_ret)
          strncpy(string, ctime((const time_t *) &ulong_ret), SPRINT_MAX_LEN);

        *var_len = strlen(string);
        return (unsigned char *) string;

    case MONITORHIGHWATERMARKVALUELOW:
        
        ulong_ret = 0;
        getUnsigned(MONITOR, MONITOR_WATERMARKHIGH32, id, &ulong_ret);
        return (unsigned char *) &ulong_ret;

    case MONITORHIGHWATERMARKVALUEHIGH:
        
        v64 = 0;
        getUnsigned64(MONITOR, MONITOR_WATERMARKHIGH64, id, &v64);
        ulong_ret = getHigh32(v64);
        return (unsigned char *) &ulong_ret;

    case MONITORLOWWATERMARKVALUELOW:
        
        ulong_ret = 0;
        getUnsigned(MONITOR, MONITOR_WATERMARKLOW32, id, &ulong_ret);
        return (unsigned char *) &ulong_ret;

    case MONITORLOWWATERMARKVALUEHIGH:
        
        v64 = 0;
        getUnsigned64(MONITOR, MONITOR_WATERMARKLOW64, id, &v64);
        ulong_ret = getHigh32(v64);
        return (unsigned char *) &ulong_ret;

    case MONITORHIGHWATERMARKTIME:
        
        *string = 0;
        ulong_ret = 0;
        getUnsigned(MONITOR, MONITOR_WATERMARKHIGHTIME, id, &ulong_ret);
        if(ulong_ret)
          strncpy(string, ctime((const time_t *) &ulong_ret), SPRINT_MAX_LEN);

        *var_len = strlen(string);
        return (unsigned char *) string;

    case MONITORLOWWATERMARKTIME:
        
        *string = 0;
        ulong_ret = 0;
        getUnsigned(MONITOR, MONITOR_WATERMARKLOWTIME, id, &ulong_ret);
        if(ulong_ret)
          strncpy(string, ctime((const time_t *) &ulong_ret), SPRINT_MAX_LEN);

        *var_len = strlen(string);
        return (unsigned char *) string;

    case MONITORLEAKYBUCKETLASTEVENTTIME:
        
        *string = 0;
        ulong_ret = 0;
        getUnsigned(MONITOR, MONITOR_LEAKYBUCKETLASTEVENTTIME, id, &ulong_ret);
        if(ulong_ret)
          strncpy(string, ctime((const time_t *) &ulong_ret), SPRINT_MAX_LEN);

        *var_len = strlen(string);
        return (unsigned char *) string;

    case MONITORLEAKYBUCKETVALUELOW:
        
        ulong_ret = 0;
        getUnsigned(MONITOR, MONITOR_LEAKYBUCKETLEVEL32, id, &ulong_ret);
        return (unsigned char *) &ulong_ret;

    case MONITORLEAKYBUCKETVALUEHIGH:
        
        v64 = 0;
        getUnsigned64(MONITOR, MONITOR_LEAKYBUCKETLEVEL64, id, &v64);
        ulong_ret = getHigh32(v64);
        return (unsigned char *) &ulong_ret;

    case MONITORNOTIFICATIONSTATUS:
        
        long_ret = 0;
        getInteger32(MONITOR, MONITOR_NOTIFICATIONPAUSED, id, &long_ret);
        return (unsigned char *) &long_ret;

    case MONITORSTATUS:
        
        long_ret = 0;
        getInteger32(MONITOR, MONITOR_STATUS, id, &long_ret);
        return (unsigned char *) &long_ret;

    case MONITORSNMPTRAP:
        *write_method = write_monitorSNMPTrap;
        long_ret = 0;
        getInteger32(MONITOR, MONITOR_SNMPTRAP, id, &long_ret);
        if(long_ret ==0)
          long_ret = 2;
        return (unsigned char *) &long_ret;

    case MONITORCOMMAND:
        *write_method = write_monitorCommand;
        long_ret = 0;
        getInteger32(MONITOR, MONITOR_COMMAND, id, &long_ret);
        return (unsigned char *) &long_ret;


    default:
      ERROR_MSG("");
  }
  return NULL;
}




int
write_monitorControlIndex(int      action,
            u_char   *var_val,
            u_char   var_val_type,
            size_t   var_val_len,
            u_char   *statP,
            oid      *name,
            size_t   name_len)
{
  static unsigned long *ulong_ret;
  int size;

  int createNew, ret;
  unsigned long id;
  size_t prefix_len;

  static unsigned long oldVal;

  oid suffix[] = { 2, 1, 3 };
  createNew = 0;
  prefix_len = sizeof(RMMonitors_variables_oid)/sizeof(oid);

  id = header_writeGeneric(name, name_len, RMMonitors_variables_oid, prefix_len, suffix, 3, MONITOR, &createNew);

  if(id == 0 || (createNew && action == ACTION))
    return SNMP_ERR_NOSUCHNAME;


  switch ( action ) {
        case RESERVE1:
          if (var_val_type != ASN_UNSIGNED){
              fprintf(stderr, "write to monitorControlIndex not ASN_UNSIGNED\n");
              return SNMP_ERR_WRONGTYPE;
          }
          if (var_val_len > sizeof(ulong_ret)){
              fprintf(stderr,"write to monitorControlIndex: bad length\n");
              return SNMP_ERR_WRONGLENGTH;
          }
          break;


        case RESERVE2:
          size = var_val_len;
          ulong_ret = (unsigned long *) var_val;

          if(!createNew) {
            ret = getUnsigned(MONITOR, MONITOR_CONTROLID, id, &oldVal);
            if(ret)
              return SNMP_ERR_INCONSISTENTVALUE;
          }


          break;


        case FREE:
             /* Release any resources that have been allocated */
          break;


        case ACTION:
             /* The variable has been stored in ulong_ret for
             you to use, and you have just been asked to do something with
             it.  Note that anything done here must be reversable in the UNDO case */
          ret = setUnsigned(MONITOR, MONITOR_CONTROLID, id, *ulong_ret);
          if(ret)
            return SNMP_ERR_INCONSISTENTVALUE;

          break;


        case UNDO:
             /* Back out any changes made in the ACTION case */
          setUnsigned(MONITOR, MONITOR_CONTROLID, id, oldVal);
          break;


        case COMMIT:
             /* Things are working well, so it's now safe to make the change
             permanently.  Make sure that anything done here can't fail! */
          break;
  }
  return SNMP_ERR_NOERROR;
}




int
write_monitorConfigIndex(int      action,
            u_char   *var_val,
            u_char   var_val_type,
            size_t   var_val_len,
            u_char   *statP,
            oid      *name,
            size_t   name_len)
{
  static unsigned long *ulong_ret;
  int size;

  int createNew, ret;
  unsigned long id;
  size_t prefix_len;

  static unsigned long oldVal;

  oid suffix[] = { 2, 1, 4 };
  createNew = 0;
  prefix_len = sizeof(RMMonitors_variables_oid)/sizeof(oid);

  id = header_writeGeneric(name, name_len, RMMonitors_variables_oid, prefix_len, suffix, 3, MONITOR, &createNew);

  if(id == 0 || (createNew && action == ACTION))
    return SNMP_ERR_NOSUCHNAME;


  switch ( action ) {
        case RESERVE1:
          if (var_val_type != ASN_UNSIGNED){
              fprintf(stderr, "write to monitorConfigIndex not ASN_UNSIGNED\n");
              return SNMP_ERR_WRONGTYPE;
          }
          if (var_val_len > sizeof(ulong_ret)){
              fprintf(stderr,"write to monitorConfigIndex: bad length\n");
              return SNMP_ERR_WRONGLENGTH;
          }
          break;


        case RESERVE2:
          size = var_val_len;
          ulong_ret = (unsigned long *) var_val;

          if(!createNew) {
            ret = getUnsigned(MONITOR, MONITOR_CONFIGID, id, &oldVal);
            if(ret)
              return SNMP_ERR_INCONSISTENTVALUE;
          }


          break;


        case FREE:
             /* Release any resources that have been allocated */
          break;


        case ACTION:
             /* The variable has been stored in ulong_ret for
             you to use, and you have just been asked to do something with
             it.  Note that anything done here must be reversable in the UNDO case */
          ret = setUnsigned(MONITOR, MONITOR_CONFIGID, id, *ulong_ret);
          if(ret)
            return SNMP_ERR_INCONSISTENTVALUE;

          break;


        case UNDO:
             /* Back out any changes made in the ACTION case */
          setUnsigned(MONITOR, MONITOR_CONFIGID, id, oldVal);
          break;


        case COMMIT:
             /* Things are working well, so it's now safe to make the change
             permanently.  Make sure that anything done here can't fail! */
          break;
  }
  return SNMP_ERR_NOERROR;
}




int
write_monitorSNMPTrap(int      action,
            u_char   *var_val,
            u_char   var_val_type,
            size_t   var_val_len,
            u_char   *statP,
            oid      *name,
            size_t   name_len)
{
  static long *long_ret;
  int size;

  int createNew, ret;
  unsigned long id;
  size_t prefix_len;

  static long oldVal;

  oid suffix[] = { 2, 1, 26 };
  createNew = 0;
  prefix_len = sizeof(RMMonitors_variables_oid)/sizeof(oid);

  id = header_writeGeneric(name, name_len, RMMonitors_variables_oid, prefix_len, suffix, 3, MONITOR, &createNew);

  if(id == 0 || (createNew && action == ACTION))
    return SNMP_ERR_NOSUCHNAME;


  switch ( action ) {
        case RESERVE1:
          if (var_val_type != ASN_INTEGER){
              fprintf(stderr, "write to monitorSNMPTrap not ASN_INTEGER\n");
              return SNMP_ERR_WRONGTYPE;
          }
          if (var_val_len > sizeof(long_ret)){
              fprintf(stderr,"write to monitorSNMPTrap: bad length\n");
              return SNMP_ERR_WRONGLENGTH;
          }
          break;


        case RESERVE2:
          size = var_val_len;
          long_ret = (long *) var_val;

          if(!createNew) {
            ret = getInteger32(MONITOR, MONITOR_SNMPTRAP, id, &oldVal);
            if(ret)
              return SNMP_ERR_INCONSISTENTVALUE;
          }


          break;


        case FREE:
             /* Release any resources that have been allocated */
          break;


        case ACTION:
             /* The variable has been stored in long_ret for
             you to use, and you have just been asked to do something with
             it.  Note that anything done here must be reversable in the UNDO case */
          ret = setInteger32(MONITOR, MONITOR_SNMPTRAP, id, *long_ret);
          if(ret)
            return SNMP_ERR_INCONSISTENTVALUE;

          break;


        case UNDO:
             /* Back out any changes made in the ACTION case */
          setInteger32(MONITOR, MONITOR_SNMPTRAP, id, oldVal);

          break;


        case COMMIT:
             /* Things are working well, so it's now safe to make the change
             permanently.  Make sure that anything done here can't fail! */
          break;
  }
  return SNMP_ERR_NOERROR;
}




int
write_monitorCommand(int      action,
            u_char   *var_val,
            u_char   var_val_type,
            size_t   var_val_len,
            u_char   *statP,
            oid      *name,
            size_t   name_len)
{
  static long *long_ret;
  int size;

  int createNew, ret;
  unsigned long id;
  size_t prefix_len;

  static int rowCreated;

  oid suffix[] = { 2, 1, 27 };
  createNew = 0;
  prefix_len = sizeof(RMMonitors_variables_oid)/sizeof(oid);

  id = header_writeGeneric(name, name_len, RMMonitors_variables_oid, prefix_len, suffix, 3, MONITOR, &createNew);

  if(action == COMMIT && *long_ret == DELETE_MONITOR && id ==0)
    return SNMP_ERR_NOERROR;

  if(id == 0)
    return SNMP_ERR_NOSUCHNAME;


  switch ( action ) {
        case RESERVE1:
          if (var_val_type != ASN_INTEGER){
              fprintf(stderr, "write to monitorCommand not ASN_INTEGER\n");
              return SNMP_ERR_WRONGTYPE;
          }
          if (var_val_len > sizeof(long_ret)){
              fprintf(stderr,"write to monitorCommand: bad length\n");
              return SNMP_ERR_WRONGLENGTH;
          }
          break;


        case RESERVE2:
          size = var_val_len;
          long_ret = (long *) var_val;

          rowCreated = 0;
          if (*long_ret < NEW_MONITORENTRY || *long_ret > RESET_NOTIFICATION) 
            return SNMP_ERR_INCONSISTENTVALUE;

          if(createNew &&
              (*long_ret != NEW_MONITORENTRY && *long_ret != CREATE_MONITOR))
            return SNMP_ERR_INCONSISTENTVALUE;


          break;


        case FREE:
             /* Release any resources that have been allocated */
          break;


        case ACTION:
             /* The variable has been stored in long_ret for
             you to use, and you have just been asked to do something with
             it.  Note that anything done here must be reversable in the UNDO case */
          if(*long_ret == NEW_MONITORENTRY || *long_ret == CREATE_MONITOR) {

            if(createNew) {
              ret =  newEntry(MONITOR, id);
              if(ret)
                return SNMP_ERR_INCONSISTENTVALUE;

              rowCreated = 1;
            }
          }
          else {
            ret = setInteger32(MONITOR, MONITOR_COMMAND, id, *long_ret);
            if(ret)
              return SNMP_ERR_INCONSISTENTVALUE;
          }
          break;


        case UNDO:
             /* Back out any changes made in the ACTION case */
          if(rowCreated) {
            deleteEntry(MONITOR, id);
          }
          else {

            // note: don't know how to back up commands either. 
            
          }
          break;


        case COMMIT:
             /* Things are working well, so it's now safe to make the change
             permanently.  Make sure that anything done here can't fail! */
          if(*long_ret == CREATE_MONITOR) {
            ret = setInteger32(MONITOR, MONITOR_COMMAND, id, CREATE_MONITOR);
            if(ret)
              return SNMP_ERR_COMMITFAILED;
          }

          break;
  }
  return SNMP_ERR_NOERROR;
}

---